CKTIS / JavaScript
Caricamento dei moduli e suddivisione del codice
I moduli formano un grafo di dipendenze. Un import statico dichiara una dipendenza, mentre `import()` consente al codice di richiedere un modulo durante l’esecuzione. La suddivisione del codice in parti caricate separatamente dipende dall’ambiente e dagli strumenti, non solo dalla sintassi JavaScript.
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
// module.mjs
export const name = value;
// main.mjs
import { name } from "./module.mjs";
async function main() {
const namespace = await import("./module.mjs");
}
main().catch(console.error);Il caricamento dei moduli comprende il recupero di un modulo e delle sue dipendenze, il collegamento degli import agli export e l’esecuzione del codice. Le dichiarazioni statiche import si trovano al livello superiore del modulo; identificano le dipendenze prima che venga eseguito il corpo del modulo. I nomi importati sono collegamenti attivi agli export, non copie dei loro valori.
L’import(specifier) dinamico è un’espressione disponibile anche negli script normali e all’interno di condizioni o funzioni. Restituisce una Promise che, dopo che il modulo è stato caricato, collegato ed eseguito con successo, normalmente ha come valore di adempimento l’oggetto namespace del modulo, che contiene gli export. Se però il modulo esporta un valore invocabile con il nome then, il meccanismo di risoluzione della promessa lo invoca con le funzioni di risoluzione e di rifiuto. L’esito della promessa dipende allora da quella chiamata: il valore di adempimento non è necessariamente l’oggetto namespace. Gestisci il rifiuto con try/catch attorno ad await oppure con .catch(). Il suo argomento può essere calcolato durante l’esecuzione.
La suddivisione del codice consiste nel preparare parti di un’applicazione caricabili separatamente. import() fornisce un punto di caricamento su richiesta, ma ECMAScript non impone file di output separati né richieste di rete. La risoluzione degli specificatori e il recupero dei moduli dipendono dall’host; la suddivisione dei file di output dipende dagli strumenti. Importare di nuovo lo stesso modulo risolto non ne riesegue il codice. In assenza di un export invocabile chiamato then, entrambi gli import dinamici, se vanno a buon fine, forniscono lo stesso oggetto namespace.
I moduli statici sono stati introdotti in ES2015 e import() in ES2020. Questa non è una tabella di compatibilità dei browser: la specifica del linguaggio non garantisce il supporto in uno specifico browser, e Node 24 non dimostra il supporto delle Web APIs. Nell’esempio, main.mjs è il punto di ingresso ed entrambe le chiamate a import() richiedono lo stesso modulo locale, math.mjs. Solo quel modulo viene caricato dinamicamente. L’esempio non mostra una suddivisione del codice generata da un bundler.
Esempi
// math.mjs
export const double = value => value * 2;
// main.mjs
async function main() {
const first = await import("./math.mjs");
const second = await import("./math.mjs");
console.log(first.double(21));
console.log(first === second);
}
main().catch(console.error);Risultato
42 true
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.