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

CKTIS / JavaScript

ReadableStream.getReader(): четци и заключване на потока

getReader() връща четец и заключва потока. Четенето е асинхронно; releaseLock() освобождава заключването, без да отменя потока.

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

Синтаксис

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

stream.getReader() синхронно връща ReadableStreamDefaultReader. Заключването не позволява да се получи друг четец; опитът предизвиква TypeError.

reader.read() връща promise за резултат { value, done }. done: true означава, че четенето е приключило; отхвърлянето на promise сигнализира за грешка. Освободете заключването с reader.releaseLock() в блок finally. Освобождаването не отменя потока.

stream.getReader({ mode: "byob" }) връща ReadableStreamBYOBReader: read(view) приема изглед към буфер. Режимът BYOB изисква четим поток от байтове, независимо как е създаден. Извикването на getReader() в този режим за поток, който не е поток от байтове, предизвиква TypeError. Опцията type: "bytes" е един от начините за създаване на такъв поток. Тялото на отговор от Fetch, ако не е null, може вече да е четим поток от байтове, без да е необходимо извикващият код да го създава. Самото поставяне на блокове Uint8Array в опашка не е достатъчно.

Това е уеб API на WHATWG, а не функция на конкретно издание на ECMAScript. Проверете поотделно наличността на стандартния четец и BYOB в целевата среда.

Примери

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

Резултат

AB
false

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

Източници