Observable

1. If this 's ’s active is false, then return.

2. If this 's ’s relevant global object is a Window object, and its associated Document is not fully active , then return.

3. Run this 's ’s next algorithm given value .

   Assert : No exception was thrown .

   Note: No exception can be thrown here because in the case where next algorithm is just a wrapper around a script-provided callback, the process observer steps take care to wrap these callbacks in logic that, when invoking them, catches any exceptions, and reports them to the global.

   When the next algorithm is a spec algorithm, those steps take care to not throw any exceptions outside of itself, to appease this assert.

1. If this 's ’s active is false, report the exception error , then return.

2. If this 's ’s relevant global object is a Window object, and its associated Document is not fully active , then return.

3. Close this .

4. Run this 's ’s error algorithm given error .

   Assert : No exception was thrown .

   Note: See the documentation in next() for details on why this is true.

1. If this 's ’s active is false, then return.

2. If this 's ’s relevant global object is a Window object, and its associated Document is not fully active , then return.

3. Close this .

4. Run this 's ’s complete algorithm .

   Assert : No exception was thrown .

   Note: See the documentation in next() for details on why this is true.

1. If this 's ’s relevant global object is a Window object, and its associated Document is not fully active , then return.

2. If this 's ’s active is true, then append teardown to this 's ’s teardown callbacks list.

3. Otherwise, invoke teardown .

   If an exception E was thrown , then report the exception E .

1. If subscriber ’s active is false, then return.

   This guards against re-entrant invocation, which can happen in the "producer-initiated" unsubscription case. Consider the following example:

   const outerController = new AbortController();
   const observable = new Observable(subscriber => {
     subscriber.addTeardown(() => {
       // 2.) This teardown executes inside the "Close" algorithm, while it’s
       //     running. Aborting the downstream signal run its abort algorithms,
       //     one of which is the currently-running "Close" algorithm.
       outerController.abort();
     });
     // 1.) This immediately invokes the "Close" algorithm, which
     //     sets subscriber.active to false.
     subscriber.complete();
   });
   observable.subscribe({}, {signal: outerController.signal});
   

2. Set subscriber ’s active boolean to false.

3. Signal abort subscriber ’s subscription controller with reason , if it is given.

4. For each teardown of subscriber ’s teardown callbacks sorted in reverse insertion order:

   1. If subscriber ’s relevant global object is a Window object, and its associated Document is not fully active , then abort these steps.

      Note: This step runs repeatedly because each teardown could result in the above Document becoming inactive.

   2. Invoke teardown .

      If an exception E was thrown , then report the exception E .

1. Set this 's ’s subscribe callback to callback .

   Note: This callback will get invoked later when subscribe() is called.

1. Subscribe to this given observer and options .

1. Report the exception error .

Note: We pull this default out separately so that every place in this specification that natively subscribes to an Observable (i.e., subscribes from spec prose, not going through the subscribe() method) doesn’t have to redundantly define these steps.

Note: We split this algorithm out from the Web IDL from() method, so that spec prose can convert values to without going through the Web IDL bindings.

1. If Type ( value ) is not Object , throw a TypeError .

   Note: This prevents primitive types from being coerced into iterables (e.g., String). See discussion in WICG/observable#125 .

2. From Observable : If value ’s specific type is an Observable , then return value .

3. Spec the From async iterable conversion steps which take place before the iterable conversion steps.

4. From iterable : Let iteratorMethod be ? GetMethod ( value , %Symbol.iterator% ).

5. If iteratorMethod is undefined, then jump to the step labeled From Promise .

   Otherwise, return a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let iteratorRecordCompletion be GetIterator ( value , sync).

   2. If iteratorRecordCompletion is a throw completion , then run subscriber ’s error() method, given iteratorRecordCompletion ’s [[Value]], and abort these steps.

   3. Let iteratorRecord be ! iteratorRecordCompletion .

   4. While true:

      1. Let next be IteratorStepValue ( iteratorRecord ).

      2. If next is a throw completion , then run subscriber ’s error() method, given next ’s [[Value]], and break .

      3. Set next to ! to next .

      4. If next is done, then:

         1. Assert : iteratorRecord ’s [[Done]] is true.

         2. Run subscriber ’s complete() .

         3. Return.

      5. Run subscriber ’s next() given next .

