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

CKTIS / JavaScript

ReadableStream — branje podatkov po kosih

ReadableStream omogoča porabo podatkov po kosih. Bralnik jih pridobiva asinhrono, ne da bi bilo treba najprej zbrati celoten vhod.

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

new ReadableStream(underlyingSource?, strategy?)

ReadableStream je del standarda Streams, ne ECMAScript. Privzeti tokovi prenašajo poljubne vrednosti JavaScript; type: "bytes" omogoča branje BYOB v medpomnilnike, ki jih zagotovi porabnik.

Viri uporabljajo enqueue() za dodajanje kosov. close() omogoči, da se čakalna vrsta izprazni; napake povzročijo zavrnitev branj. read() vrne promise za { value, done }.

getReader() zaklene tok za enega bralnika. releaseLock() odklene tok, ne da bi preklical vir. Če je bralnik aktiven, prekliči z reader.cancel(); preklic zavrže čakalno vrsto.

pull() podpira ustvarjanje na zahtevo; brezpogojni klici enqueue() lahko povečajo čakalno vrsto kljub povratnemu pritisku. Preveri podporo v ciljnem okolju; Node 24 ne dokazuje podpore v brskalnikih.

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);
}

main().catch(console.error);

Rezultat

AB

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

Viri