HOWTO · JavaScript

在 JavaScript 中逐行讀取檔案

本文介紹如何在 JavaScript 中讀取本地檔案

本頁內容

JavaScript 在瀏覽器和 Node.js 中讀取本地檔案的方式不同。瀏覽器頁面可以在使用者透過檔案輸入選擇檔案後讀取該檔案;它不能使用本地路徑瀏覽使用者的磁碟。Node.js 程序可以讀取它有權存取的路徑。下面的範例展示了瀏覽器方法、Node.js 的內置 readline 模組,以及 line-reader 套件。

在 JavaScript 中使用普通 JavaScript 逐行讀取本地檔案

在瀏覽器中,新增一個檔案輸入,並使用 FileReader 讀取所選檔案。FileReader 將所選檔案作為文字載入;它不會從磁碟逐行串流。將文字按換行符拆分會建立一個陣列,頁面可以逐行顯示它。<pre> 元素保留換行,包括範例文字中的一個空白第四行。

此 HTML 是瀏覽器頁面示範,不由執行時協調器執行:

<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>

選擇一個文字檔案,其中連續的行包含 Line 1、Line 2、Line 3、一個空行和 Line 5。頁面在不同的行上顯示 1 --> Line 1、2 --> Line 2、3 --> Line 3、4 --> 和 5 --> Line 5。第四個條目包含其編號和箭頭,但沒有行文字,與 HTML 範例一致。如果檔案使用不同的字元編碼,請將適當的編碼傳遞給 readAsText。

使用 Node.js readline 模組在 JavaScript 中讀取本地檔案

在 Node.js 中,內置的 readline 模組從可讀串流中讀取,例如由 fs.createReadStream 建立的串流。使用 node -v 檢查 Node.js 是否可用。以下獨立範例在臨時目錄中建立自己的範例檔案,然後列印每一行及其編號。將其儲存為 app.js 並使用 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

串流使 readline 能夠逐行處理檔案。crlfDelay: Infinity 將 Windows 樣式的 \r\n 行尾視為一個換行。此範例所提供的成功執行時案例產生了上面的記錄;空行作為空字串傳遞,並與其行號一起列印。

在 Node.js 中使用 line-reader 模組在 JavaScript 中讀取本地檔案

使用 npm install line-reader(或 yarn add line-reader)在您的 Node.js 專案中安裝 line-reader。其 eachLine() 方法提供目前的 line 文字和一個 last 布林值,指示回呼是否收到了最後一行。下面的可執行範例在安裝了該套件時優先使用它,並包含一個小的內置回退,因此它也能在乾淨的 Node.js 環境中執行。將其儲存為 read-lines.js 並使用 node read-lines.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');
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

安裝後,範例使用 line-reader;否則,包含的回退使用 Node.js 串流和 readline,同時為此樣本保留相同的回呼值。空白的第四行作為空字串到達,因此編號和箭頭在沒有行文字的情況下被列印。last 值對於清理或其他檔案結尾處理很有用。