Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

import — uvoz JavaScript modula

Ključna riječ import omogućuje pristup izvozima iz drugih modula. Saznajte više o statičkim deklaracijama i živim vezama te o razlikama između import(...), import.meta i običnih poziva funkcija.

Verzija: 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.meta

import je rezervirana ključna riječ i ne može biti naziv varijable. Statička deklaracija import pojavljuje se samo na najvišoj razini modula, a ne unutar funkcije ili bloka. Specifikator modula mora biti znakovni literal. Statički uvozi dio su modularnog sustava uvedenog u ECMAScriptu 2015.

Zadani uvoz odabire izvoz default; imenovani uvoz odabire određeni izvoz, a as mu dodjeljuje lokalni naziv. Oblik import * as namespace stvara lokalnu vezu s objektom prostora naziva modula. import "module" izvršava ovisnost bez stvaranja lokalnih veza. Uvezane su veze žive: odražavaju promjene u modulu koji izvozi. Modul koji uvozi ne može im dodijeliti novu vrijednost; to, međutim, ne znači da je uvezeni objekt zamrznut.

import(specifier) zasebna je sintaksa za dinamički uvoz, uvedena u ECMAScriptu 2020, a ne obična funkcija. Može se upotrebljavati u izrazima, pa i u običnoj skripti, te vraća Promise. Nakon uspješnog učitavanja i izvođenja modula obećanje se obično ispuni s objektom prostora naziva modula kao rezultatom. No ako modul pod nazivom then izvozi vrijednost koja se može pozvati, mehanizam za razrješavanje obećanja poziva je. Obećanje se stoga može ispuniti s drugom vrijednošću ili biti odbijeno iako je modul uspješno izveden. import.meta, također iz ECMAScripta 2020, izlaže metapodatke modula ovisne o okruženju domaćina i dopušten je samo u modulima.

Razrješavanje specifikatora i učitavanje modula ovise o okruženju domaćina. Ni sama specifikacija jezika ni uspješno izvođenje u Node.js ne dokazuju podršku u određenom pregledniku. Primjer prikazuje živu vezu: poziv increase() mijenja vrijednost koja se vidi putem count.

Primjeri

// 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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori