Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

WritableStream — fluxo gravável

WritableStream serializa a escrita de blocos de dados para um destino. As promessas permitem aos produtores controlar o seu ritmo.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

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

WritableStream é uma API Web definida pelo Streams Standard, não pelo ECMAScript. Verifique a disponibilidade no ambiente de destino; o Node 24 não comprova o suporte nos navegadores.

Callbacks opcionais do destino: start(controller) inicializa; write(chunk, controller) escreve sequencialmente após a inicialização; close() termina depois das escritas; abort(reason) limpa em caso de interrupção. A interrupção descarta as escritas pendentes em vez de as concluir.

getWriter() bloqueia o fluxo. Nesse caso, use writer.write(), writer.close() e writer.abort(); stream.close() e stream.abort() são rejeitadas enquanto o fluxo estiver bloqueado. releaseLock() desbloqueia o fluxo sem o fechar.

Aguardar por write() regula o ritmo de produção; writer.ready assinala que a contrapressão diminuiu. A simples colocação em fila não limita a utilização de memória. Uma escrita bem-sucedida não garante o armazenamento duradouro dos dados.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes