Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ReadableStream.getReader(): čitači i zaključavanje toka

getReader() vraća čitač i zaključava tok. Čitanje je asinkrono; releaseLock() oslobađa zaključavanje, ali ne otkazuje tok.

Verzija: 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() sinkrono vraća ReadableStreamDefaultReader. Zaključavanje onemogućuje dobivanje drugog čitača; pokušaj izaziva TypeError.

reader.read() vraća obećanje s rezultatom { value, done }. done: true znači da je čitanje dovršeno; odbijanje obećanja signalizira pogrešku. Oslobodi zaključavanje pomoću reader.releaseLock() u bloku finally. Oslobađanje ne otkazuje tok.

stream.getReader({ mode: "byob" }) vraća ReadableStreamBYOBReader: read(view) prihvaća prikaz međuspremnika. Način rada BYOB zahtijeva čitljiv tok bajtova, bez obzira na to kako je stvoren. Poziv metode getReader() u tom načinu rada na toku koji nije tok bajtova izaziva TypeError. Opcija type: "bytes" jedan je od načina stvaranja takvog toka. Tijelo odgovora dobivenog putem API-ja Fetch, ako nije null, može već biti čitljiv tok bajtova, pa ga pozivajući kôd ne mora sam stvoriti. Samo stavljanje blokova Uint8Array u red nije dovoljno.

Ovo je WHATWG-ov web API, a ne značajka određene edicije ECMAScripta. U ciljnom okruženju zasebno provjeri dostupnost zadanog čitača i BYOB-a.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori