WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

import — JavaScript-Module importieren

Mit dem Schlüsselwort import werden Exporte aus anderen Modulen verfügbar. Lerne statische Deklarationen und Live-Bindings kennen und erfahre, worin sich import(...), import.meta und gewöhnliche Funktionsaufrufe unterscheiden.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.meta

import ist ein reserviertes Schlüsselwort und kann nicht als Variablenname verwendet werden. Eine statische import-Deklaration ist nur auf der obersten Ebene eines Moduls zulässig, nicht innerhalb einer Funktion oder eines Blocks. Ihr Modulspezifizierer muss ein Zeichenfolgenliteral sein. Statische Importe gehören zum Modulsystem, das mit ECMAScript 2015 eingeführt wurde.

Ein Standardimport wählt den default-Export aus; ein benannter Import wählt einen bestimmten Export aus, und as weist ihm einen lokalen Namen zu. Die Form import * as namespace erstellt eine lokale Bindung an das Modul-Namespace-Objekt. import "module" führt die Abhängigkeit aus, ohne lokale Bindungen zu erstellen. Importierte Bindungen sind live: Sie spiegeln Änderungen im exportierenden Modul wider. Der Importeur kann ihnen keinen neuen Wert zuweisen; das bedeutet jedoch nicht, dass ein importiertes Objekt eingefroren ist.

import(specifier) ist eine separate Syntax für dynamische Importe, die mit ECMAScript 2020 eingeführt wurde, und keine gewöhnliche Funktion. Sie kann in Ausdrücken vorkommen, auch in einem normalen Skript, und gibt ein Promise zurück. Nach erfolgreichem Laden und Auswerten des Moduls wird das Promise normalerweise mit dem Modul-Namespace-Objekt erfüllt. Hat das Modul jedoch einen aufrufbaren Export namens then, wird dieser beim Auflösen des Promise aufgerufen. Das Promise kann deshalb trotz erfolgreicher Modulauswertung mit einem anderen Wert erfüllt oder abgelehnt werden. import.meta, ebenfalls aus ECMAScript 2020, stellt von der Hostumgebung abhängige Metadaten des Moduls bereit und ist nur in Modulen zulässig.

Die Auflösung von Spezifizierern und das Laden von Modulen hängen von der Hostumgebung ab. Weder die Sprachspezifikation allein noch eine erfolgreiche Ausführung in Node.js belegt die Unterstützung in einem bestimmten Browser. Das Beispiel veranschaulicht ein Live-Binding: Der Aufruf von increase() ändert den über count sichtbaren Wert.

Beispiele

// counter.mjs
export let count = 1;
export function increment() {
  count += 1;
}

// main.mjs
import { count, increment as increase } from "./counter.mjs";

console.log(count);
increase();
console.log(count);

Ergebnis

1
2

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen