Tutoriales de Informática y Dispositivos Móviles
Tutoriales de Informática y Dispositivos Móviles
Javascript

Métodos de la clase Stream JavaScript

La API de Streams en JavaScript permite procesar fragmentos de datos (chunks) de manera secuencial y eficiente, ya sea en el navegador (Web Streams API) o en entornos de servidor como Node.js. En lugar de cargar un archivo o una respuesta de red completa en la memoria RAM, los streams permiten leer, escribir o transformar los datos sobre la marcha.

A continuación, repasamos los métodos y conceptos fundamentales de las clases principales que componen el estándar moderno de streams.

1. ReadableStream (Lectura de datos)

Representa una fuente de datos de lectura controlada. Se utiliza comúnmente para procesar respuestas de red (fetch), lectura de archivos o flujos de datos en tiempo real.

Métodos principales:

  • getReader(): Crea un lector (reader) y bloquea el stream para lectura exclusiva. Devuelve un objeto con métodos para consumir los datos.

  • pipeTo(destination): Conecta el ReadableStream directamente a un WritableStream de destino, gestionando automáticamente la propagación de errores y el cierre.

  • pipeThrough(transform): Pasa el stream a través de un TransformStream para modificar los datos y devuelve un nuevo stream legible con el resultado transformado.

  • cancel(reason): Cancela el flujo de lectura, indicando que la fuente ya no es necesaria.

Ejemplo de uso con un lector:

JavaScript

async function leerStreamDeRed(url) {
  const response = await fetch(url);
  const reader = response.body.getReader();
  
  let recibido = 0;
  
  while (true) {
    const { done, value } = await reader.read();
    
    if (done) {
      console.log("Lectura completada.");
      break;
    }
    
    recibido += value.length;
    console.log(`Recibidos ${recibido} bytes...`);
  }
}

2. WritableStream (Escritura de datos)

Proporciona un destino estándar para escribir datos de forma controlada. Permite enviar flujos hacia archivos, bases de datos o conexiones de red.

Métodos principales:

  • getWriter(): Obtiene un escritor (writer) para empezar a enviar fragmentos de datos al stream.

  • abort(reason): Señala que se ha producido un error y que el flujo debe detenerse abruptamente, descartando los datos pendientes.

  • close(): Cierra ordenadamente el flujo de escritura una vez que se han enviado todos los datos.

Ejemplo de uso con un escritor:

JavaScript

const streamEscritura = new WritableStream({
  write(chunk) {
    // Código para procesar o guardar cada fragmento recibido
    console.log("Escribiendo fragmento:", chunk);
  },
  close() {
    console.log("Escritura finalizada con éxito.");
  },
  abort(err) {
    console.error("Error durante la escritura:", err);
  }
});

const writer = streamEscritura.getWriter();
await writer.write("Hola, ");
await writer.write("Mundo!");
await writer.close();

3. TransformStream (Transformación de datos)

Actúa como un puente intermedio (pipe). Recibe datos desde un origen, aplica una función de transformación a cada fragmento y los pasa a un destino legible. Es ideal para tareas como compresión, cifrado o conversión de formatos (por ejemplo, de texto plano a JSON).

Constructor y métodos clave:

Un TransformStream combina internamente un readable y un writable. Se instancia pasando un objeto con la lógica de transformación en su método transform:

JavaScript

const transformarAMayusculas = new TransformStream({
  transform(chunk, controller) {
    // Transformamos el fragmento recibido y lo enviamos al flujo de salida
    const transformado = chunk.toUpperCase();
    controller.enqueue(transformado);
  }
});

// Uso encadenado con pipeThrough
const textoOriginal = new Response("hola javascript").body;
const textoMayusculas = textoOriginal
  .pipeThrough(new TextDecoderStream())
  .pipeThrough(transformarAMayusculas);

Resumen de tuberías (Piping)

Una de las mayores ventajas de la API moderna de Streams es la capacidad de encadenar operaciones de forma limpia y eficiente utilizando pipeTo y pipeThrough, evitando callbacks complejos y gestionando la contrapresión (backpressure) de manera nativa:

JavaScript

// Origen -> Transformación -> Destino
await origenStream
  .pipeThrough(filtroTransformStream)
  .pipeTo(destinoWritableStream);

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.

Translate »