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 June 2022.

* 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 das Lock des Readers auf dem Stream.

Wenn der zugehörige Stream beim Freigeben des Locks fehlerhaft ist, wird der Reader in gleicher Weise als fehlerhaft erscheinen; andernfalls wird der Reader als geschlossen erscheinen.

Wenn das Lock des Readers freigegeben wird, während er noch ausstehende Leseanforderungen hat, werden die von der ReadableStreamDefaultReader.read()-Methode des Readers zurückgegebenen Versprechen sofort mit einem TypeError abgelehnt. Ungelesene Stücke verbleiben in der internen Warteschlange des Streams und können später durch Erwerben eines neuen Readers gelesen werden.

Syntax

js
releaseLock()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird 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

BCD tables only load in the browser

Siehe auch