Online status

Subscribe to users’ presence status by registering a listener. Presence events are emitted whenever a member enters or leaves the presence set, or updates their user data. Use the presence.subscribe() method in a room to receive updates:

You can also subscribe to only specific presence events, or an array of presence events:

JavaScript
Select...

// Subscribe to only 'enter' events:
const { unsubscribe } = room.presence.subscribe('enter', (event) => {
  console.log(`${event.clientId} entered with data: ${event.data}`);
});


// Subscribe to 'update' and 'leave' events:
const { unsubscribe } = room.presence.subscribe(['update', 'leave'], (event) => {
  console.log(`${event.clientId} entered with data: ${event.data}`);
});

Copy
Copied!

Unsubscribe from online presence to remove previously registered listeners.

Use the unsubscribe() function returned in the subscribe() response to remove a listener:

JavaScript
Select...

// Initial subscription
const { unsubscribe } = room.presence.subscribe((event) => {
  console.log(`${event.clientId} entered with data: ${event.data}`);
});


// To remove the listener
unsubscribe();

Copy
Copied!

Use the presence.unsubscribeAll() method to remove all presence listeners in a room:

JavaScript
Select...

await room.presence.unsubscribeAll();

Copy
Copied!

Use the presence.enter() method to indicate when a user joins a room. This will send a presence event to all users subscribed to presence indicating that a new member has joined the chat. You can also set an optional data field with information such as the status of a user:

Use the presence.update() method when a user wants to update their data, such as an update to their status, or to indicate that they’re raising their hand. Updates will send a presence event ao all users subscribed to presence:

Use the presence.leave() method to explicitly remove a user from the presence set. This will send a presence event to all users subscribed to presence. You can also set an optional data field such as setting a status of ‘Back later’.

The online presence of users can be retrieved in one-off calls. This can be used to check the status of an individual user, or return the entire presence set as an array.

Use the presence.get() method to retrieve an array of all users currently entered into the presence set, or individual users:

JavaScript
Select...

// Retrieve all users entered into presence as an array:
const presentMembers = await room.presence.get();


// Retrieve the status of specific users by their clientId:
const presentMember = await room.presence.get({ clientId: 'clemons123' });

Copy
Copied!

Alternatively, use the presence.isUserPresent() method and pass in a user’s clientId to check whether they are online or not. This will return a boolean:

JavaScript
Select...

const isPresent = await room.presence.isUserPresent('clemons123');

Copy
Copied!