Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Načítání modulů a rozdělení kódu

Moduly tvoří graf závislostí. Statický import deklaruje závislost, zatímco `import()` umožňuje kódu vyžádat si modul za běhu. Rozdělení kódu na samostatně načítané části závisí na prostředí a nástrojích, nejen na syntaxi JavaScriptu.

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

Syntaxe

// 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);

Načítání modulů zahrnuje získání modulu a jeho závislostí, propojení importů s exporty a spuštění kódu. Statické deklarace import se nacházejí na nejvyšší úrovni modulu; určují závislosti ještě před spuštěním těla modulu. Importované názvy jsou živé vazby na exporty, nikoli kopie jejich hodnot.

Dynamický import(specifier) je výraz dostupný také v běžných skriptech a uvnitř podmínek nebo funkcí. Vrací Promise, který se po úspěšném načtení, propojení a spuštění modulu obvykle splní s objektem jmenného prostoru modulu obsahujícím exporty. Pokud ale modul pod názvem then exportuje volatelnou hodnotu, mechanismus vyhodnocení příslibu ji zavolá s funkcemi pro vyřešení a zamítnutí příslibu. Výsledek příslibu pak závisí na tomto volání a nemusí jím být objekt jmenného prostoru. Zamítnutí ošetřete pomocí try/catch kolem await nebo pomocí .catch(). Jeho argument lze vypočítat za běhu.

Rozdělení kódu znamená přípravu samostatně načítatelných částí aplikace. import() poskytuje místo pro načtení na vyžádání, ECMAScript však nevyžaduje samostatné výstupní soubory ani síťové požadavky. Rozlišení specifikátorů a načítání modulů závisí na hostiteli; rozdělení výstupních souborů závisí na nástrojích. Opětovný import téhož rozlišeného modulu jeho kód nespustí znovu. Pokud modul nemá volatelný export s názvem then, oba úspěšné dynamické importy poskytnou tentýž objekt jmenného prostoru.

Statické moduly byly zavedeny v ES2015 a import() v ES2020. Nejde o tabulku kompatibility prohlížečů: jazyková specifikace nezaručuje podporu v konkrétním prohlížeči a Node 24 nedokládá podporu Web APIs. V příkladu je main.mjs vstupním bodem a obě volání import() míří na tentýž místní modul math.mjs. Pouze tento modul se načítá dynamicky. Příklad neukazuje rozdělení kódu bundlerem.

Příklady

// 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);

Výsledek

42
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje