CKTIS / JavaScript
TransformStream: transform, flush i controller.enqueue
Obrađuj ulazne dijelove s pomoću `transform()`, šalji rezultate kroz `controller.enqueue()` i pri redovitom zatvaranju isprazni međuspremnik s pomoću `flush()`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 povezuje ulaznu stranu (writable) s izlaznom stranom (readable). Konstruktor prihvaća neobavezni objekt transformer. Sljedeća dva neobavezna argumenta određuju strategije redova čekanja, prvo za pisanje, a zatim za čitanje. To je dio sučelja Web Streams API, a ne ECMAScripta 2024; provjeri podršku u ciljnom izvršnom okruženju.
transform(chunk, controller) poziva se za svaki ulazni dio kada je spreman za obradu. Za slanje nijednog, jednog ili više izlaznih dijelova pozovi controller.enqueue(chunk) odgovarajući broj puta na primljenom objektu TransformStreamDefaultController. Povratna vrijednost funkcije nije izlaz. Bez transform() dijelovi prolaze nepromijenjeni.
Neobavezni flush(controller) poziva se pri redovitom zatvaranju strane za pisanje, nakon uspješne obrade svih ulaznih dijelova. Može poslati sadržaj preostao u međuspremniku prije nego što API zatvori stranu za čitanje; nije funkcija za čišćenje pri otkazivanju ili prekidu. API čeka obećanje koje vrati bilo koja od tih funkcija. Iznimka ili odbijeno obećanje dovodi tok u stanje pogreške, stoga uključi asinkroni rad u obećanje koje vraćaš.
enqueue() predaje dio strani za čitanje, vraća undefined i baca TypeError ako ta strana više ne prihvaća dijelove. Ne čeka potrošača. Povratni pritisak (backpressure) može odgoditi obradu kasnijih pisanja, ali ne postavlja čvrstu granicu broja poziva enqueue() unutar iste povratne funkcije. Poveži potrošača prije nego što počneš čekati dovršetak pisanja.
Primjeri
(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));Rezultat
[[1,2],[3]]
Prema zadanim postavkama `pipeThrough()` prenosi redovito zatvaranje izvora na stranu transformacije za pisanje, dok `pipeTo()` preuzima izlaz čim stigne. `transform()` šalje par `[1,2]`, a `flush()` preostali element kao `[3]`.
Povezane lekcije
- JavaScript · Lekcija 4 · Napredno · Verzija: 4