Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

export — udostępnianie elementów modułu

Słowo kluczowe export udostępnia elementy modułu ECMAScript innym modułom. Obsługuje eksporty nazwane, jeden eksport domyślny oraz ponowny eksport z innego modułu.

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

export const name = value;
export { name, name as alias };
export default expression;
export { name } from "./module.mjs";
export * from "./module.mjs";

export jest zastrzeżonym słowem kluczowym deklarującym eksporty modułu ECMAScript. Występuje wyłącznie na najwyższym poziomie modułu, nie wewnątrz funkcji ani bloków. W zwykłym skrypcie powoduje błąd składni.

Eksport nazwany można zadeklarować bezpośrednio, np. export const name = value;, lub wskazać istniejącą deklarację przez export { name };. Zapis export { name as alias }; zmienia nazwę eksportowaną, nie lokalną. Nawiasy klamrowe są tu listą eksportów, nie literałem obiektu.

Moduł może mieć wiele eksportów nazwanych i najwyżej jeden default. Import nazwany używa nazwy eksportu; import domyślny może otrzymać dowolną poprawną nazwę lokalną. Powtórzenie nazwy eksportu jest błędem składni. export { name } from "./module.mjs"; przekazuje eksport dalej, a export * from "./module.mjs"; nie przekazuje default.

Importowane wiązania odzwierciedlają zmiany dokonane przez moduł źródłowy; importer nie może przypisać im nowej wartości. Uwaga: export default expression; eksportuje wynik obliczenia wyrażenia, natomiast export { name as default }; udostępnia aktualne wiązanie name. W przykładzie wywołanie increment() zmienia wartość widoczną jako count.

Przykłady

// counter.mjs
export let count = 0;
export function increment() {
  count += 1;
}
export default "counter";

// main.mjs
import label, { count, increment } from "./counter.mjs";
console.log(label, count);
increment();
console.log(label, count);

Wynik

counter 0
counter 1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła