symbol-observable

Symbol.observable ponyfill

Install

$ npm install --save symbol-observable

Basic Usage

const symbolObservable = require('symbol-observable').default;

console.log(symbolObservable);
//=> Symbol(observable)

import Symbol_observable from 'symbol-observable';

console.log(Symbol_observable);
//=> Symbol(observable)

Making an object "observable":

You can do something like what you see below to make any object "observable" by libraries like RxJS, XStream and Most.js.

Things to know:

1. It's best if you just use one of the above libraries.
2. If you're not, but sure you never next, error or complete on your observer after error or complete was called.
3. Likewise, make sure you don't next, error or complete after unsubscribe is called on the returned object.

import Symbol_observable from 'symbol-observable';

someObject[Symbol_observable] = () => {
  return {
    subscribe(observer) {
      const handler = e => observer.next(e);
      someObject.addEventListener('data', handler);
      return {
        unsubscribe() {
          someObject.removeEventListener('data', handler);
        }
      }
    },
    [Symbol_observable]() { return this }
  }
}

Often, it's not very hard, but it can get tricky in some cases.

Related

• is-observable - Check if a value is an Observable
• observable-to-promise - Convert an Observable to a Promise

License

MIT © Sindre Sorhus and Ben Lesh

Current Tags

• 4.0.0                                ...           latest (4 years ago)

6 Versions

• 3.0.0                                ...           5 years ago
• 4.0.0                                ...           4 years ago
• 2.0.3                                ...           5 years ago
• 0.2.4                                ...           9 years ago
• 1.0.1                                ...           9 years ago
• 1.2.0                                ...           8 years ago