CKTIS / JavaScript
import — uvoz modulov JavaScript
Ključna beseda import omogoča dostop do izvozov iz drugih modulov. Spoznajte statične deklaracije in žive povezave ter razlike med import(...), import.meta in običajnimi klici funkcij.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.metaimport je rezervirana ključna beseda: ne more biti ime spremenljivke. Statična deklaracija import se lahko pojavi samo na najvišji ravni modula, ne pa znotraj funkcije ali bloka. Specifikator modula mora biti nizovni literal. Statični uvozi so del modularnega sistema, uvedenega v ECMAScriptu 2015.
Privzeti uvoz izbere izvoz default; poimenovani uvoz izbere določen izvoz, as pa mu dodeli lokalno ime. Oblika import * as namespace ustvari lokalno povezavo z objektom imenskega prostora modula. import "module" izvede odvisnost, ne da bi ustvaril lokalne povezave. Uvožene povezave so žive: odražajo spremembe v modulu, ki izvaža. Modul, ki uvaža, jim ne more dodeliti nove vrednosti; to pa ne pomeni, da je uvoženi objekt zamrznjen.
import(specifier) je ločena sintaksa za dinamični uvoz, uvedena v ECMAScriptu 2020, in ne običajna funkcija. Pojavi se lahko v izrazih, tudi v navadnem skriptu, in vrne Promise. Po uspešnem nalaganju in ovrednotenju modula se obljuba običajno izpolni z objektom imenskega prostora modula. Če pa modul pod imenom then izvaža vrednost, ki jo je mogoče poklicati, jo mehanizem za razreševanje obljube pokliče. Obljuba se zato lahko izpolni z drugo vrednostjo ali pa je zavrnjena, čeprav je bil modul uspešno ovrednoten. import.meta, prav tako iz ECMAScripta 2020, razkriva metapodatke modula, odvisne od gostiteljskega okolja, in je dovoljen samo v modulih.
Razreševanje specifikatorjev in nalaganje modulov sta odvisna od gostiteljskega okolja. Niti sama jezikovna specifikacija niti uspešno izvajanje v Node.js ne dokazujeta podpore v določenem brskalniku. Primer prikazuje živo povezavo: klic increase() spremeni vrednost, vidno prek count.
Primeri
// 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);Rezultat
1 2
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.