Categoria
Articoli tecnici organizzati per gruppo funzionale.
Le costanti globali '__dirname' e '__filename' esistono solo in CommonJS; nei moduli ES si ricavano con 'import.meta.dirname' (Node 20.11+) o con 'fileURLToPath(new URL(".", import.meta.url))'.
Il pacchetto specificato nell'istruzione require o import non è presente nella cartella node_modules locale o globale; si risolve eseguendo 'npm install'.
Node.js interpreta per impostazione predefinita i file .js come moduli CommonJS; se il file contiene istruzioni 'import' o 'export' senza avere '"type": "module"' nel package.json o estensione '.mjs', il motore V8 interrompe l'analisi sintattica.
Il loader dei moduli ES di Node.js supporta nativamente solo attributi di tipo standard come 'type: "json"'; l'uso di tipi non registrati o personalizzati senza un custom loader personalizzato solleva questa eccezione.
Il file package.json situato nella cartella del modulo contiene errori di formattazione JSON (es. virgole finali, apici singoli o commenti non ammessi dallo standard JSON).
La destinazione associata a una chiave di subpath nella sezione 'exports' del package.json contiene un percorso non conforme (es. percorso assoluto, privo di prefisso './' o con caratteri illegali).
Quando Node.js viene eseguito con il flag '--experimental-policy=policy.json', qualsiasi discrepanza tra l'hash crittografico (SHA-256) del file su disco e la policy configurata blocca l'importazione del modulo.
A differenza di CommonJS, la specifica ECMAScript Modules nativa di Node.js vieta la risoluzione automatica delle estensioni: qualsiasi importazione di file locale relativo ('import x from "./utils"') deve includere esplicitamente l'estensione ('import x from "./utils.js"').