Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources