CKTIS / JavaScript
Moduły i granice odpowiedzialności
Moduły ECMAScript oddzielają wewnętrzne deklaracje od jawnych eksportów. Importy łączą moduły, a barrel module zbiera reeksporty w jednym punkcie wejścia.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
// 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";Moduł ECMAScript ma własny zakres i działa w trybie ścisłym. export określa interfejs dostępny dla innych modułów, a import udostępnia wybrane eksporty. Granica modułu pomaga ukryć szczegóły implementacji, ale nie jest izolacją bezpieczeństwa. Składnia modułów pochodzi z ECMAScript 2015; sposób ładowania i rozwiązywania specyfikatorów zależy od środowiska.
Importowane wiązania są żywe: odczyt odzwierciedla zmiany wykonane w module eksportującym. Importer nie może przypisać nowej wartości do takiego wiązania; nie oznacza to jednak niezmienności importowanego obiektu. Statyczne deklaracje import i export występują na najwyższym poziomie modułu.
barrel module to konwencjonalna nazwa modułu zbierającego reeksporty, nie osobna konstrukcja języka. W przykładzie index.mjs udostępnia increment i read, podczas gdy count pozostaje wewnętrzny. Jawne reeksporty dokumentują publiczny interfejs. export * nie przekazuje eksportu default, a kolizje nazw mogą sprawić, że import będzie niejednoznaczny.
Zapisz trzy sekcje przykładu jako oddzielne pliki we wspólnym katalogu; nie łącz ich w jeden skrypt. Uruchom main.mjs w konsolowym środowisku obsługującym moduły ECMAScript. Oczekiwane wyjście to 0, a następnie 1, w oddzielnych wierszach. Przykład uruchomiono w Node.js i sprawdzono, że wyjście dokładnie odpowiada oczekiwanemu. Nie potwierdza to obsługi przeglądarkowych API.
Przykłady
// 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());Wynik
0 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.