CKTIS / JavaScript
Načítanie modulov a rozdelenie kódu
Moduly tvoria graf závislostí. Statický import deklaruje závislosť, zatiaľ čo `import()` umožňuje kódu vyžiadať si modul počas vykonávania. Rozdelenie kódu na samostatne načítavané časti závisí od prostredia a nástrojov, nielen od syntaxe JavaScriptu.
Verzia: 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);Načítanie modulov zahŕňa získanie modulu a jeho závislostí, prepojenie importov s exportmi a vykonanie kódu. Statické deklarácie import sa nachádzajú na najvyššej úrovni modulu; určujú závislosti ešte pred vykonaním tela modulu. Importované názvy sú živé väzby na exporty, nie kópie ich hodnôt.
Dynamický import(specifier) je výraz dostupný aj v bežných skriptoch a vnútri podmienok alebo funkcií. Vráti Promise, ktorého výsledkom je po úspešnom načítaní, prepojení a vykonaní modulu spravidla objekt menného priestoru modulu obsahujúci exporty. Ak však modul pod názvom then exportuje volateľnú hodnotu, mechanizmus vyhodnocovania prísľubu ju zavolá s funkciami na vyriešenie a zamietnutie prísľubu. Výsledok prísľubu potom závisí od tohto volania a nemusí ním byť objekt menného priestoru. Zamietnutie ošetrite pomocou try/catch okolo await alebo pomocou .catch(). Jeho argument možno vypočítať počas vykonávania.
Rozdelenie kódu znamená prípravu samostatne načítavateľných častí aplikácie. import() poskytuje bod načítania na požiadanie, ECMAScript však nevyžaduje samostatné výstupné súbory ani sieťové požiadavky. Rozlišovanie špecifikátorov a načítavanie modulov závisí od hostiteľa; rozdelenie výstupných súborov závisí od nástrojov. Opätovný import toho istého rozlíšeného modulu jeho kód nespustí znova. Ak modul nemá volateľný export s názvom then, oba úspešné dynamické importy poskytnú ten istý objekt menného priestoru.
Statické moduly boli zavedené v ES2015 a import() v ES2020. Nejde o tabuľku kompatibility prehliadačov: jazyková špecifikácia nezaručuje podporu v konkrétnom prehliadači a Node 24 nedokladá podporu Web APIs. V príklade je main.mjs vstupným bodom a obe volania import() odkazujú na ten istý miestny modul math.mjs. Iba tento modul sa načítava dynamicky. Príklad neukazuje rozdelenie kódu bundlerom.
Prí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ýsledok
42 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.