Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

import — importovanie modulov JavaScriptu

Kľúčové slovo import sprístupňuje exporty z iných modulov. Zoznámte sa so statickými deklaráciami a živými väzbami a zistite, ako sa import(...), import.meta a bežné volania funkcií líšia.

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

import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.meta

import je rezervované kľúčové slovo a nemožno ho použiť ako názov premennej. Statická deklarácia import sa môže nachádzať iba na najvyššej úrovni modulu, nie vo funkcii ani v bloku. Špecifikátor modulu musí byť reťazcový literál. Statické importy patria do systému modulov zavedeného v ECMAScripte 2015.

Predvolený import vyberá export default; pomenovaný import vyberá konkrétny export a as mu priradí miestny názov. Forma import * as namespace vytvára miestnu väzbu na objekt priestoru názvov modulu. import "module" spustí závislosť bez vytvorenia miestnych väzieb. Importované väzby sú živé: odrážajú zmeny v exportujúcom module. Importujúci modul im nemôže priradiť novú hodnotu; to však neznamená, že importovaný objekt je zmrazený.

import(specifier) je samostatná syntax dynamického importu, zavedená v ECMAScripte 2020, nie bežná funkcia. Dá sa použiť vo výrazoch aj v bežnom skripte a vracia Promise. Po úspešnom načítaní a vyhodnotení modulu je výslednou hodnotou splneného prísľubu zvyčajne objekt priestoru názvov modulu. Ak však modul pod názvom then exportuje hodnotu, ktorú možno zavolať, mechanizmus vyhodnotenia prísľubu ju zavolá. Prísľub sa potom môže splniť s inou hodnotou alebo môže byť zamietnutý, hoci vyhodnotenie modulu prebehlo úspešne. import.meta, takisto z ECMAScriptu 2020, sprístupňuje metadáta modulu závislé od hostiteľského prostredia a je povolené iba v moduloch.

Rozlišovanie špecifikátorov a načítavanie modulov závisí od hostiteľského prostredia. Samotná špecifikácia jazyka ani úspešné spustenie v Node.js nepotvrdzujú podporu v konkrétnom prehliadači. Príklad ukazuje živú väzbu: volanie increase() zmení hodnotu pozorovanú cez count.

Prí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ýsledok

1
2

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje