Skip to content

Latest commit

 

History

History
76 lines (48 loc) · 2.98 KB

README.md

File metadata and controls

76 lines (48 loc) · 2.98 KB

STOMP.js

Build Status

This library provides a WebSocket over STOMP client for Web browser or node.js applications.

Introduction

This library allows you to connect to a STOMP broker over WebSocket. This library supports full STOMP specifications and all current protocol variants. Most of popular messaging brokers support STOMP and STOMP over WebSockets either natively or using plugins.

In general JavaScript engines at browsers are not amenable to binary protocols, so using STOMP, which is a text oriented protocol, becomes a reliable option.

This library was originally developed by Jeff Mesnil.

Current Status

This library is feature complete and has been in use in production for many years. It is actively maintained. You are welcome to file issues and submit pull requests.

Getting started

The documentation is hosted as GitHub pages. You may head straight to the entry point. (or with frames)

This library comes with a detailed usage instructions. Please find it at Usage instructions.

If you were using older versions and wish to benefit from newer features, head to Upgrading.

If you are existing user and will like to deep dive - API Reference for important entities:

NodeJS

If you are using this library in NodeJS you should definitely check NodeJS Legacy.

Using with Angular2/4

https://github.com/stomp-js/ng2-stompjs is based on this library and exposes entire functionality offered by this library as Angular Services and rxjs Observables. Both these libraries are maintained by similar set of contributors.

TypeScript definitions

The npm package includes TypeScript definitions, no need no install separately.

Change log

Please visit Change Log.

Contributing

If you want to understand the code, develop, contribute. Please visit How to contribute.

Authors

License

License - Apache v2 License