Arbeiten mit Dateideskriptoren in Node.js

Bevor Sie mit einer Datei in Ihrem Dateisystem interagieren können, müssen Sie einen Dateideskriptor erhalten. Ein Dateideskriptor ist eine Referenz auf eine geöffnete Datei, eine Zahl (fd), die durch das Öffnen der Datei mit der Methode open() des fs-Moduls zurückgegeben wird. Diese Zahl (fd) identifiziert eindeutig eine geöffnete Datei im Betriebssystem.

Dateien öffnen

CommonJS (CJS)

const fs = require('node:fs')
fs.open('/Users/joe/test.txt', 'r', (err, fd) => {
  // fd ist unser Dateideskriptor
})

Beachten Sie das 'r', das wir als zweiten Parameter des Aufrufs von fs.open() verwendet haben. Dieses Flag bedeutet, dass wir die Datei zum Lesen öffnen. Andere häufig verwendete Flags sind:

Flag	Beschreibung
'w+'	Dieses Flag öffnet die Datei zum Lesen und Schreiben. Es positioniert den Stream am Anfang der Datei.
'a+'	Dieses Flag öffnet die Datei zum Lesen und Schreiben und positioniert den Stream auch am Ende der Datei.

Sie können die Datei auch mit der Methode fs.openSync öffnen, die den Dateideskriptor zurückgibt, anstatt ihn in einem Callback bereitzustellen:

const fs = require('node:fs')

try {
  const fd = fs.openSync('/Users/joe/test.txt', 'r')
} catch (err) {
  console.error(err)
}

Operationen ausführen

Sobald Sie den Dateideskriptor auf welche Weise auch immer erhalten haben, können Sie alle Operationen ausführen, die ihn erfordern, wie z. B. den Aufruf von fs.close() und viele andere Operationen, die mit dem Dateisystem interagieren.

Verwenden von fsPromises

Sie können die Datei auch mit der promise-basierten Methode fsPromises.open öffnen, die vom Modul fs/promises angeboten wird. Das Modul fs/promises ist erst ab Node.js v14 verfügbar. Vor v14, nach v10, können Sie stattdessen require('fs').promises verwenden. Vor v10, nach v8, können Sie util.promisify verwenden, um fs-Methoden in promise-basierte Methoden umzuwandeln.

ES-Module (MJS)

import fs from 'node:fs/promises'

async function run() {
  const fileHandle = await fs.open('example.txt', 'r')
  try {
    filehandle = await fs.open('/Users/joe/test.txt', 'r')
    console.log(filehandle.fd)
    console.log(await filehandle.readFile({ encoding: 'utf8' }))
  } finally {
    await fileHandle.close()
  }
}

run().catch(console.error)

Beispiel für util.promisify

Hier ist ein Beispiel für die Verwendung von util.promisify, um fs.open in eine Promise-basierte Funktion umzuwandeln:

const fs = require('node:fs')
const util = require('node:util')

const open = util.promisify(fs.open)

open('test.txt', 'r')
  .then(fd => {
    // Dateideskriptor verwenden
  })
  .catch(err => {
    // Fehler behandeln
  })

Weitere Informationen über das fs/promises-Modul finden Sie in der fs/promises API-Dokumentation.