@reactivex/rxjs
Version:
Reactive Extensions for modern JavaScript
62 lines • 2.08 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
var Subject_1 = require("../Subject");
var multicast_1 = require("./multicast");
/* tslint:enable:max-line-length */
/**
* Returns a ConnectableObservable, which is a variety of Observable that waits until its connect method is called
* before it begins emitting items to those Observers that have subscribed to it.
*
* <span class="informal">Makes a cold Observable hot</span>
*
* 
*
* ## Examples
* Make source$ hot by applying publish operator, then merge each inner observable into a single one
* and subscribe.
* ```ts
* import { of, zip, interval, merge } from "rxjs";
* import { map, publish, tap } from "rxjs/operators";
*
* const source$ = zip(interval(2000), of(1, 2, 3, 4, 5, 6, 7, 8, 9)).pipe(
* map(values => values[1])
* );
*
* source$
* .pipe(
* publish(multicasted$ =>
* merge(
* multicasted$.pipe(tap(x => console.log('Stream 1:', x))),
* multicasted$.pipe(tap(x => console.log('Stream 2:', x))),
* multicasted$.pipe(tap(x => console.log('Stream 3:', x))),
* )
* )
* )
* .subscribe();
*
* // Results every two seconds
* // Stream 1: 1
* // Stream 2: 1
* // Stream 3: 1
* // ...
* // Stream 1: 9
* // Stream 2: 9
* // Stream 3: 9
* ```
*
* @param {Function} [selector] - Optional selector function which can use the multicasted source sequence as many times
* as needed, without causing multiple subscriptions to the source sequence.
* Subscribers to the given source will receive all notifications of the source from the time of the subscription on.
* @return A ConnectableObservable that upon connection causes the source Observable to emit items to its Observers.
* @method publish
* @owner Observable
*
*
*/
function publish(selector) {
return selector ?
multicast_1.multicast(function () { return new Subject_1.Subject(); }, selector) :
multicast_1.multicast(new Subject_1.Subject());
}
exports.publish = publish;
//# sourceMappingURL=publish.js.map