ReadableStreamBYOBReader: releaseLock() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die releaseLock()-Methode des ReadableStreamBYOBReader-Interfaces gibt die Sperre des Readers auf dem Stream frei. Nachdem die Sperre gelöst wurde, ist der Reader nicht mehr aktiv.

Der Reader erscheint als fehlerhaft, wenn der zugehörige Stream fehlerhaft ist, wenn die Sperre freigegeben wird; andernfalls erscheint der Reader als geschlossen.

Wenn die Sperre des Readers freigegeben wird, während er noch ausstehende Leseanfragen hat, werden die Versprechen, die von der ReadableStreamBYOBReader.read()-Methode des Readers zurückgegeben werden, sofort mit einem TypeError abgelehnt. Ungelesene Chunks verbleiben in der internen Warteschlange des Streams und können später durch das Erhalten eines neuen Readers gelesen werden.

Syntax

js
releaseLock()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn das Quellobjekt kein ReadableStreamBYOBReader ist.

Beispiele

Ein triviales Beispiel wird unten gezeigt. Eine Sperre wird erstellt, sobald der Reader auf dem Stream erstellt wird.

js
const reader = stream.getReader({ mode: "byob" });
reader.releaseLock();

Spezifikationen

Specification
Streams Standard
# ref-for-byob-reader-release-lock②

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch