Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

WritableStream — flujo escribible

WritableStream serializa la escritura de bloques de datos en un destino. Las promesas permiten a los productores controlar su ritmo.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

new WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)

WritableStream es una API web definida por el Streams Standard, no por ECMAScript. Comprueba su disponibilidad en el entorno de destino; Node 24 no demuestra que sea compatible con los navegadores.

Callbacks opcionales del destino: start(controller) inicializa; write(chunk, controller) escribe secuencialmente después de la inicialización; close() termina después de las escrituras; abort(reason) realiza la limpieza si se interrumpe. La interrupción descarta las escrituras pendientes en lugar de completarlas.

getWriter() bloquea el flujo. Entonces, usa writer.write(), writer.close() y writer.abort(); stream.close() y stream.abort() se rechazan mientras el flujo esté bloqueado. releaseLock() lo desbloquea sin cerrarlo.

Esperar a write() regula el ritmo de producción; writer.ready indica que disminuye la contrapresión. Encolar por sí solo no limita el uso de memoria. Una escritura correcta no garantiza que los datos se almacenen de forma duradera.

Ejemplos

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);

Resultado

start | write:A | write:B | close

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes