Método Node.js Stream readable.read()

El método readable.read() es una interfaz de programación de aplicaciones incorporada del módulo Stream que se utiliza para leer los datos del búfer interno. Devuelve datos como un objeto de búfer si no se especifica codificación o si la secuencia funciona en modo objeto.

Sintaxis:

readable.read( size )

Parámetros: este método acepta un tamaño de parámetro único que especifica el número de bytes que se leerán del búfer interno.

Valor de retorno: si se usa este método, los datos leídos después de este método se muestran en la salida y si no existen datos en el búfer, se devuelve un valor nulo.

Los siguientes ejemplos ilustran el uso del método readable.read() en Node.js:

Ejemplo 1:

// Node.js program to demonstrate the     
// readable.read() method  
   
// Include fs module
const fs = require("fs");
   
// Constructing readable stream
const readable = fs.createReadStream("input.txt");
   
// Instructions for reading data
readable.on('readable', () => {
  let chunk;
   
  // Using while loop and calling
  // read method
  while (null !== (chunk = readable.read())) {
   
    // Displaying the chunk
    console.log(`read: ${chunk}`);
  }
});
console.log("done");

Producción:

done
read: hello

Aquí, en el ejemplo anterior, los datos leídos del búfer son ‘hola’, por lo que se devuelven.

Ejemplo 2:

// Node.js program to demonstrate the     
// readable.read() method  
  
// Include fs module
const fs = require("fs");
  
// Constructing readable stream
const readable = fs.createReadStream("input.txt");
  
// Instructions for reading data
readable.on('readable', () => {
  let chunk;
  
  // Using while loop and calling
  // read method with parameter
  while (null !== (chunk = readable.read(1))) {
  
    // Displaying the chunk
    console.log(`read: ${chunk}`);
  }
});
console.log("done");

Producción:

done
read: h
read: e
read: l
read: l
read: o

En el ejemplo anterior, se indica el tamaño de los datos, por lo que solo se lee un byte en cada paso del archivo «input.txt» que contiene los datos ‘hola’.

Referencia: https://nodejs.org/api/stream.html#stream_readable_read_size