- implements WAMP v1, works with any WAMP server
- provides asynchronous RPC and PubSub messaging patterns
- easy to use Promise-based API
- pluggable promises/deferreds: use when.js (built-in), jQuery, Dojo or others
- flexible, automatic reconnect
- session authentication (WAMP-CRA)
- no dependencies
- tiny size (65kB source, 24kB minified, 7kB compressed)
- Open-Source (MIT License)
You can link to the latest prebuilt release hosted on Amazon S3 here
What is that?
WebSocket is already built into modern browsers and provides bidirectional low-latency messaging.
However, as such, it is quite low-level. Web apps often have a need for higher level messaging patterns:
- Publish & Subscribe
- Remote Procedure Calls
This is where WAMP enters. WAMP runs on top of raw WebSocket and provides asynchronous RPC and PubSub.
Technically, WAMP is a proper WebSocket subprotocol that uses JSON as message serialization format. WAMP was designed to be easy to use and simple to implement.
Where to go
For more information, including getting started, tutorials and reference documentation, please visit the project's homepage.
Get in touch
Get in touch on IRC #autobahn on chat.freenode.net or join the mailing list.
AutobahnJS includes code from the following open-source projects
Building AutobahnJS will create a single file, minimized version of the library.
To build, you will need
SCons is a Python based build tool, so you will need Python as well.
Set environment variables:
- JAVA_HOME pointing to your Java run-time
- JS_COMPILER pointing to the Google Closure compiler.jar
Now clone the repo, set the appropriate AutobahnJS version and build:
git clone git://github.com/tavendo/AutobahnJS.git cd AutobahnJS vi version.txt scons
This will produce 2 files
To clean up your build
To update the submodules:
cd when git pull git checkout 1.3.0 cd .. git add when
To update CryptoJS: needs to be done manually, since they are not on Git.