import.meta

Das import.meta Objekt wird von der Host-Umgebung als ein erweiterbares Null-Prototyp Objekt erstellt, bei dem alle Eigenschaften beschreibbar, konfigurierbar und aufzählbar sind. Die Spezifikation gibt keine Eigenschaften vor, die darauf definiert werden müssen, aber Hosts implementieren normalerweise die folgenden Eigenschaften:

url

Die vollständige URL zum Modul, einschließlich Abfrageparametern und/oder Hash (nach dem ? oder #). In Browsern ist dies entweder die URL, von der das Skript bezogen wurde (für externe Skripte) oder die URL des enthaltenen Dokuments (für Inline-Skripte). In Node.js ist dies der Dateipfad (einschließlich des file:// Protokolls).

resolve

Löst einen Modulspezifizierer zu einer URL auf, wobei die aktuelle Modul-URL als Basis verwendet wird.

Die import.meta Syntax besteht aus dem Schlüsselwort import, einem Punkt und dem Bezeichner meta. Da import ein reserviertes Wort ist und kein Bezeichner, handelt es sich hierbei nicht um einen Eigenschafts-Accessor, sondern um eine spezielle Ausdruckssyntax.

Die import.meta Meta-Eigenschaft ist in JavaScript-Modulen verfügbar; die Verwendung von import.meta außerhalb eines Moduls (einschließlich direktem eval() innerhalb eines Moduls) führt zu einem Syntaxfehler.

Die Verwendung von Abfrageparametern im import Spezifizierer ermöglicht die übermittlung modulspezifischer Argumente, die möglicherweise komplementär zur Lektüre von Parametern aus der anwendungsweiten window.location (oder in Node.js über process.argv) sind. Zum Beispiel mit dem folgenden HTML:

<script type="module">
  import "./index.mjs?someURLInfo=5";
</script>

Das index.mjs Modul kann den someURLInfo Parameter über import.meta abrufen:

// index.mjs
new URL(import.meta.url).searchParams.get("someURLInfo"); // 5

Dasselbe gilt, wenn ein Modul ein anderes importiert:

// index.mjs
import "./index2.mjs?someURLInfo=5";

// index2.mjs
new URL(import.meta.url).searchParams.get("someURLInfo"); // 5

Die ES-Modul-Implementierung in Node.js unterstützt die Auflösung von Modulspezifizierern, die Abfrageparameter (oder den Hash) enthalten, wie im zuletzt genannten Beispiel. Sie können jedoch keine Abfragen oder Hashes verwenden, wenn das Modul über den CLI-Befehl angegeben wird (wie node index.mjs?someURLInfo=5), da der CLI-Einstiegspunkt einen eher CommonJS-ähnlichen Auflösungsmodus verwendet, der den Pfad als Dateipfad statt als URL behandelt. Um Parameter an das Einstiegspunktmodul zu übergeben, verwenden Sie CLI-Argumente und lesen Sie sie mittels process.argv (wie node index.mjs --someURLInfo=5).

In Node.js CommonJS-Modulen gibt es eine __dirname-Variable, die den absoluten Pfad zum Ordner enthält, der das aktuelle Modul enthält, was zur Auflösung relativer Pfade nützlich ist. ES-Module können jedoch keine kontextbezogenen Variablen haben, außer import.meta. Daher können Sie zur Auflösung einer relativen Datei import.meta.url verwenden. Beachten Sie, dass hierbei URLs statt Dateisystempfaden verwendet werden.

Vorher (CommonJS):

const fs = require("fs/promises");
const path = require("path");

const filePath = path.join(__dirname, "someFile.txt");
fs.readFile(filePath, "utf8").then(console.log);

Nachher (ES-Module):

import fs from "node:fs/promises";

const fileURL = new URL("./someFile.txt", import.meta.url);
fs.readFile(fileURL, "utf8").then(console.log);

• import
• export