Welcome to Atmosphere: The Asynchronous WebSocket/Comet Framework
The Atmosphere Framework contains client and server side components for building Asynchronous Web Applications. The majority of popular frameworks are either supporting Atmosphere or supported natively by the framework. The Atmosphere Framework supports all major Browsers and Servers
Follow us on Twitter or get the latest news here
Atmosphere transparently supports WebSockets, Server Sent Events (SSE), Long-Polling, HTTP Streaming (Forever frame) and JSONP.
Note: In version 2.2.x, there are two versions of the scripts a jquery plugin version jquery.atmosphere.js and a plain javascript version atmosphere.js. As keeping both versions requires overhead and also confuses the users which to choose, in 2.3.x, only the plain javascript version will be supported. If you are currently using the 2.2.x jquery version, please consider migrating to the plain javascript version.
Install
manually
You can get atmosphere.js in several ways. If you use a script tag whose src attribute is set to the below one, browser may not load it because the content type served by raw.github.com is text/plain.
Also it is available from the following places, but there may be delays between a release and its availability. We don't manage these ways officially but they are managed by open source community so you can contribute.
- NPM - atmosphere.js
- WebJars - atmosphere
If you need to support Inetrnet Explorer 7, Firefox 3.0, Safari 3 and Opera 10 and lower versions, a JSON.stringify
/ JSON.parse
polyfill is henceforth required like: https://github.com/bestiejs/json3
maven
<dependency>
<groupId>org.atmosphere.client</groupId>
<artifactId>javascript</artifactId>
<version>3.0.6</version>
</dependency>
npm
npm install atmosphere.js
bower
bower install atmosphere
Docs
Full API documentation can be read here and a lot of samples here
It is recommended to always use the version that matches Atmosphere's runtime.
Latest version may work with lower version, but not officially tested.