База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

ReadableStream — четене на данни на части

ReadableStream позволява данните да се обработват на части. Четецът ги получава асинхронно, без първо да е необходимо да се събере целият вход.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new ReadableStream(underlyingSource?, strategy?)

ReadableStream е част от Streams Standard, а не от ECMAScript. Потоците по подразбиране пренасят произволни JavaScript стойности; type: "bytes" позволява BYOB четене в буфери, предоставени от потребителя.

Източниците използват enqueue() за добавяне на части. close() позволява опашката да се изпразни; грешките водят до отхвърляне на операциите за четене. read() връща promise за { value, done }.

getReader() заключва потока за един четец. releaseLock() отключва потока, без да отменя източника. При активен четец отменяйте чрез reader.cancel(); отмяната изхвърля опашката.

pull() поддържа генериране според търсенето; безусловното извикване на enqueue() може да увеличава опашката въпреки обратното налягане. Проверете поддръжката в целевата среда; Node 24 не доказва поддръжка в браузъри.

Примери

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

Резултат

AB

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници