Observable API
The addTeardown() method of the Subscriber interface registers a callback to clean up resources when the subscription ends. This happens when either Subscriber.complete() or Subscriber.error() is called, or when all observers unsubscribe.
[!NOTE] This shared-subscription behavior may change. A proposal to give each observer its own
Subscriberwould make each subscription start a separate execution instead of reusing an active subscription.
The producer calls this method from the callback supplied to the Observable.Observable constructor. Calling addTeardown() registers the cleanup function; it does not end the subscription.
Syntax
addTeardown(callback)
Parameters
callback- : A callback function that takes no arguments and runs when the subscription ends. Its return value is ignored, so a returned promise is not awaited.
Return value
None (undefined).
Description
Callbacks registered while the subscriber is active run synchronously, in reverse registration order, after Subscriber.active becomes false and Subscriber.signal is aborted. When the producer calls complete() or error(), teardown callbacks run before the corresponding observer callbacks.
If the subscriber is already inactive when addTeardown() is called, the supplied callback runs immediately. If a teardown callback throws, the exception is reported to the global object and the remaining teardown callbacks still run.
Examples
Callback order
This example registers two teardown callbacks before completion and one afterward. The first two run in reverse registration order, before the observer's complete() callback; the last runs immediately when it is registered.
const observable = new Observable((subscriber) => {
subscriber.addTeardown(() => console.log("First registered"));
subscriber.addTeardown(() => console.log("Second registered"));
subscriber.complete();
subscriber.addTeardown(() => console.log("Registered after completion"));
});
observable.subscribe({
complete() {
console.log("Complete");
},
});
// Second registered
// First registered
// Complete
// Registered after completion
See the main Subscriber reference page for a basic example, and Creating custom observables for additional examples.
Specifications
Browser compatibility
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
