Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

ReadableStream.getReader(): bralniki in zaklep toka

getReader() vrne bralnik in zaklene tok. Branje je asinhrono; releaseLock() sprosti zaklep, ne da bi preklical tok.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

stream.getReader()
stream.getReader({ mode: "byob" })

stream.getReader() sinhrono vrne ReadableStreamDefaultReader. Zaklep preprečuje pridobitev drugega bralnika; poskus sproži TypeError.

reader.read() vrne obljubo z rezultatom { value, done }. done: true pomeni, da je branje končano; zavrnitev obljube nakazuje napako. Zaklep sprosti z reader.releaseLock() v bloku finally. Sprostitev toka ne prekliče.

stream.getReader({ mode: "byob" }) vrne ReadableStreamBYOBReader: read(view) sprejme pogled medpomnilnika. Način BYOB zahteva berljiv bajtni tok, ne glede na to, kako je bil ustvarjen. Klic getReader() v tem načinu na toku, ki ni bajtni, sproži TypeError. Možnost type: "bytes" je eden od načinov za ustvarjanje takega toka. Telo odgovora Fetch, če ni null, je lahko že berljiv bajtni tok, ne da bi ga morala ustvariti klicna koda. Zgolj dodajanje kosov Uint8Array v čakalno vrsto ne zadostuje.

To je spletni API WHATWG, ne funkcija določene izdaje ECMAScript. V ciljnem okolju ločeno preveri razpoložljivost privzetega bralnika in BYOB.

Primeri

async function main() {
  const stream = new ReadableStream({
    start(controller) {
      controller.enqueue("A");
      controller.enqueue("B");
      controller.close();
    }
  });
  const reader = stream.getReader();
  let text = "";
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      text += value;
    }
  } finally {
    reader.releaseLock();
  }
  console.log(text);
  console.log(stream.locked);
}
main().catch(console.error);

Rezultat

AB
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri