CKTIS / JavaScript
Modulladen und Code-Splitting
Module bilden einen Abhängigkeitsgraphen. Ein statischer Import deklariert eine Abhängigkeit, während `import()` es ermöglicht, zur Laufzeit ein Modul anzufordern. Die Aufteilung von Code in separat geladene Teile hängt von der Umgebung und den Werkzeugen ab, nicht allein von der JavaScript-Syntax.
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
// module.mjs
export const name = value;
// main.mjs
import { name } from "./module.mjs";
async function main() {
const namespace = await import("./module.mjs");
}
main().catch(console.error);Zum Laden von Modulen gehören das Abrufen eines Moduls und seiner Abhängigkeiten, das Verknüpfen von Importen mit Exporten und das Ausführen des Codes. Statische import-Deklarationen stehen auf der obersten Ebene eines Moduls; sie legen Abhängigkeiten fest, bevor der Modulcode ausgeführt wird. Importierte Namen sind Live-Bindings zu Exporten und keine Kopien ihrer Werte.
Dynamisches import(specifier) ist ein Ausdruck, der auch in gewöhnlichen Skripten sowie innerhalb von Bedingungen oder Funktionen verwendet werden kann. Es gibt ein Promise zurück, das nach erfolgreichem Laden, Verknüpfen und Ausführen normalerweise mit dem Modul-Namespace-Objekt erfüllt wird, das die Exporte enthält. Exportiert das Modul jedoch unter dem Namen then einen aufrufbaren Wert, ruft die Promise-Auflösung diesen Wert mit Funktionen zum Auflösen und Ablehnen auf. Der Ausgang des Promise hängt dann von diesem Aufruf ab; es muss nicht mit dem Namespace-Objekt erfüllt werden. Behandle eine Ablehnung mit try/catch um await oder mit .catch(). Das Argument kann zur Laufzeit berechnet werden.
Code-Splitting bedeutet, eine Anwendung in separat ladbare Teile aufzuteilen. import() bietet einen Ladepunkt für bedarfsgeladenen Code, aber ECMAScript schreibt weder separate Ausgabedateien noch Netzwerkanfragen vor. Die Auflösung von Specifiern und das Abrufen von Modulen hängen von der Host-Umgebung ab; die Aufteilung der Ausgabedateien hängt von den Werkzeugen ab. Ein erneuter Import desselben aufgelösten Moduls führt dessen Code nicht erneut aus. Ohne einen aufrufbaren Export namens then liefern beide erfolgreichen dynamischen Importe dasselbe Namespace-Objekt.
Statische Module wurden mit ES2015 eingeführt, import() mit ES2020. Dies ist keine Browser-Kompatibilitätstabelle: Die Sprachspezifikation garantiert keine Unterstützung in einem bestimmten Browser, und Node 24 belegt keine Unterstützung von Web APIs. Im Beispiel ist main.mjs der Einstiegspunkt, und beide import()-Aufrufe beziehen sich auf dasselbe lokale Modul math.mjs. Nur dieses Modul wird dynamisch geladen. Das Beispiel zeigt kein Code-Splitting durch einen Bundler.
Beispiele
// math.mjs
export const double = value => value * 2;
// main.mjs
async function main() {
const first = await import("./math.mjs");
const second = await import("./math.mjs");
console.log(first.double(21));
console.log(first === second);
}
main().catch(console.error);Ergebnis
42 true
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.