6. From Promise : If IsPromise ( value ) is true, then:

   1. Return a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

      1. React to value :

         1. If value was fulfilled with value v , then:

            1. Run subscriber ’s next() method, given v .

            2. Run subscriber ’s complete() method.

         2. If value was rejected with reason r , then run subscriber ’s error() method, given r .

7. Throw a TypeError .

Note: We split this algorithm out from the Web IDL subscribe() method, so that spec prose can subscribe to an Observable without going through the Web IDL bindings. See w3c/IntersectionObserver#464 for similar context, where "internal" prose must not go through Web IDL bindings on objects whose properties could be mutated by JavaScript. See § 2.3.3 Promise-returning operators for usage of this.

1. If this 's ’s relevant global object is a Window object, and its associated Document is not fully active , then return.

2. Let internal observer be a new internal observer .

3. Process observer as follows:

   1. If observer is an ObservableSubscriptionCallback

      Set internal observer ’s next steps to these steps that take an any value :

      1. Invoke observer with value .

         If an exception E was thrown , then report the exception E .

      If observer is a SubscriptionObserver

      1. If observer ’s next exists , then set internal observer ’s next steps to these steps that take an any value :

         1. Invoke observer ’s next with value .

            If an exception E was thrown , then report the exception E .

      2. If observer ’s error exists , then set internal observer ’s error steps to these steps that take an any error :

         1. Invoke observer ’s error with error .

            If an exception E was thrown , then report the exception E .

      3. If observer ’s complete exists , then set internal observer ’s complete steps to these steps:

         1. Invoke observer ’s complete .

            If an exception E was thrown , then report the exception E .

      If observer is an internal observer

      Set internal observer to observer .

4. Assert : internal observer ’s error steps is either the default error algorithm , or an algorithm that invokes the provided error callback function .

5. Let subscriber be a new Subscriber , initialized as:

   next algorithm

   internal observer ’s next steps

   error algorithm

   internal observer ’s error steps

   complete algorithm

   internal observer ’s complete steps

6. If options ’s signal exists , then:

   1. If options ’s signal is aborted , then close subscriber given options ’s signal abort reason .

   2. Otherwise, add the following abort algorithm to options ’s signal :

      1. Close subscriber with options ’s signal abort reason .

7. If this 's ’s subscribe callback is a SubscribeCallback , invoke it with subscriber .

   If an exception E was thrown , call subscriber ’s error() method with E .

8. Otherwise, run the steps given by this 's ’s subscribe callback , given subscriber .

1. Return the exact semantics result of converting value to an from() Observable conversion. . Rethrow any exceptions.

1. Let sourceObservable be this .

2. Let notifier be the result of converting value to an Observable.

3. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   Note that this method involves Subscribing to two Observable s: (1) notifier , and (2) sourceObservable . We "unsubscribe" from both of them in the following situations:

   1. notifier starts emitting values (either "next" or "error"). In this case, we unsubscribe from notifier since we got all we need from it, and no longer need it to keep producing values. We also unsubscribe from sourceObservable , because it no longer needs to produce values that get plumbed through this method’s returned observable , because we’re manually ending the subscription to observable , since notifier finally produced a value.

   2. sourceObservable either error() s or complete() s itself. In this case, we unsubscribe from notifier since we no longer need to listen for values it emits in order to determine when observable can stop mirroring values from sourceObservable (since sourceObservable ran to completion by itself). Unsubscribing from sourceObservable isn’t necessary, since its subscription has been exhausted by itself.

   1. Let notifierObserver be a new internal observer , initialized as follows:

      next steps

      Run subscriber ’s complete() method.

      Note: This will "unsubscribe" from sourceObservable , if it has been subscribed to by this point. This is because sourceObservable is subscribed to with the "outer" subscriber ’s subscription controller 's ’s signal as an input signal, and that signal will get aborted when the "outer" subscriber ’s complete() is called above (and below).

      error steps

      Run subscriber ’s complete() method.

      Note: We do not specify complete steps , because if the notifier Observable completes itself, we do not need to complete the subscriber associated with the observable returned from this method. Rather, the observable will continue to mirror sourceObservable uninterrupted.

   2. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   3. Subscribe to notifier given notifierObserver and options .

   4. If subscriber ’s active is false, then return.

      Note: This means that sourceObservable ’s subscribe callback will not even get invoked once, if notifier synchronously emits a value. If notifier only "completes" synchronously though (without emitting a "next" or "error" value), then subscriber ’s active will still be true, and we proceed to subscribe to sourceObservable , which observable will mirror uninterrupted.

   5. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      Run subscriber ’s next() method, given the passed in value .

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      Run subscriber ’s complete() method.

      Note: sourceObserver is mostly a pass-through, mirroring everything that sourceObservable emits, with the exception of having the ability to unsubscribe from the notifier Observable in the case where sourceObservable is exhausted before notifier emits anything.

   6. Subscribe to sourceObservable given sourceObserver and options .

