JavaScript SDK 13.1.3

Real-time messaging, presence, and storage in browsers, Node.js, React, and React Native.

Start the Web quickstart

WebNode.jsReactReact Native

npm install pubnub

What do you want to do?

Send and receive messages

• Receive messagesCreate a subscription and handle incoming events.
• Send different message typesPublish messages and signals with custom types.
• Stop receiving messagesUnsubscribe and remove listeners.

Show who is online

• Get online users in a channelList who is present and count occupants.
• Receive presence eventsListen for join, leave, and timeout events.
• Set and get presence stateAttach custom state to a user and read it back.
• Get subscribed channels for a userList the channels a user is subscribed to.

Load message history

• Retrieve message historyFetch stored messages and count unread ones.
• Delete messages from historyRemove stored messages by time range.

Secure access with tokens

• Configure access controlEnable Access Manager on your keyset.
• Initialize a server SDK with a secret keySet up the server that issues tokens.
• Initialize a client SDK with an auth keyGive a client its token at startup.
• Grant, change, and revoke permissionsIssue, update, and revoke tokens.
• Update an expired tokenRecover a client after a 403 error.

Handle disconnects and errors

• Receive messages effectivelyReconnect and catch up on missed messages.
• Troubleshoot PubNub request failuresDiagnose failures and gather logs for Support.

Upload and share files

• Send a file to a channelUpload a file with an optional caption.
• Receive and download filesHandle file events and download content.
• List and manage stored filesList, page through, and delete files.

API reference

• Publish

  Send messages and signals.

• Subscribe

  Listen for messages and events.

• Configuration

  Initialize the client and set options.

• Access Manager

  Tokens and permissions.

• Presence

  Online status, occupancy, and state.

• Message Persistence

  Fetch, count, and delete history.

• DataSync

  Entities, queries, and events.

• File Sharing

  Upload, download, and list files.

• Channel Groups

  Subscribe to many channels at once.

• Message Actions

  Reactions and receipts.

• Mobile Push

  Push notifications for mobile apps.

• Encryption

  Encrypt files and part of a message.

• Miscellaneous

  Utility methods.

Work with the SDK

• Set up your environment

  Install the SDK and set up TypeScript.

• Choose your runtime

  Web, Node.js, React, or React Native.

• Status events

  Connection and error categories.

• Logging

  Turn on and read SDK logs.

• Platform support

  Supported browsers and runtimes.

• Feature support

  What each SDK version supports.

• Changelog

  Release notes for every version.

• FAQ

  Common questions about the SDK.

Related

• Using a coding agent?

  Install the PubNub skills or connect the MCP server.

• Migrate

  Upgrade guides for v8, v11, and v12.