CKTIS / JavaScript
WritableStream — flux inscriptible
WritableStream met en série l’écriture de blocs de données vers une destination. Les promesses permettent aux producteurs de contrôler leur rythme.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)WritableStream est une API Web définie par le Streams Standard, et non par ECMAScript. Vérifiez sa disponibilité dans l’environnement cible ; Node 24 ne prouve pas sa prise en charge dans les navigateurs.
Callbacks facultatifs de la destination : start(controller) initialise ; write(chunk, controller) écrit séquentiellement après l’initialisation ; close() termine après les écritures ; abort(reason) effectue le nettoyage en cas d’interruption. Une interruption abandonne les écritures en attente au lieu de les terminer.
getWriter() verrouille le flux. Utilisez alors writer.write(), writer.close() et writer.abort() ; stream.close() et stream.abort() sont rejetées tant que le flux est verrouillé. releaseLock() déverrouille le flux sans le fermer.
Attendre write() régule le rythme de production ; writer.ready indique que la contre-pression diminue. La mise en file d’attente seule ne limite pas l’utilisation de la mémoire. Une écriture réussie ne garantit pas un stockage durable.
Exemples
async function main() {
const events = [];
const stream = new WritableStream({
start() { events.push('start'); },
write(chunk) { events.push(`write:${chunk}`); },
close() { events.push('close'); },
abort(reason) { events.push(`abort:${reason}`); }
});
const writer = stream.getWriter();
try {
await writer.write('A');
await writer.write('B');
await writer.close();
} finally {
writer.releaseLock();
}
console.log(events.join(' | '));
}
main().catch(console.error);Résultat
start | write:A | write:B | close
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.