Categoria
Articoli tecnici organizzati per gruppo funzionale.
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"').
L'importazione diretta di moduli da URL remoti ('https://...') è disabilitata per default per ragioni di sicurezza; richiede il flag sperimentale '--experimental-network-imports'.
L'uso di alias interni con prefisso '#name' (subpath imports) fallisce se il mapping non è dichiarato esplicitamente nella sezione '"imports"' del file package.json del progetto.
Compare quando si tenta di importare un file interno di una libreria ('import x from "pkg/lib/util.js"') ma il package.json dell'autore definisce una mappa restrittiva 'exports' che incapsula i file interni vietando l'accesso diretto.
Si verifica quando un file CommonJS (.cjs o progetto senza "type": "module") tenta di importare una libreria pubblicata solo come ES Module (es. node-fetch v3, chalk v5) tramite 'require()'; si risolve convertendo il progetto a ESM o usando 'await import()' dinamico.
Il runtime Node.js nativo esegue solo file JavaScript (.js, .mjs, .cjs); eseguire direttamente file TypeScript (.ts) o JSX senza loader o bundler (come tsx, ts-node o flag '--experimental-strip-types' da Node 22+) scatena questo errore.