import.meta

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

url

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

resolve

Löst einen Modulspezifizierer in eine URL auf, indem die URL des aktuellen Moduls 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, kein Bezeichner, ist dies kein Property Accessor, sondern eine spezielle Ausdrücksyntax.

Die import.meta Metaeigenschaft ist in JavaScript-Modulen verfügbar; die Verwendung von import.meta außerhalb eines Moduls (einschließlich von direktem eval() innerhalb eines Moduls) verursacht einen Syntaxfehler.

Die Verwendung von Abfrageparametern im import Spezifizierer ermöglicht die modulspezifische Argumentübergabe, welche die Leseparameter von der anwendungsweiten window.location (oder in Node.js, durch process.argv) ergänzen kann. 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

Das Gleiche 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-Modulimplementierung in Node.js unterstützt das Auflösen von Modulspezifizierern, die Abfrageparametern (oder den Hash) enthalten, wie im letzten 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 eine eher CommonJS-ähnliche Auflösungsweise verwendet und den Pfad als Dateipfad anstatt als URL behandelt. Um Parameter an das Einstiegspunktmodul zu übergeben, verwenden Sie CLI-Argumente und lesen Sie diese über process.argv (wie node index.mjs --someURLInfo=5).

In Node.js CommonJS-Modulen gibt es eine __dirname Variable, die den absoluten Pfad zu dem Ordner enthält, der das aktuelle Modul enthält, was nützlich zum Auflösen relativer Pfade ist. Allerdings können ES-Module keine kontextuellen Variablen außer import.meta haben. Daher können Sie, um eine relative Datei aufzulösen, import.meta.url verwenden. Beachten Sie, dass dies URLs anstelle von Dateisystempfaden verwendet.

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