CKTIS / JavaScript
TransformStream: transform, flush и controller.enqueue
Обработвай входните части с `transform()`, подавай резултата чрез `controller.enqueue()` и освобождавай остатъка от буфера с `flush()` при нормално затваряне.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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 свързва входна страна (writable) с изходна страна (readable). Конструкторът приема незадължителен обект transformer. Следващите два незадължителни аргумента задават стратегиите за опашките, първо за запис, после за четене. Това е част от Web Streams API, а не от ECMAScript 2024; провери дали целевата среда за изпълнение го поддържа.
transform(chunk, controller) се извиква за всяка входна част, когато тя е готова за обработка. За да подадеш нула, една или няколко изходни части, извикай controller.enqueue(chunk) съответния брой пъти върху получения TransformStreamDefaultController. Върнатата от функцията стойност не е изход. Без transform() частите преминават непроменени.
Незадължителният метод flush(controller) се извиква при нормално затваряне на страната за запис, след като всички входни части са обработени успешно. Той може да подаде остатъка от буфера, преди API да затвори страната за четене; не е функция за почистване при отмяна или прекъсване. API изчаква обещанието, върнато от която и да е от двете функции. Изключение или отхвърлено обещание поставя потока в състояние на грешка, затова включи асинхронната работа в обещанието, което връщаш.
enqueue() подава част към страната за четене, връща undefined и хвърля TypeError, ако тази страна вече не приема части. Методът не изчаква потребителя. Обратният натиск (backpressure) може да забави обработката на следващите записи, но не налага твърдо ограничение на броя извиквания на enqueue() в една функция за обратно извикване. Свържи потребител, преди да започнеш да чакаш записите да приключат.
Примери
(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));Резултат
[[1,2],[3]]
По подразбиране `pipeThrough()` предава нормалното затваряне на източника към страната за запис на трансформацията, а `pipeTo()` приема изхода при постъпването му. `transform()` подава двойката `[1,2]`, а `flush()` подава останалия елемент като `[3]`.
Свързани уроци
- JavaScript · Урок 4 · Напреднало · Версия: 4