CKTIS / JavaScript
import — importare moduli JavaScript
La parola chiave import rende disponibili gli export di altri moduli. Scopri le dichiarazioni statiche e i collegamenti live, e le differenze tra import(...), import.meta e le normali chiamate di funzione.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.metaimport è una parola chiave riservata: non può essere usata come nome di una variabile. Una dichiarazione statica import compare solo al livello più alto di un modulo, non all’interno di una funzione o di un blocco. Il suo identificatore di modulo deve essere un literal stringa. Gli import statici fanno parte del sistema di moduli introdotto in ECMAScript 2015.
Un import predefinito seleziona l’export default; un import con nome seleziona un export specifico, e as gli assegna un nome locale. La forma import * as namespace crea un collegamento locale all’oggetto namespace del modulo. import "module" esegue la dipendenza senza creare collegamenti locali. I collegamenti importati sono live: riflettono le modifiche apportate dal modulo che esporta. Il modulo che importa non può assegnare loro un nuovo valore; questo, però, non significa che un oggetto importato sia congelato.
import(specifier) è una sintassi distinta per l’importazione dinamica, introdotta in ECMAScript 2020, e non una funzione ordinaria. Può comparire nelle espressioni, anche in uno script normale, e restituisce una Promise. Una volta caricato e valutato correttamente il modulo, la promessa viene di norma adempiuta con l’oggetto namespace del modulo. Se però il modulo esporta un valore invocabile con il nome then, il meccanismo di risoluzione della promessa lo invoca. La promessa può quindi essere adempiuta con un valore diverso oppure essere rifiutata, anche se la valutazione del modulo è riuscita. import.meta, anch’esso di ECMAScript 2020, espone metadati del modulo dipendenti dall’ambiente host ed è consentito solo nei moduli.
La risoluzione degli identificatori e il caricamento dei moduli dipendono dall’ambiente host. Né la sola specifica del linguaggio né l’esecuzione corretta in Node.js dimostrano il supporto in uno specifico browser. L’esempio illustra un collegamento live: la chiamata a increase() modifica il valore osservato tramite count.
Esempi
// 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);Risultato
1 2
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.