DisposableStack.prototype.adopt()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die Methode adopt() von DisposableStack-Instanzen registriert einen Wert, der das Disposable-Protokoll nicht implementiert, im Stack. Dazu wird eine benutzerdefinierte Bereinigungsfunktion bereitgestellt.
Syntax
adopt(value, onDispose)
Parameter
Rückgabewert
Derselbe value, der übergeben wurde.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
onDisposekeine Funktion ist. ReferenceError-
Wird ausgelöst, wenn der Stack bereits bereinigt wurde.
Beschreibung
Der Hauptzweck von adopt() besteht darin, einen Wert im Stack zu registrieren, der das Disposable-Protokoll nicht implementiert. Wenn der Wert bereits disposable ist, können Sie stattdessen use() verwenden. Diese Methode verwendet automatisch die [Symbol.dispose]()-Methode des Werts zur Bereinigung.
adopt(value, onDispose) entspricht nahezu defer(() => onDispose(value)). Allerdings können Sie damit die Ressource deklarieren und in derselben Zeile registrieren. So ist die Wahrscheinlichkeit möglichst gering, dass zwischen dem Erstellen und dem Registrieren der Ressource ein Fehler auftritt, durch den die Ressource nicht freigegeben wird.
using disposer = new DisposableStack();
const reader = disposer.adopt(stream.getReader(), (reader) =>
reader.releaseLock(),
);
using disposer = new DisposableStack();
const reader = stream.getReader();
// If someone adds code in between these lines and an error occurs,
// the stream will be locked forever.
disposer.defer(() => reader.close());
Damit eine Ressource möglichst unmittelbar nach ihrer Deklaration registriert wird, sollten Sie den Ausdruck zum Anfordern der Ressource stets in adopt() einschließen, statt ihn in eine separate Anweisung auszulagern.
using disposer = new DisposableStack();
const reader = stream.getReader();
disposer.adopt(reader, (reader) => reader.close());
Beispiele
adopt() verwenden
Dieser Code verarbeitet einen ReadableStream über einen ReadableStreamDefaultReader. Der Reader implementiert das Disposable-Protokoll nicht. Daher verwenden wir adopt(), um ihn im Stack zu registrieren.
{
using disposer = new DisposableStack();
const reader = disposer.adopt(stream.getReader(), (reader) =>
reader.releaseLock(),
);
const { value, done } = reader.read();
if (!done) {
// Process the value
}
// The reader.releaseLock() method is called here before exiting
}
Spezifikationen
| Spezifikation |
|---|
| ECMAScript Async Explicit Resource Management # sec-asyncdisposablestack.prototype.adopt |