Skip to content
Stomp client for Web browsers and node.js apps
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
browsertests Add support for receiving fragmented STOMP frames. These can orginate… Jul 23, 2014
doc Add support for node.js Sep 25, 2013
example Doc: fixing typo in README.md of example Dec 2, 2014
lib Add support for receiving fragmented STOMP frames. These can orginate… Jul 23, 2014
src Add support for receiving fragmented STOMP frames. These can orginate… Jul 23, 2014
test Add support for receiving fragmented STOMP frames. These can orginate… Jul 23, 2014
.gitignore refactor client.connect() arguments Aug 8, 2013
.travis.yml
Cakefile
LICENSE.txt add APL2 and README files Jan 22, 2010
README.md flag the project as no longer maintained Sep 11, 2015
RELEASE_NOTES.md
bower.json
coffeelint.json
index.js
package.json prepare version after 2.3.4 Nov 17, 2014

README.md

STOMP.js

This library provides a STOMP client for Web browser (using Web Sockets) or node.js applications (either using raw TCP sockets or Web Sockets).

Project Status

This project is no longer maintained (some context about this decision).

If you encounter bugs with it or need enhancements, you can fork it and modify it as the project is under the Apache License 2.0.

Web Browser support

The library file is located in lib/stomp.js (a minified version is available in lib/stomp.min.js). It does not require any dependency (except WebSocket support from the browser or an alternative to WebSocket!)

Online documentation describes the library API (including the annotated source code).

node.js support

Install the 'stompjs' module

$ npm install stompjs

In the node.js app, require the module with:

var Stomp = require('stompjs');

To connect to a STOMP broker over a TCP socket, use the Stomp.overTCP(host, port) method:

var client = Stomp.overTCP('localhost', 61613);

To connect to a STOMP broker over a WebSocket, use instead the Stomp.overWS(url) method:

var client = Stomp.overWS('ws://localhost:61614');

Development Requirements

For development (testing, building) the project requires node.js. This allows us to run tests without the browser continuously during development (see cake watch).

$ npm install

Building and Testing

Build Status

To build JavaScript from the CoffeeScript source code:

$ cake build

To run tests:

$ cake test

To continuously run tests on file changes:

$ cake watch

Browser Tests

  • Make sure you have a running STOMP broker which supports the WebSocket protocol (see the documentation)
  • Open in your web browser the project's test page
  • Check all tests pass

Use

The project contains examples for using stomp.js to send and receive STOMP messages from a server directly in the Web Browser or in a WebWorker.

Authors

You can’t perform that action at this time.