CKTIS / JavaScript
TransformStream — przekształcanie strumienia
TransformStream łączy stronę zapisywalną i odczytywalną. transform przetwarza porcje danych, a flush może dopisać wynik końcowy przed zamknięciem.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new TransformStream({ transform(chunk, controller) { /* controller.enqueue(value) */ }, flush(controller) { /* optional final output */ } }, writableStrategy, readableStrategy)TransformStream to Web API z WHATWG Streams Standard, nie funkcja definiowana przez ECMAScript. Udostępnia writable i readable; pipeThrough() łączy je z potokiem.
transform(chunk, controller) przetwarza porcje kolejno. TransformStreamDefaultController.enqueue, wywoływane jako controller.enqueue(value), emituje wynik; samo zwrócenie wartości go nie emituje. Jedna porcja może dać zero lub wiele wyników. Bez transform porcje przechodzą bez zmian.
flush(controller) działa po przetworzeniu wszystkich porcji przy prawidłowym zamykaniu, nie jako uniwersalne sprzątanie po błędzie. Może emitować końcówkę. Oba wywołania zwrotne mogą zwracać Promise; ich wyjątki lub odrzucenia powodują błąd obu stron.
Przeciwciśnienie ogranicza kolejne zapisy: odczyt musi postępować równolegle. Przykład używa pipeTo(). Dostępność API sprawdź w docelowej przeglądarce; Node 24 nie dowodzi jej obsługi.
Przykłady
async function main() {
const source = new ReadableStream({
start(controller) {
controller.enqueue(2);
controller.enqueue(3);
controller.close();
}
});
let total = 0;
const double = new TransformStream({
transform(chunk, controller) {
total += chunk;
controller.enqueue(chunk * 2);
},
flush(controller) {
controller.enqueue(`sum=${total}`);
}
});
const output = [];
await source.pipeThrough(double).pipeTo(new WritableStream({
write(chunk) {
output.push(chunk);
}
}));
console.log(JSON.stringify(output));
}
main().catch(console.error);Wynik
[4,6,"sum=5"]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.