Perché un file del tuo sito con import non viene eseguito
Con Node.js 20.18.0 un file .js con import parte se il package.json più vicino ha type module, oppure se il file è .mjs. Con type module, require in un file .js si ferma. Un file .cjs continua a usare require.
In questa guida (2)
Un file del sito che contiene la parola import può partire oppure fermarsi prima di eseguire una riga, e il messaggio dipende da un campo del package.json più vicino e dall'estensione del file. Il 16 novembre 2026 l'ho provato con Node.js 20.18.0, in cartelle di prova, senza un sito pubblicato e senza un bundler.
Che cosa è successo nelle cartelle di prova
Nella prima cartella il package.json conteneva solo il campo type con valore module. Un file app.js con import di readFileSync da node:fs ha stampato il tipo function ed è uscito con codice 0. Un file bad.js nella stessa cartella, con require di node:fs, si è fermato con ReferenceError: require is not defined in ES module scope. Il messaggio aggiunge che il file è trattato come modulo ES perché ha estensione .js e perché quel package.json contiene type module, e indica di rinominarlo in .cjs. Un file old.cjs con lo stesso require, sempre in quella cartella, è uscito con codice 0.
Nella seconda cartella il package.json non aveva il campo type. Lo stesso import in un file .js ha dato prima l'avviso di impostare type module oppure di usare l'estensione .mjs, poi SyntaxError: Cannot use import statement outside a module, codice 1. Un file app.mjs con lo stesso import, nella stessa cartella, è uscito con codice 0.
Nella terza prova il package.json con type module stava nella cartella padre e i file .js stavano in una sottocartella senza un proprio package.json. L'import nel figlio è uscito con codice 0. Il require nel figlio ha dato lo stesso ReferenceError, e il messaggio nominava il package.json della cartella padre. Con type commonjs nel padre, l'import nel figlio .js ha dato di nuovo SyntaxError.
Il campo type riguarda i file .js, non le altre estensioni
La documentazione di Node.js 20, pagina Packages, sezione type, letta il 16 novembre 2026, dice che il campo type definisce il formato dei file .js che hanno quel package.json come padre più vicino. Il padre più vicino è il primo package.json incontrato risalendo le cartelle, fino a una cartella node_modules o alla radice del volume. Se il campo manca, o se vale commonjs, i file .js sono CommonJS. Il campo è stato aggiunto nella versione 12.0.0.
La prova conferma il caso della stessa cartella e il caso del padre un livello sopra, sia con type module sia con type commonjs. Non ho messo un package.json dentro node_modules per vedere dove la risalita si ferma, e non ho provato il campo imports, un bundler, TypeScript o il browser. Per il browser il problema è un altro: quale indirizzo risolve il nome di una libreria. Qui il file non parte nemmeno, prima di qualsiasi rete.
Se l'errore parla di versione di Node e non di import, la pagina come il sito indica la versione di Node che gli serve riguarda il numero dichiarato nel progetto, non questo campo.
L'immagine è una tastiera fotografata da vicino, 8 febbraio 2017, foto di Martin Vorel, scheda Wikimedia, licenza CC BY-SA 4.0. È una tastiera, non la schermata della prova.


