/atmosphere-javascript

atmosphere-javascript

Primary LanguageJavaScriptApache License 2.0Apache-2.0

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.

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>2.3.8</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.

Changelogs