> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/jitsi/lib-jitsi-meet/llms.txt
> Use this file to discover all available pages before exploring further.
# JitsiConnection
> XMPP connection management for Jitsi Meet
`JitsiConnection` represents a connection to the Jitsi Meet XMPP server. It handles authentication, connection management, and provides access to conferences.
## Constructor
### new JitsiConnection()
Creates a new connection instance.
```javascript theme={null}
const connection = new JitsiMeetJS.JitsiConnection(appId, token, options);
```
Application identifier for the Jitsi Meet service. For JaaS deployments, use your `vpaas-magic-cookie-*` app ID.
JWT token for authentication. Can be `null` for guest access.
Connection configuration options
WebSocket URL for XMPP connection (e.g., `wss://8x8.vc/xmpp-websocket`)
XMPP domain (e.g., `8x8.vc`)
Multi-user chat domain (e.g., `conference.8x8.vc`)
Domain for anonymous users
Jicofo component address
Enable WebSocket stream resumption (XEP-0198)
WebSocket keep-alive interval in milliseconds
URL to use for keep-alive HTTP requests
XMPP ping configuration
Ping interval in milliseconds
Ping timeout in milliseconds
Failed ping threshold before disconnecting
STUN servers for P2P connections
Bridge channel configuration
Prefer SCTP data channel over WebSocket
Domain to ignore for WebSocket bridge channel
Disable Jicofo (focus) component
Feature flags
Analytics configuration
## Connection Management
### connect()
Connects to the XMPP server.
```javascript theme={null}
connection.connect(options);
```
Connection options
Username for authenticated connection
Password for authenticated connection
Room name (required for sending conference-request over HTTP)
**Example:**
```javascript theme={null}
connection.addEventListener(
JitsiMeetJS.events.connection.CONNECTION_ESTABLISHED,
() => {
console.log('Connected!');
}
);
connection.addEventListener(
JitsiMeetJS.events.connection.CONNECTION_FAILED,
(error) => {
console.error('Connection failed:', error);
}
);
connection.connect({ name: 'myroom' });
```
### attach()
Attaches to an existing XMPP connection (for connection reuse).
```javascript theme={null}
connection.attach(options);
```
Full JID of the existing connection
Session ID of the existing connection
Request ID of the existing connection
### disconnect()
Disconnects from the XMPP server.
```javascript theme={null}
await connection.disconnect();
```
Promise that resolves when disconnection is complete, or boolean for synchronous result
### refreshToken()
Renews the JWT token if it's expiring.
```javascript theme={null}
await connection.refreshToken(newToken);
```
The new JWT token
Promise that resolves when token is refreshed
## Conference Management
### initJitsiConference()
Creates and initializes a new conference.
```javascript theme={null}
const conference = connection.initJitsiConference(roomName, options);
```
Conference room name (must be lowercase)
Conference configuration options. See [JitsiConference](/api/jitsi-conference) for details.
A new JitsiConference instance
**Example:**
```javascript theme={null}
const conference = connection.initJitsiConference('myroom', {
openBridgeChannel: true,
p2p: {
enabled: true
}
});
conference.join();
```
## Event Management
### addEventListener()
Subscribes to connection events.
```javascript theme={null}
connection.addEventListener(event, listener);
```
Event name from `JitsiMeetJS.events.connection`
Event handler function
**Connection Events:**
* `CONNECTION_ESTABLISHED` - Connection successfully established
* `CONNECTION_FAILED` - Connection failed `(error: string, msg: string, credentials: object, details: object)`
* `CONNECTION_DISCONNECTED` - Connection was disconnected `(msg: string)`
* `WRONG_STATE` - Connection is in wrong state for the operation
**Example:**
```javascript theme={null}
connection.addEventListener(
JitsiMeetJS.events.connection.CONNECTION_ESTABLISHED,
() => {
console.log('Connected successfully');
const conference = connection.initJitsiConference('room1', {});
conference.join();
}
);
connection.addEventListener(
JitsiMeetJS.events.connection.CONNECTION_FAILED,
(error, msg, credentials, details) => {
console.error('Connection failed:', error, msg);
}
);
```
### removeEventListener()
Unsubscribes from connection events.
```javascript theme={null}
connection.removeEventListener(event, listener);
```
Event name to unsubscribe from
The event handler to remove
## Information Methods
### getJid()
Returns the JID of the participant associated with the connection.
```javascript theme={null}
const jid = connection.getJid();
```
Full JID of the connected participant (e.g., `user@domain/resource`)
### getConnectionTimes()
Returns connection timing information for diagnostics.
```javascript theme={null}
const times = connection.getConnectionTimes();
```
Object containing connection timing metrics:
* `connecting` - When connection started
* `connected` - When connection was established
* Various XMPP-specific timings
### getLogs()
Retrieves internal connection logs for debugging.
```javascript theme={null}
const logs = connection.getLogs();
```
Object containing:
* `metadata` - Connection metadata (time, URL, user agent)
* `xmpp` - XMPP protocol logs
* Jingle session logs
## Feature Management
### addFeature()
Adds a feature to the local participant's capabilities.
```javascript theme={null}
connection.addFeature(feature, submit);
```
Feature URN to add (e.g., `urn:xmpp:jingle:apps:dtls:0`)
If `true`, immediately broadcast the updated feature list
### removeFeature()
Removes a feature from the local participant's capabilities.
```javascript theme={null}
connection.removeFeature(feature, submit);
```
Feature URN to remove
If `true`, immediately broadcast the updated feature list
## Properties
### options
The connection configuration options (read-only).
```javascript theme={null}
const domain = connection.options.hosts.domain;
```
### xmpp
Internal XMPP connection instance (internal use only).
This property is for internal library use. Direct manipulation may break functionality.