CKTIS / JavaScript
Moduli e confini di responsabilità
I moduli ECMAScript separano le dichiarazioni interne dalle esportazioni esplicite. Gli import collegano i moduli, mentre un modulo barrel raccoglie le riesportazioni in un unico punto di ingresso.
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
// Separate forms, not a single module.
// Export an existing local binding named `name`.
export { name };
// Import a named export as a local binding.
import { name } from "./module.mjs";
// Re-export a named export directly from another module.
export { name } from "./module.mjs";Un modulo ECMAScript ha un proprio ambito e viene eseguito in modalità strict. export definisce l’interfaccia disponibile agli altri moduli, mentre import rende accessibili le esportazioni selezionate. Il confine di un modulo aiuta a nascondere i dettagli di implementazione, ma non è un confine di isolamento di sicurezza. La sintassi dei moduli risale a ECMAScript 2015; il caricamento e la risoluzione degli specificatori dipendono dall’ambiente host.
I binding importati sono live: leggendoli si riflettono le modifiche effettuate nel modulo che li esporta. Un modulo importatore non può assegnare un nuovo valore a un binding di questo tipo; ciò non rende però immutabile un oggetto importato. Le dichiarazioni statiche import ed export compaiono al livello superiore del modulo.
Modulo barrel è un nome convenzionale per un modulo che raccoglie riesportazioni, non una costruzione separata del linguaggio. Nell’esempio, index.mjs espone increment e read, mentre count resta interno. Le riesportazioni esplicite documentano l’interfaccia pubblica. export * non inoltra l’esportazione default e le collisioni tra nomi possono rendere ambiguo un import.
Salva le tre sezioni dell’esempio come file separati in una stessa directory; non concatenarle in un unico script. Esegui main.mjs in un ambiente console che supporta i moduli ECMAScript. L’output atteso è 0, seguito da 1 su righe separate. L’esempio è stato eseguito in Node.js e l’output ha coinciso esattamente con quello atteso. Questo non dimostra il supporto delle API del browser.
Esempi
// counter.mjs
let count = 0;
export function increment() {
count += 1;
}
export function read() {
return count;
}
// index.mjs
export { increment, read } from "./counter.mjs";
// main.mjs
import { increment, read } from "./index.mjs";
console.log(read());
increment();
console.log(read());Risultato
0 1
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.