ReadableStreamDefaultReader: releaseLock() Methode

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

* Some parts of this feature may have varying levels of support.

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

Die releaseLock()-Methode der ReadableStreamDefaultReader Schnittstelle löst die Sperre des Readers auf dem Stream.

Wenn der zugehörige Stream fehlerhaft ist, wenn die Sperre gelöst wird, wird der Reader anschließend auf die gleiche Weise fehlerhaft erscheinen; andernfalls wird der Reader als geschlossen erscheinen.

Wird die Sperre des Readers gelöst, während noch ausstehende Leseanforderungen vorliegen, werden die von der Methode ReadableStreamDefaultReader.read() des Readers zurückgegebenen Versprechen sofort mit einem TypeError abgelehnt. Nicht gelesene Chunks verbleiben in der internen Warteschlange des Streams und können später durch das Erwerben eines neuen Readers gelesen werden.

Syntax

js
releaseLock()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Ausgelöst, wenn das Quellobjekt kein ReadableStreamDefaultReader ist.

Beispiele

js
function fetchStream() {
  const reader = stream.getReader();

  // …

  reader.releaseLock();

  // …
}

Spezifikationen

Specification
Streams
# ref-for-default-reader-release-lock②

Browser-Kompatibilität

Siehe auch