STOMP.js

STOMP.js is a fully-fledged STOMP over WebSocket library for browsers and Node.js, providing seamless integration with STOMP protocol-compliant messaging brokers.

Table of Contents

• Introduction
• Features
• Getting Started
  • Browser
  • Node.js
• Documentation
• Upgrading
• Usage with RxJS
• TypeScript Support
• Changelog
• Contributing
• Authors
• License

Introduction

This library enables clients to connect to STOMP brokers over WebSocket (or TCP). It fully implements the STOMP protocol specifications (v1.0, v1.1, and v1.2), making it compatible with any broker that supports STOMP or STOMP over WebSocket.

Popular brokers like RabbitMQ, ActiveMQ, and others provide support for STOMP and STOMP over WebSockets out-of-the-box.

Features

• Simple and intuitive API for interacting with the STOMP protocol
• Support for STOMP protocol versions: 1.2, 1.1, and 1.0
• Support for fallback options when WebSocket is unavailable
• Supports both browser and Node.js environments
• Option to connect using STOMP over TCP
• Full support for binary payloads
• Compatible with RxJS for reactive programming

Getting Started

This section provides a quick guide to integrating STOMP.js into your browser or Node.js application.

Browser

To use STOMP.js in a browser:

1. Add the following in your HTML file:

   <script type="importmap">
     {
       "imports": {
         "@stomp/stompjs": "https://ga.jspm.io/npm:@stomp/stompjs@7.0.0/esm6/index.js"
       }
     }
   </script>
   <script
     async
     src="https://ga.jspm.io/npm:es-module-shims@1.5.1/dist/es-module-shims.js"
     crossorigin="anonymous"
   ></script>
   

2. Use the library:

   import { Client } from '@stomp/stompjs';
   
   const client = new Client({
     brokerURL: 'ws://localhost:15674/ws',
     onConnect: () => {
       client.subscribe('/topic/test01', message =>
         console.log(`Received: ${message.body}`)
       );
       client.publish({ destination: '/topic/test01', body: 'First Message' });
     },
   });
   
   client.activate();
   

Node.js

To use STOMP.js in a Node.js environment:

1. Install the package:

   npm install @stomp/stompjs ws
   

2. Use it in your application:

   import { Client } from '@stomp/stompjs';
   
   import { WebSocket } from 'ws';
   Object.assign(global, { WebSocket });
   
   const client = new Client({
     brokerURL: 'ws://localhost:15674/ws',
     onConnect: () => {
       client.subscribe('/topic/test01', message =>
         console.log(`Received: ${message.body}`)
       );
       client.publish({ destination: '/topic/test01', body: 'First Message' });
     },
   });
   
   client.activate();
   

Documentation

Comprehensive documentation can be found at: STOMP.js Documentation

• API Overview: API Docs (latest)
• Usage Guide: Guide to Using STOMP.js
• Feature Guides: Explore additional guides at https://stomp-js.github.io/

Upgrading

If you are updating from an older version of STOMP.js, review the Upgrading Guide for any required changes.

Usage with RxJS

Rx-Stomp builds upon this library, exposing all its features as RxJS Observables, enabling reactive programming patterns.

TypeScript Support

STOMP.js includes built-in TypeScript definitions, eliminating the need for external type definition files. Begin coding with TypeScript out-of-the-box!

Changelog

Visit the Change Log for information about changes, improvements, and fixes in recent releases.

Contributing

Thinking of contributing to STOMP.js? Great! To get started:

• Read the Contributing Guide for development instructions.
• Report bugs or suggest features by creating an issue on GitHub.

We welcome contributions from the community!

Authors

This library is made possible by these amazing contributors:

• Deepak Kumar
• Astha Deep
• Dillon Sellars
• Jimi Charalampidis
• Raul
• Dimitar Georgiev
• Genadi
• Bobohuochai
• Sailai
• Harsh Deep
• Nikos Epping
• Tom Pachtner
• David Nussio
• Camille Drapier
• chai min
• umsungjun
• tomek3e
• Samuel Yinger

This library is originally based on stompjs by Jeff Mesnil with enhancements and bug fixes from Jeff Lindsay and Vanessa Williams.

License

Licensed under the Apache-2.0 License. See the LICENSE file for details.