CKTIS / JavaScript
TransformStream: transform, flush a controller.enqueue
Spracúvajte vstupné bloky v `transform()`, odovzdávajte výsledky cez `controller.enqueue()` a pri riadnom zatvorení vyprázdnite vyrovnávaciu pamäť pomocou `flush()`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new TransformStream()
new TransformStream(transformer)
new TransformStream(transformer, writableStrategy)
new TransformStream(transformer, writableStrategy, readableStrategy)
// Optional transformer methods:
transform(chunk, controller)
flush(controller)
// Output from either method:
controller.enqueue(chunk)TransformStream spája stranu na zápis (writable), ktorá prijíma vstup, so stranou na čítanie (readable), ktorá poskytuje výstup. Konštruktor prijíma voliteľný objekt transformer. Nasledujúce dva voliteľné argumenty určujú stratégie zaraďovania do frontu, najskôr na zápis, potom na čítanie. Ide o súčasť rozhrania Web Streams API, nie ECMAScriptu 2024; overte podporu v cieľovom prostredí.
transform(chunk, controller) sa volá pre každý vstupný blok, keď je pripravený na spracovanie. Ak chcete odovzdať nula, jeden alebo viac výstupných blokov, zavolajte controller.enqueue(chunk) zodpovedajúci počet ráz na odovzdanom objekte TransformStreamDefaultController. Návratová hodnota funkcie nie je výstupom. Bez transform() prechádzajú bloky bezo zmeny.
Voliteľná metóda flush(controller) sa volá pri riadnom zatváraní strany na zápis, až po úspešnom spracovaní všetkých vstupných blokov. Môže odovzdať zvyšné dáta z vyrovnávacej pamäte predtým, než API zatvorí stranu na čítanie; nie je to funkcia na upratovanie pri zrušení ani prerušení. API čaká na prísľub vrátený ktoroukoľvek z týchto metód. Výnimka alebo zamietnutý prísľub uvedie prúd do chybového stavu, preto zahrňte asynchrónnu prácu do vracaného prísľubu.
enqueue() odovzdá blok strane na čítanie, vráti undefined a vyvolá TypeError, ak táto strana už neprijíma bloky. Nečaká na odberateľa. Spätný tlak (backpressure) môže oddialiť spracovanie ďalších zápisov, ale neurčuje pevný limit počtu volaní enqueue() v rámci jedného volania funkcie transform() alebo flush(). Pripojte odberateľa skôr, než začnete čakať na dokončenie zápisov.
Príklady
(async () => {
const input = new ReadableStream({
start(sourceController) {
for (const value of [1, 2, 3]) sourceController.enqueue(value);
sourceController.close();
},
});
let pending = [];
const pairs = new TransformStream({
transform(chunk, controller) {
pending.push(chunk);
if (pending.length === 2) {
controller.enqueue(pending);
pending = [];
}
},
flush(controller) {
if (pending.length > 0) controller.enqueue(pending);
},
});
const output = [];
await input.pipeThrough(pairs).pipeTo(new WritableStream({
write(chunk) {
output.push(chunk);
},
}));
console.log(JSON.stringify(output));
})().catch((error) => console.error(error));Výsledok
[[1,2],[3]]
V predvolenom nastavení `pipeThrough()` prenesie riadne zatvorenie zdroja na stranu transformácie určenú na zápis, kým `pipeTo()` priebežne odoberá výstup. `transform()` odovzdá dvojicu `[1,2]` a `flush()` odovzdá zvyšný prvok ako `[3]`.
Súvisiace lekcie
- JavaScript · Lekcia 4 · Pokročilá · Verzia: 4