Subscriber: Methode complete()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die Methode complete() der Schnittstelle Subscriber schließt das Abonnement und benachrichtigt die Observer darüber, dass der Stream erfolgreich abgeschlossen wurde.
Syntax
complete()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Beschreibung
Beim Aufruf dieser Methode wird active auf false gesetzt, signal abgebrochen und die registrierten Teardown-Callbacks ausgeführt. Anschließend ruft die Methode synchron den complete-Callback jedes Observers auf, wie er im observer-Objekt angegeben wurde, das an Observable.subscribe() übergeben wurde. Ist der Subscriber bereits inaktiv, bewirkt die Methode nichts. Ein Aufruf von complete() beendet die Ausführung des Producer-Codes nicht; nachfolgende Aufrufe von Subscriber.next() für diesen Subscriber haben keine Wirkung.
Hinweis:
Dieses Verhalten bei gemeinsam genutzten Abonnements kann sich ändern. Ein Vorschlag, jedem Observer einen eigenen Subscriber zuzuweisen, würde dazu führen, dass jedes Abonnement eine eigene Ausführung startet, statt ein aktives Abonnement wiederzuverwenden.
Das Abbestellen ruft den complete-Callback eines Observers nicht auf. Verwenden Sie addTeardown() für Bereinigungsarbeiten, die auch ausgeführt werden müssen, wenn Observer das Abonnement abbestellen oder im Stream ein Fehler auftritt.
Beispiele
Ein einfaches Beispiel finden Sie auf der Hauptreferenzseite zu Subscriber. Weitere Beispiele finden Sie unter Benutzerdefinierte Observables erstellen.
Spezifikationen
| Spezifikation |
|---|
| Observable # dom-subscriber-complete |