4. Return observable .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let idx be an unsigned long long , initially 0.

   2. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. Invoke mapper with the passed in value , and idx , and let mappedValue be the returned value.

         If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

      2. Increment idx .

      3. Run subscriber ’s next() method, given mappedValue .

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      Run subscriber ’s complete() method.

   3. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   4. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let idx be an unsigned long long , initially 0.

   2. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. Invoke predicate with the passed in value and idx , and let matches be the returned value.

         If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

      2. Set idx to idx + 1.

      3. If matches is true, then run subscriber ’s next() method, given value .

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      Run subscriber ’s complete() method.

   3. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   4. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let remaining be amount .

   2. If remaining is 0, then run subscriber ’s complete() method and abort these steps.

   3. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. Run subscriber ’s next() method with the passed in value .

      2. Decrement remaining .

      3. If remaining is 0, then run subscriber ’s complete() method.

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      Run subscriber ’s complete() method.

   4. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   5. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let remaining be amount .

   2. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. If remaining is > 0, then decrement remaining and abort these steps.

      2. Assert : remaining is 0.

      3. Run subscriber ’s next() method with the passed in value .

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      Run subscriber ’s complete() method.

   3. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   4. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let idx be an unsigned long long , initially 0.

   2. Let outerSubscriptionHasCompleted to a boolean , initially false.

   3. Let queue be a new list of any values, initially empty.

      Note: This queue is used to store any Observable s emitted by sourceObservable , while observable is currently subscribed to an Observable emitted earlier by sourceObservable that has not yet been exhausted.

   4. Let activeInnerSubscription be a boolean , initially false.

   5. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. If activeInnerSubscription is true, then:

         1. Append value to queue .

            Note: This value will eventually be processed once the Observable that is currently subscribed-to (as indicated by activeInnerSubscription ) is exhausted.

      2. Otherwise:

         1. Set activeInnerSubscription to true.

         2. Run the flatmap process next value steps with value , subscriber , mapper , and references to all of the following: queue , activeInnerSubscription , outerSubscriptionHasCompleted , and idx .

            Note: This flatmap process next value steps will subscribe to the Observable derived from value (if one such can be derived) and keep processing values from it until its subscription becomes inactive (either by error or completion). If this "inner" Observable completes, then the processing steps will recursively invoke themselves with the next any in queue .

            If no such value exists , then the processing steps will terminate, unsetting activeInnerSubscription , so that future values emitted from sourceObservable are processed correctly.

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      1. Set outerSubscriptionHasCompleted to true.

         Note: If activeInnerSubscription is true, then the below step will not complete subscriber . In that case, the flatmap process next value steps will be responsible for completing subscriber when queue is empty , after the "inner" subscription becomes inactive.

      2. If activeInnerSubscription is false and queue is empty , run subscriber ’s complete() method.

   6. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   7. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. Let mappedResult be the result of invoking mapper with value and idx .

   If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

2. Set idx to idx + 1.

3. Let innerObservable be the result of calling from() with mappedResult .

   If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

   We shouldn’t invoke from() directly. Rather, we should call some internal algorithm that passes-back the exceptions for us to handle properly here, since we want to pipe them to subscriber .

