CKTIS / JavaScript
import — import modulů JavaScriptu
Klíčové slovo import zpřístupňuje exporty z jiných modulů. Seznamte se se statickými deklaracemi a živými vazbami a zjistěte, jak se import(...), import.meta a běžná volání funkcí liší.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.metaimport je rezervované klíčové slovo a nelze ho použít jako název proměnné. Statická deklarace import se může objevit pouze na nejvyšší úrovni modulu, nikoli uvnitř funkce nebo bloku. Specifikátor modulu musí být řetězcový literál. Statické importy patří do systému modulů zavedeného v ECMAScriptu 2015.
Výchozí import vybírá export default; pojmenovaný import vybírá konkrétní export a as mu přiřazuje místní název. Forma import * as namespace vytváří místní vazbu na objekt prostoru názvů modulu. import "module" spustí závislost, aniž vytvoří místní vazby. Importované vazby jsou živé: odrážejí změny v exportujícím modulu. Importující modul jim nemůže přiřadit novou hodnotu; to však neznamená, že je importovaný objekt zmrazený.
import(specifier) je samostatná syntaxe dynamického importu, zavedená v ECMAScriptu 2020, nikoli běžná funkce. Lze ji použít ve výrazech i v běžném skriptu a vrací Promise. Po úspěšném načtení a vyhodnocení modulu se příslib zpravidla splní s objektem prostoru názvů modulu jako výslednou hodnotou. Pokud však modul pod názvem then exportuje hodnotu, kterou lze volat, mechanismus vyhodnocení příslibu ji zavolá. Příslib se pak může splnit s jinou hodnotou nebo být zamítnut, i když vyhodnocení modulu proběhlo úspěšně. import.meta, rovněž z ECMAScriptu 2020, zpřístupňuje metadata modulu závislá na hostitelském prostředí a je povoleno pouze v modulech.
Rozlišení specifikátorů a načítání modulů závisí na hostitelském prostředí. Samotná specifikace jazyka ani úspěšné spuštění v Node.js nedokládají podporu v konkrétním prohlížeči. Příklad ukazuje živou vazbu: volání increase() změní hodnotu pozorovanou přes count.
Příklady
// 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);Výsledek
1 2
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.