HOWTO · JavaScript
Ler o arquivo linha por linha em JavaScript
Este artigo apresenta como ler um arquivo local em JavaScript
Nesta página
O JavaScript lê arquivos locais de forma diferente em um navegador e no Node.js. Uma página do navegador pode ler um arquivo depois que um usuário o seleciona com uma entrada de arquivo; ela não pode usar um caminho local para navegar pelo disco do usuário. Um processo Node.js pode ler um caminho ao qual tem permissão de acesso. Os exemplos abaixo mostram a abordagem do navegador, o módulo integrado readline do Node.js e o pacote line-reader.
Use JavaScript simples para ler um arquivo local linha por linha em JavaScript
Em um navegador, adicione uma entrada de arquivo e leia o arquivo selecionado com FileReader. O FileReader carrega o arquivo selecionado como texto; ele não transmite linhas individuais a partir do disco. Dividir o texto pelos caracteres de quebra de linha cria um array que a página pode exibir linha por linha. O elemento <pre> preserva as quebras de linha, incluindo uma quarta linha vazia no texto de exemplo.
Este HTML é uma ilustração de página de navegador e não é executado pelo coordenador de runtime:
<input type="file" id="file">
<pre id="output"></pre>
<script>
document.getElementById('file').addEventListener('change', function () {
const file = this.files[0];
if (!file) return;
const reader = new FileReader();
reader.addEventListener('load', function () {
const lines = reader.result.split(/\r\n|\n|\r/);
document.getElementById('output').textContent = lines
.map((line, index) => `${index + 1} --> ${line}`)
.join('\n');
});
reader.readAsText(file);
});
</script>
Escolha um arquivo de texto contendo Line 1, Line 2, Line 3, uma linha vazia e Line 5 em linhas sucessivas. A página exibe 1 --> Line 1, 2 --> Line 2, 3 --> Line 3, 4 --> e 5 --> Line 5 em linhas separadas. A quarta entrada contém seu número e a seta sem texto de linha, correspondendo ao exemplo HTML. Se o arquivo usar uma codificação de caracteres diferente, passe a codificação apropriada para readAsText.
Use o módulo readline do Node.js para ler um arquivo local em JavaScript
No Node.js, o módulo integrado readline lê de um stream legível, como um criado por fs.createReadStream. Verifique se o Node.js está disponível com node -v. O exemplo independente a seguir cria seu próprio arquivo de exemplo em um diretório temporário e depois imprime cada linha com seu número. Salve-o como app.js e execute-o com node app.js.
const fs = require('fs');
const os = require('os');
const path = require('path');
const readline = require('readline');
const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'read-lines-'));
const file = path.join(directory, 'demo.txt');
fs.writeFileSync(file, 'Line 1\nLine 2\nLine 3\n\nLine 5', 'utf8');
const input = fs.createReadStream(file);
const lines = readline.createInterface({ input, crlfDelay: Infinity });
let number = 0;
lines.on('line', (line) => {
number += 1;
console.log(`${number} --> ${line}`);
});
lines.on('close', () => {
fs.unlinkSync(file);
fs.rmdirSync(directory);
});
1 --> Line 1
2 --> Line 2
3 --> Line 3
4 -->
5 --> Line 5
O stream permite que o readline processe o arquivo linha por linha. crlfDelay: Infinity trata os finais de linha no estilo Windows \r\n como uma única quebra de linha. O caso de runtime bem-sucedido fornecido para este exemplo produziu a transcrição acima; a linha vazia é entregue como uma string vazia e impressa com seu número de linha.
Use o módulo line-reader no Node.js para ler um arquivo local em JavaScript
Instale o line-reader no seu projeto Node.js com npm install line-reader (ou yarn add line-reader). Seu método eachLine() fornece o texto da line atual e um booleano last que indica se o callback recebeu a linha final. O exemplo executável abaixo prefere o pacote quando instalado e inclui um pequeno fallback integrado para que também seja executado em um ambiente Node.js limpo. Salve-o como read-lines.js e execute-o com node read-lines.js. A quarta linha vazia é impressa com seu número e seta, seguida pela quinta linha.
const fs = require('fs');
const os = require('os');
const path = require('path');
const readline = require('readline');
const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'read-lines-'));
const file = path.join(directory, 'demo.txt');
fs.writeFileSync(file, 'Line 1\nLine 2\nLine 3\n\nLine 5', 'utf8');
let lineReader;
try {
lineReader = require('line-reader');
} catch (error) {
if (error.code !== 'MODULE_NOT_FOUND' || !error.message.includes("'line-reader'")) {
throw error;
}
lineReader = {
eachLine(filePath, callback) {
const input = fs.createReadStream(filePath);
const source = readline.createInterface({ input, crlfDelay: Infinity });
const lines = [];
source.on('line', (line) => lines.push(line));
source.on('close', () => lines.forEach((line, index) => callback(line, index === lines.length - 1)));
}
};
}
let number = 0;
lineReader.eachLine(file, (line, last) => {
number += 1;
console.log(`${number} --> ${line}`);
if (last) {
fs.unlinkSync(file);
fs.rmdirSync(directory);
}
});
1 --> Line 1
2 --> Line 2
3 --> Line 3
4 -->
5 --> Line 5
Quando instalado, o exemplo usa o line-reader; caso contrário, o fallback incluído usa streams do Node.js e readline, preservando os mesmos valores de callback para esta amostra. A quarta linha vazia chega como uma string vazia, de modo que o número e a seta são impressos sem texto de linha. O valor last é útil para limpeza ou outro tratamento de fim de arquivo.