Skip to content
Modern XMPP in the browser, with a JSON API
Branch: master
Clone or download
Latest commit 45f183a May 15, 2019


Modern XMPP in the browser, with a JSON API.

What is this?

Stanza is a library for using modern XMPP in the browser, and it does that by exposing everything as JSON. Unless you insist, you have no need to ever see or touch any XML when using Stanza.


$ npm install stanza

Getting Started

  1. Find or install a server which supports XMPP over WebSocket (Prosody recommended).
  2. Clone this repo with git clone
  3. Run npm install in the new directory.
  4. Run npm run build to create dist/stanza.browser.js.
  5. Open demo.html in your browser.
  6. Enter your connection info, click connect.
  7. Use the JS console to play with the XMPP client (var client).

Echo Client Demo

var XMPP = require('stanza');

var client = XMPP.createClient({
    jid: '',
    password: 'hunter2',

    // If you have a .well-known/host-meta.json file for your
    // domain, the connection transport config can be skipped.

    transport: 'websocket',
    wsURL: 'wss://'
    // (or `boshURL` if using 'bosh' as the transport)

client.on('session:started', function() {

client.on('chat', function(msg) {
        to: msg.from,
        body: 'You sent: ' + msg.body




MUC Room: / Logs



Created By

If you like this, follow @lancestout on twitter.

You can’t perform that action at this time.