CKTIS / JavaScript
Moduly a hranice zodpovednosti
Moduly ECMAScript oddeľujú interné deklarácie od explicitných exportov. Importy prepájajú moduly, zatiaľ čo barrel modul zhromažďuje reexporty za jediným vstupným bodom.
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
// Separate forms, not a single module.
// Export an existing local binding named `name`.
export { name };
// Import a named export as a local binding.
import { name } from "./module.mjs";
// Re-export a named export directly from another module.
export { name } from "./module.mjs";Modul ECMAScript má vlastný rozsah platnosti a funguje v prísnom režime. export definuje rozhranie dostupné ostatným modulom, zatiaľ čo import sprístupňuje vybrané exporty. Hranica modulu pomáha skryť podrobnosti implementácie, ale nie je hranicou bezpečnostnej izolácie. Syntax modulov pochádza z ECMAScript 2015; načítavanie a rozlišovanie špecifikátorov závisí od hostiteľského prostredia.
Importované väzby sú živé: pri čítaní odrážajú zmeny vykonané v exportujúcom module. Importujúci modul nemôže takejto väzbe priradiť novú hodnotu; to však neznamená, že importovaný objekt je nemenný. Statické deklarácie import a export sa nachádzajú na najvyššej úrovni modulu.
Barrel modul je zaužívané označenie pre modul, ktorý zhromažďuje reexporty, nie samostatná jazyková konštrukcia. V príklade index.mjs sprístupňuje increment a read, zatiaľ čo count zostáva interný. Explicitné reexporty dokumentujú verejné rozhranie. export * nepreposiela export default a kolízie názvov môžu spôsobiť nejednoznačný import.
Uložte tri časti príkladu ako samostatné súbory v jednom adresári; nespájajte ich do jedného skriptu. Spustite main.mjs v konzolovom prostredí podporujúcom moduly ECMAScript. Očakávaný výstup je 0 a potom 1 na samostatných riadkoch. Príklad bol spustený v Node.js a jeho výstup sa presne zhodoval s očakávaným výstupom. To nepotvrdzuje podporu rozhraní API prehliadača.
Príklady
// counter.mjs
let count = 0;
export function increment() {
count += 1;
}
export function read() {
return count;
}
// index.mjs
export { increment, read } from "./counter.mjs";
// main.mjs
import { increment, read } from "./index.mjs";
console.log(read());
increment();
console.log(read());Výsledok
0 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.