Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti