***

id: 127a92fa-f4ef-452b-aaec-c1e321bf6f05
title: PubSub.Client
sidebar-title: Client
slug: /js/reference/pubsub/client
max-toc-depth: 3
----------------

You can use the Client object to build a messaging system into the browser.

Example usage:

```js
import { PubSub } from "@signalwire/js";

const pubSubClient = new PubSub.Client({
  token: "<your chat token>", // get this from the REST APIs
});

await pubSubClient.subscribe(["mychannel1", "mychannel2"]);

pubSubClient.on("message", (message) => {
  // prettier-ignore
  console.log("Received", message.content,
              "on", message.channel,
              "at", message.publishedAt);
});

await pubSubClient.publish({
  channel: "mychannel1",
  content: "hello world",
});
```

## Constructor

Creates a new PubSub client.

```js
import { PubSub } from "@signalwire/js";

const pubSubClient = new PubSub.Client({
  token: "<your chat token>"
});
```

### Parameters

<Indent>
  <ParamField path="token" type="string" required={true}>
    SignalWire Chat token that can be obtained from the [REST APIs](/docs/apis/chat/tokens/create-chat-token).
  </ParamField>
</Indent>

## Methods

<CardGroup cols={3}>
  <Card title="disconnect" href="/docs/browser-sdk/v3/js/reference/pubsub/client/disconnect">
    Disconnect the client
  </Card>

  <Card title="getAllowedChannels" href="/docs/browser-sdk/v3/js/reference/pubsub/client/get-allowed-channels">
    Get channels allowed by the token
  </Card>

  <Card title="publish" href="/docs/browser-sdk/v3/js/reference/pubsub/client/publish">
    Publish a message to a channel
  </Card>

  <Card title="subscribe" href="/docs/browser-sdk/v3/js/reference/pubsub/client/subscribe">
    Subscribe to channels
  </Card>

  <Card title="unsubscribe" href="/docs/browser-sdk/v3/js/reference/pubsub/client/unsubscribe">
    Unsubscribe from channels
  </Card>

  <Card title="updateToken" href="/docs/browser-sdk/v3/js/reference/pubsub/client/update-token">
    Replace the client token
  </Card>

  <Card title="on" href="/docs/browser-sdk/v3/js/reference/pubsub/client/on">
    Subscribe to an event
  </Card>

  <Card title="once" href="/docs/browser-sdk/v3/js/reference/pubsub/client/once">
    Subscribe to an event once
  </Card>

  <Card title="off" href="/docs/browser-sdk/v3/js/reference/pubsub/client/off">
    Unsubscribe from an event
  </Card>

  <Card title="removeAllListeners" href="/docs/browser-sdk/v3/js/reference/pubsub/client/remove-all-listeners">
    Remove all event listeners
  </Card>
</CardGroup>

## Events

<CardGroup>
  <Card title="Events" href="/docs/browser-sdk/v3/js/reference/pubsub/client/events" icon="fa-solid fa-bell">
    Events emitted by the PubSub.Client class.
  </Card>
</CardGroup>