CKTIS / JavaScript
import — importowanie modułów JavaScript
Słowo kluczowe import udostępnia eksporty innych modułów. Poznaj statyczne deklaracje, żywe powiązania oraz różnicę między import(...), import.meta i zwykłym wywołaniem funkcji.
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
import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.metaimport jest zastrzeżonym słowem kluczowym: nie może być nazwą zmiennej. Statyczna deklaracja import występuje wyłącznie na najwyższym poziomie modułu, nie wewnątrz funkcji ani bloku. Jej specyfikator modułu musi być literałem tekstowym. Importy statyczne należą do systemu modułów wprowadzonego w ECMAScript 2015.
Import domyślny pobiera eksport default; import nazwany wybiera konkretny eksport, a as nadaje mu lokalną nazwę. Forma import * as namespace tworzy lokalne powiązanie z obiektem przestrzeni nazw modułu. import "module" uruchamia zależność bez tworzenia lokalnych powiązań. Importowane powiązania są żywe: odzwierciedlają zmiany po stronie eksportującego modułu. Importer nie może przypisać do nich nowej wartości; nie oznacza to jednak zamrożenia importowanego obiektu.
import(specifier) to odrębna składnia importu dynamicznego, dodana w ECMAScript 2020, a nie zwykła funkcja. Może występować w wyrażeniach, także w zwykłym skrypcie, i zwraca Promise. Po pomyślnym załadowaniu i wykonaniu modułu obietnica zwykle spełnia się z obiektem jego przestrzeni nazw. Jeśli jednak moduł eksportuje pod nazwą then wartość, którą można wywołać, mechanizm rozstrzygania obietnicy ją wywołuje. W rezultacie obietnica może spełnić się z inną wartością lub zostać odrzucona mimo pomyślnego wykonania modułu. import.meta, również z ECMAScript 2020, udostępnia metadane modułu zależne od środowiska i jest dozwolone tylko w modułach.
Sposób rozwiązywania specyfikatorów i ładowania modułów zależy od środowiska. Sama specyfikacja języka ani działanie w Node.js nie potwierdzają obsługi w konkretnej przeglądarce. Przykład pokazuje żywe powiązanie: wywołanie increase() zmienia wartość widoczną przez count.
Przykłady
// counter.mjs
export let count = 1;
export function increment() {
count += 1;
}
// main.mjs
import { count, increment as increase } from "./counter.mjs";
console.log(count);
increase();
console.log(count);Wynik
1 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.