123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113 |
- "use strict";
- var __extends = (this && this.__extends) || function (d, b) {
- for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
- function __() { this.constructor = d; }
- d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
- };
- var isFunction_1 = require('../util/isFunction');
- var Observable_1 = require('../Observable');
- var Subscription_1 = require('../Subscription');
- /**
- * We need this JSDoc comment for affecting ESDoc.
- * @extends {Ignored}
- * @hide true
- */
- var FromEventPatternObservable = (function (_super) {
- __extends(FromEventPatternObservable, _super);
- function FromEventPatternObservable(addHandler, removeHandler, selector) {
- _super.call(this);
- this.addHandler = addHandler;
- this.removeHandler = removeHandler;
- this.selector = selector;
- }
- /**
- * Creates an Observable from an API based on addHandler/removeHandler
- * functions.
- *
- * <span class="informal">Converts any addHandler/removeHandler API to an
- * Observable.</span>
- *
- * <img src="./img/fromEventPattern.png" width="100%">
- *
- * Creates an Observable by using the `addHandler` and `removeHandler`
- * functions to add and remove the handlers, with an optional selector
- * function to project the event arguments to a result. The `addHandler` is
- * called when the output Observable is subscribed, and `removeHandler` is
- * called when the Subscription is unsubscribed.
- *
- * @example <caption>Emits clicks happening on the DOM document</caption>
- * function addClickHandler(handler) {
- * document.addEventListener('click', handler);
- * }
- *
- * function removeClickHandler(handler) {
- * document.removeEventListener('click', handler);
- * }
- *
- * var clicks = Rx.Observable.fromEventPattern(
- * addClickHandler,
- * removeClickHandler
- * );
- * clicks.subscribe(x => console.log(x));
- *
- * @see {@link from}
- * @see {@link fromEvent}
- *
- * @param {function(handler: Function): any} addHandler A function that takes
- * a `handler` function as argument and attaches it somehow to the actual
- * source of events.
- * @param {function(handler: Function, signal?: any): void} [removeHandler] An optional function that
- * takes a `handler` function as argument and removes it in case it was
- * previously attached using `addHandler`. if addHandler returns signal to teardown when remove,
- * removeHandler function will forward it.
- * @param {function(...args: any): T} [selector] An optional function to
- * post-process results. It takes the arguments from the event handler and
- * should return a single value.
- * @return {Observable<T>}
- * @static true
- * @name fromEventPattern
- * @owner Observable
- */
- FromEventPatternObservable.create = function (addHandler, removeHandler, selector) {
- return new FromEventPatternObservable(addHandler, removeHandler, selector);
- };
- /** @deprecated internal use only */ FromEventPatternObservable.prototype._subscribe = function (subscriber) {
- var _this = this;
- var removeHandler = this.removeHandler;
- var handler = !!this.selector ? function () {
- var args = [];
- for (var _i = 0; _i < arguments.length; _i++) {
- args[_i - 0] = arguments[_i];
- }
- _this._callSelector(subscriber, args);
- } : function (e) { subscriber.next(e); };
- var retValue = this._callAddHandler(handler, subscriber);
- if (!isFunction_1.isFunction(removeHandler)) {
- return;
- }
- subscriber.add(new Subscription_1.Subscription(function () {
- //TODO: determine whether or not to forward to error handler
- removeHandler(handler, retValue);
- }));
- };
- FromEventPatternObservable.prototype._callSelector = function (subscriber, args) {
- try {
- var result = this.selector.apply(this, args);
- subscriber.next(result);
- }
- catch (e) {
- subscriber.error(e);
- }
- };
- FromEventPatternObservable.prototype._callAddHandler = function (handler, errorSubscriber) {
- try {
- return this.addHandler(handler) || null;
- }
- catch (e) {
- errorSubscriber.error(e);
- }
- };
- return FromEventPatternObservable;
- }(Observable_1.Observable));
- exports.FromEventPatternObservable = FromEventPatternObservable;
- //# sourceMappingURL=FromEventPatternObservable.js.map
|