4. Let innerObserver be a new internal observer , initialized as follows:

   next steps

   Run subscriber ’s next() method, given the passed in value .

   error steps

   Run subscriber ’s error() method, given the passed in error .

   complete steps

   1. If queue is not empty, then:

      1. Let nextValue be the first item in queue ; remove remove this item from queue .

      2. Run flatmap process next value steps given nextValue , subscriber , mapper , and references to queue and activeInnerSubscription .

   2. Otherwise:

      1. Set activeInnerSubscription to false.

         Note: Because activeInnerSubscription is a reference, this has the effect of ensuring that all subsequent values emitted from the "outer" Observable (called sourceObservable .

      2. If outerSubscriptionHasCompleted is true, run subscriber ’s complete() method.

         Note: This means the "outer" Observable has already completed, but did not proceed to complete subscriber yet because there was at least one more pending "inner" Observable (i.e., innerObservable ) that had already been queued and had not yet completed. Until right now!

5. Let innerOptions be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

6. Subscribe to innerObservable given innerObserver and innerOptions .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let idx be an unsigned long long , initially 0.

   2. Let outerSubscriptionHasCompleted be a boolean , initially false.

   3. Let activeInnerAbortController be an AbortController -or-null, initially null.

      Note: This AbortController is assigned to a new AbortController only by this algorithm’s next steps (below), and only assigned to null by the switchmap process next value steps , when the "inner" Observable either completes or errors. This variable is used as a marker for whether there is currently an active "inner" subscription. The complete steps below care about this, because if sourceObservable completes while there is an active "inner" subscription, we do not immediately complete subscriber . In that case, subscriber ’s completion becomes blocked on the "inner" subscription’s completion.

   4. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. If activeInnerAbortController is not null, then signal abort activeInnerAbortController .

         Note: This "unsubscribes" from the "inner" Observable that was derived from the value that was last pushed from sourceObservable . Then we immediately subscribe to the new Observable that we’re about to derive from value , i.e., the most-recently pushed value from sourceObservable .

      2. Set activeInnerAbortController to a new AbortController .

      3. Run the switchmap process next value steps with value , subscriber , mapper , and references to all of the following: activeInnerAbortController , outerSubscriptionHasCompleted , and idx .

         Note: The switchmap process next value steps will subscribe to the Observable derived from value (if one such can be derived) and keep processing values from it until either (1) its subscription becomes inactive (either by error or completion), or (2) activeInnerAbortController gets aborted , due to sourceObservable pushing another newer value that will replace the current "inner" subscription.

      error steps

      Run subscriber ’s error() method, given the passed in error .

      complete steps

      1. Set outerSubscriptionHasCompleted to true.

         Note: If activeInnerAbortController is not null, then we don’t immediately complete subscriber . Instead, the switchmap process next value steps will complete subscriber when the inner subscription finally completes itself.

      2. If activeInnerAbortController is null, run subscriber ’s complete() method.

   5. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   6. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. Let mappedResult be the result of invoking mapper with value and idx .

   If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

2. Set idx to idx + 1.

3. Let innerObservable be the result of calling from() with mappedResult .

   If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

4. Let innerObserver be a new internal observer , initialized as follows:

   next steps

   Run subscriber ’s next() method, given the passed in value .

   error steps

   Run subscriber ’s error() method, given the passed in error .

   Note: We don’t have to set activeInnerAbortController to null here, to signal to the switchMap() method steps above that the inner "subscription" has been canceled. That’s because calling subscriber ’s error() method already unsubscribes from the "outer" source Observable, so it will not be able to push any more values to the switchMap() internal observer.

   complete steps

   1. If outerSubscriptionHasCompleted is true, run subscriber ’s complete() method.

   2. Otherwise, set activeInnerAbortController to null.

      Note: Because this variable is a reference, it signals to the switchMap complete steps that there is no active inner subscription.

5. Let innerOptions be a new SubscribeOptions whose signal is the result of creating a dependent abort signal from the list « activeInnerAbortController ’s signal , subscriber ’s subscription controller 's ’s signal », using AbortSignal , and the current realm .

6. Subscribe to innerObservable given innerObserver and innerOptions .

1. Let subscribe callback be a VoidFunction -or-null, initially null.

2. Let next callback be a ObservableSubscriptionCallback -or-null, initially null.

3. Let error callback be a ObservableSubscriptionCallback -or-null, initially null.

4. Let complete callback be a VoidFunction -or-null, initially null.

5. Let abort callback be a ObservableInspectorAbortHandler -or-null, initially null.

6. Process inspector_union as follows:

   If inspector_union is an ObservableSubscriptionCallback

   1. Set next callback to inspector_union .

   If inspector_union is an ObservableInspector

   1. If subscribe exists in inspector_union , then set subscribe callback to it.

   2. If next exists in inspector_union , then set next callback to it.

   3. If error exists in inspector_union , then set error callback to it.

   4. If complete exists in inspector_union , then set complete callback to it.

   5. If abort exists in inspector_union , then set abort callback to it.

7. Let sourceObservable be this .

8. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. If subscribe callback is not null, then invoke it.

      If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

      Note: The result of this is that sourceObservable is never subscribed to.

   2. If abort callback is not null, then add the following abort algorithm to subscriber ’s subscription controller 's ’s signal :

      1. Invoke abort callback with subscriber ’s subscription controller 's ’s signal 's ’s abort reason .

         If an exception E was thrown , then report the exception E .

   3. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      1. If next callback is not null, then invoke next callback with the passed in value .

         If an exception E was thrown , then:

         1. Remove abort callback from subscriber ’s subscription controller 's ’s signal .

            Note: This step is important, because the abort callback is only meant to be called for consumer-initiated unsubscriptions. When the producer terminates the subscription (via subscriber ’s error() or complete() methods) like below, we have to ensure that abort callback is not run.

            This matches Chromium’s implementation, but consider holding a reference to the originally-passed-in SubscribeOptions 's ’s signal and just invoking abort callback when it aborts. The result is likely the same, but needs investigation.

         2. Run subscriber ’s error() method, given E , and return.

      2. Run subscriber ’s next() method with the passed in value .

      error steps

      Remove abort callback from subscriber ’s subscription controller 's ’s signal , and run subscriber ’s error() method, given the passed in error .

      complete steps

      Remove abort callback from subscriber ’s subscription controller 's ’s signal , and run subscriber ’s complete() method.

   4. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   5. Subscribe to sourceObservable given sourceObserver and options .

9. Return observable .

1. Let sourceObservable be this .

2. Let observable be a new Observable whose subscribe callback is an algorithm that takes a Subscriber subscriber and does the following:

   1. Let sourceObserver be a new internal observer , initialized as follows:

      next steps

      Run subscriber ’s next() method, given the passed in value .

      error steps

      1. Invoke callback with the passed in error . Let result be the returned value.

         If an exception E was thrown , then run subscriber ’s error() with E , and abort these steps.

      2. Let innerObservable be the result of calling from() with result .

         If an exception E was thrown , then run subscriber ’s error() method, given E , and abort these steps.

         We shouldn’t invoke from() directly. Rather, we should call some internal algorithm that passes-back the exceptions for us to handle properly here, since we want to pipe them to subscriber .

      3. Let innerObserver be a new internal observer , initialized as follows:

         next steps

         Run subscriber ’s next() method, given the passed in value .

         error steps

         Run subscriber ’s error() method, given the passed in error .

         complete steps

         Run subscriber ’s complete() method.

      4. Let innerOptions be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

      5. Subscribe to innerObservable given innerObserver and innerOptions .

         Note: We’re free to subscribe to innerObservable here without first "unsubscribing" from sourceObservable , and without fear that sourceObservable will keep emitting values, because all of this is happening inside of the error steps associated with sourceObservable . This means sourceObservable has already completed its subscription and will no longer produce any values, and we are free to safely switch our source of values to innerObservable .

      complete steps

      Run subscriber ’s complete() method.

   2. Let options be a new SubscribeOptions whose signal is subscriber ’s subscription controller 's ’s signal .

   3. Subscribe to sourceObservable given sourceObserver and options .

3. Return observable .

1. TODO: Spec this and use callback .

1. Let p a new promise .

2. If options ’s signal is not null:

   1. If options ’s signal is aborted , then:

      1. Reject p with options ’s signal 's ’s abort reason .

      2. Return p .

   2. Add the following abort algorithm to options ’s signal :

      1. Reject p with options ’s signal 's ’s abort reason .

      Note: All we have to do here is reject p . Note that the subscription to this Observable will also be closed automatically, since the "inner" Subscriber gets closed in response to options ’s signal getting signal abort .

3. Let values be a new list .

4. Let observer be a new internal observer , initialized as follows:

   next steps

   Append the passed in value to values .

   error steps

   Reject p with the passed in error .

   complete steps

   Resolve p with values .

5. Subscribe to this given observer and options .

6. Return p .

1. Let p a new promise .

2. Let visitor callback controller be a new AbortController .

3. Let internal options be a new SubscribeOptions whose signal is the result of creating a dependent abort signal from the list « visitor callback controller ’s signal , options ’s signal if non-null», using AbortSignal , and the current realm .

   Many trivial internal observers act as pass-throughs, and do not control the subscription to the Observable that they represent; that is, their error steps and complete steps are called when the subscription is terminated, and their next steps simply pass some version of the given value along the chain.

   For this operator, however, the below observer ’s next steps are responsible for actually aborting the underlying subscription to this , in the event that callback throws an exception. In that case, the SubscribeOptions 's ’s signal we pass through to " Subscribe to an Observable ", needs to be a dependent signal derived from options ’s signal , and the AbortSignal of an AbortController that the next steps below has access to, and can signal abort when needed.

4. If internal options ’s signal is aborted , then:

   1. Reject p with internal options ’s signal 's ’s abort reason .

   2. Return p .

5. Add the following abort algorithm to internal options ’s signal :

   1. Reject p with internal options ’s signal 's ’s abort reason .

      Note: The fact that rejection of p is tied to internal options ’s signal , and not options ’s signal means, that any microtasks queued during the firing of options ’s signal 's ’s abort event will run before p ’s rejection handler runs.

6. Let idx be an unsigned long long , initially 0.

7. Let observer be a new internal observer , initialized as follows:

   next steps

   1. Invoke callback with the passed in value , and idx .

      If an exception E was thrown , then reject p with E , and signal abort visitor callback controller with E .

   2. Increment idx .

   error steps

   Reject p with the passed in error .

   complete steps

   Resolve p with undefined .

8. Subscribe to this given observer and internal options .

9. Return p .

1. Let p a new promise .

2. Let controller be a new AbortController .

3. Let internal options be a new SubscribeOptions whose signal is the result of creating a dependent abort signal from the list « controller ’s signal , options ’s signal if non-null», using AbortSignal , and the current realm .

4. If internal options ’s signal is aborted , then:

   1. Reject p with internal options ’s signal 's ’s abort reason .

   2. Return p .

5. Add the following abort algorithm to internal options ’s signal :

   1. Reject p with internal options ’s signal 's ’s abort reason .

6. Let idx be an unsigned long long , initially 0.

7. Let observer be a new internal observer , initialized as follows:

   next steps

   1. Invoke predicate with the passed in value and idx , and let passed be the returned value.

      If an exception E was thrown , then reject p with E , and signal abort controller with E .

   2. Set idx to idx + 1.

   3. If passed is false, then resolve p with false, and signal abort controller .

   error steps

   Reject p with the passed in error .

   complete steps

   Resolve p with true.

8. Subscribe to this given observer and internal options .

9. Return p .

1. Let p a new promise .

2. Let controller be a new AbortController .

3. Let internal options be a new SubscribeOptions whose signal is the result of creating a dependent abort signal from the list « controller ’s signal , options ’s signal if non-null», using AbortSignal , and the current realm .

4. If internal options ’s signal is aborted , then:

   1. Reject p with internal options ’s signal 's ’s abort reason .

   2. Return p .

5. Add the following abort algorithm to internal options ’s signal :

   1. Reject p with internal options ’s signal 's ’s abort reason .

6. Let internal observer be a new internal observer , initialized as follows:

   next steps

   1. Resolve p with the passed in value .

   2. Signal abort controller .

   error steps

   Reject p with the passed in error .

   complete steps

   Resolve p with undefined .

   Note: This is only reached when the source Observable completes before it emits a single value; in this case, resolving with undefined is harmless but makes it difficult to distinguish between the first value trule being undefined and premature completion. See #132 for discussion on this.

7. Subscribe to this given internal observer and internal options .

8. Return p .

1. Let p a new promise .

2. If options ’s signal is not null:

   1. If options ’s signal is aborted , then:

      1. Reject p with options ’s signal 's ’s abort reason .

      2. Return p .

   2. Add the following abort algorithm to options ’s signal :

      1. Reject p with options ’s signal 's ’s abort reason .

3. Let lastValue be an any -or-null, initially null.

4. Let hasLastValue be a boolean , initially false.

5. Let observer be a new internal observer , initialized as follows:

   next steps

   1. Set hasLastValue to true.

   2. Set lastValue to the passed in value .

   error steps

   Reject p with the passed in error .

   complete steps

   1. If hasLastValue is true, resolve p with lastValue .

      1. Otherwise, resolve p with undefined .

         Note: See the note in first() .

6. Subscribe to this given observer and options .

7. Return p .

1. Let p a new promise .

2. Let controller be a new AbortController .

3. Let internal options be a new SubscribeOptions whose signal is the result of creating a dependent abort signal from the list « controller ’s signal , options ’s signal if non-null», using AbortSignal , and the current realm .

4. If internal options ’s signal is aborted , then:

   1. Reject p with internal options ’s signal 's ’s abort reason .

   2. Return p .

5. Add the following abort algorithm to internal options ’s signal :

   1. Reject p with internal options ’s signal 's ’s abort reason .

6. Let idx be an unsigned long long , initially 0.

7. Let observer be a new internal observer , initialized as follows:

   next steps

   1. Invoke predicate with the passed in value an idx , and let passed be the returned value.

      If an exception E was thrown , then reject p with E , and signal abort controller with E .

   2. Set idx to idx + 1.

   3. If passed is true, then resolve p with value , and signal abort controller .

   error steps

   Reject p with the passed in error .

   complete steps

   Resolve p with undefined .

8. Subscribe to this given observer and internal options .

9. Return p .

1. Let p a new promise .

2. Let controller be a new AbortController .

3. Let internal options be a new SubscribeOptions whose signal is the result of creating a dependent abort signal from the list « controller ’s signal , options ’s signal if non-null», using AbortSignal , and the current realm .

4. If internal options ’s signal is aborted , then:

   1. Reject p with internal options ’s signal 's ’s abort reason .

   2. Return p .

5. Add the following abort algorithm to internal options ’s signal :

   1. Reject p with internal options ’s signal 's ’s abort reason .

6. Let idx be an unsigned long long , initially 0.

7. Let observer be a new internal observer , initialized as follows:

   next steps

   1. Invoke predicate with the passed in value and idx , and let passed be the returned value.

      If an exception E was thrown , then reject p with E , and signal abort controller with E .

   2. Set idx to idx + 1.

   3. If passed is true, then resolve p with true, and signal abort controller .

   error steps

   Reject p with the passed in error .

   complete steps

   Resolve p with false.

8. Subscribe to this given observer and internal options .

9. Return p .

1. TODO: Spec this and use reducer , initialValue , and options .

1. If this 's ’s relevant global object is a Window object, and its associated Document is not fully active , then return.

2. Let event target be this .

3. Let observable be a new Observable , initialized as follows:

   subscribe callback

   An algorithm that takes a Subscriber subscriber and runs these steps:

   1. If event target is null, abort these steps.

      Note: This is meant to capture the fact that event target can be garbage collected by the time this algorithm runs upon subscription.

   2. If subscriber ’s subscription controller 's ’s signal is aborted , abort these steps.

   3. Add an event listener with event target and an event listener defined as follows:

      type

      type

      callback

      The result of creating a new Web IDL EventListener instance representing a reference to a function of one argument of type Event event . This function executes the observable event listener invoke algorithm given subscriber and event .

      capture

      options ’s capture

      passive

      options ’s passive

      once

      false

      signal

      null

      Note: The AbortSignal for event listeners added by when() is managed by the Observable itself. See subscribe() and SubscribeOptions .

4. Return observable .

1. Run subscriber ’s next() method with event .