The Reactive Extensions for JavaScript
Switch branches/tags
Nothing to show
Pull request Compare This branch is 2340 commits behind Reactive-Extensions:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
content
node_modules
src
tests
.gitignore
authors.txt
build_core.bat
grunt.js
license.md
license.txt
package.json
readme.md
rx.aggregates.js
rx.aggregates.min.js
rx.binding.js
rx.binding.min.js
rx.coincidence.js
rx.coincidence.min.js
rx.experimental.js
rx.experimental.min.js
rx.joinpatterns.js
rx.joinpatterns.min.js
rx.js
rx.min.js
rx.node.js
rx.testing.js
rx.testing.min.js
rx.time.js
rx.time.min.js

readme.md

The Reactive Extensions for JavaScript...

...is a set of libraries to compose asynchronous and event-based programs using observable collections and LINQ-style query operators in JavaScript

This project has moved to CodePlex and only serves as a mirror.

About the Reactive Extensions

The Reactive Extensions for JavaScript (RxJS) is a set of libraries for composing asynchronous and event-based programs using observable sequences and LINQ-style query operators in JavaScript. Using RxJS, developers represent asynchronous data streams with Observables, query asynchronous data streams using LINQ operators, and parameterize the concurrency in the asynchronous data streams using Schedulers. Simply put, RxJS = Observables + LINQ + Schedulers.

Whether you are authoring a web-based application in JavaScript or a server-side application in Node.js, you have to deal with asynchronous and event-based programming as a matter of course. Although some patterns are emerging such as the Promise pattern, handling exceptions, cancellation, and synchronization is difficult and error-prone.

Using RxJS, you can represent multiple asynchronous data streams (that come from diverse sources, e.g., stock quote, tweets, computer events, web service requests, etc.), and subscribe to the event stream using the Observer object. The Observable notifies the subscribed Observer instance whenever an event occurs.

Because observable sequences are data streams, you can query them using standard LINQ query operators implemented by the Observable type. Thus you can filter, project, aggregate, compose and perform time-based operations on multiple events easily by using these static LINQ operators. In addition, there are a number of other reactive stream specific operators that allow powerful queries to be written. Cancellation, exceptions, and synchronization are also handled gracefully by using the methods on the Observable object.

This set of libraries include:

  • rx.js - Core library
  • rx.aggregates.js - aggregation event processing query operations
  • rx.binding.js - binding operators including multicast, publish, publishLast, publishValue, and replay
  • rx.coincidence.js - reactive coincidence join event processing query operations
  • rx.experimental.js - experimental operators including imperative operators and forkJoin
  • rx.joinpatterns.js - join patterns event processing query operations
  • rx.testing.js - used to write unit tests for complex event processing queries.
  • rx.time.js - time-based event processing query operations.

Getting Started

Coming Soon

API Documentation

Core:

Subjects:

  • AsyncSubject
  • BehaviorSubject
  • ReplaySubject
  • Subject

Schedulers:

  • Scheduler object
  • Scheduler.currentThread
  • Scheduler.immediate
  • Scheduler.timeout
  • VirtualTimeScheduler

Disposables:

  • CompositeDisposable
  • Disposable
  • RefCountDisposable
  • SerialDisposable
  • SingleAssignmentDisposable

Installation and Usage

There are multiple ways of getting started with the Reactive Extensions including:

In a Browser:

<script src="rx.js"></script>

Along with a number of our extras for RxJS:

<script src="rx.aggregates.js"></script>
<script src="rx.binding.js"></script>
<script src="rx.coincidencejs"></script>
<script src="rx.experimental.js"></script>
<script src="rx.joinpatterns.js"></script>
<script src="rx.testing.js"></script>
<script src="rx.time.js"></script>

Installing via NPM:

npm install rxjs
npm install -g rxjs

Using in Node.js:

var Rx = require('rx');

Installing all of RxJS via NuGet:

Install-Package RxJS-All

Or install via NuGet individual packages:

Install-Package RxJS-Main
Install-Package RxJS-Aggregates
Install-Package RxJS-Binding
Install-Package RxJS-Coincidence
Install-Package RxJS-Experimental
Install-Package RxJS-JoinPatterns
Install-Package RxJS-Testing
Install-Package RxJS-Time

Using RxJS with an AMD loader such as Require.js

require({
    'paths': {
        'rx': 'path/to/rx.js'
    }
},
['rx'], function(Rx) {
    var obs = Rx.Observable.returnValue(42);
    obs.subscribe(function (x) { console.log(x); });
});

Compatibility

RxJS has been thoroughly tested against all major browsers and supports IE6+, Chrome 4+, FireFox 1+, and Node.js v0.4+.

License

Copyright (c) Microsoft Open Technologies, Inc. All rights reserved. Microsoft Open Technologies would like to thank its contributors, a list of whom are at http://rx.codeplex.com/wikipage?title=Contributors.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.