37.lendo_arquivos_com_o_node.md

Lendo arquivos com o Node.js

A maneira mais simples de ler um arquivo em Node.js é usar o método fs.readFile(), passando para ele o caminho do arquivo, a codificação e uma função de callback que será chamada com os dados do arquivo (e o erro):

const fs = require('fs');

fs.readFile('/Users/joe/test.txt', 'utf8', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }
  console.log(data);
});

Como alternativa, você pode usar a versão síncrona fs.readFileSync():

const fs = require('fs');

try {
  const data = fs.readFileSync('/Users/joe/test.txt', 'utf8');
  console.log(data);
} catch (err) {
  console.error(err);
}

Você também pode usar o método fsPromises.readFile() baseado em promise oferecido pelo módulo fs/promises:

const fs = require('fs/promises');

async function example() {
  try {
    const data = await fs.readFile('/Users/joe/test.txt', { encoding: 'utf8' });
    console.log(data);
  } catch (err) {
    console.log(err);
  }
}
example();

Todos os três fs.readFile(), fs.readFileSync() e fsPromises.readFile() leem o conteúdo completo do arquivo na memória antes de retornar os dados.

Isso significa que arquivos grandes terão um grande impacto no consumo de memória e na velocidade de execução do programa.

Nesse caso, a melhor opção é ler o conteúdo do arquivo usando streams.