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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.