Stack

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.

Marco Conte 2 min di lettura

Perché un file del tuo sito con import non viene eseguito
In questa guida (2)
  1. 1Che cosa è successo nelle cartelle di prova
  2. 2Il campo type riguarda i file .js, non le altre estensioni

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.

Potrebbe interessarti anche...

Hai bisogno di scegliere una webagency per il tuo progetto?

Abbiamo la soluzione giusta

Parliamone
  • Consulenza specializzata
  • Soluzioni su misura
  • Risultati concreti

Tecnologialiberaper tutti

Hai bisogno d'aiuto?

Parla con noi. Il nostro supporto è attivo tutti i giorni dalle 9 alle 18

+390835239514 Chiamaci

Crea il tuo eCommerce

Creiamo eCommerce su misura senza farti spendere un patrimonio

info@roxxoitalia.com Scopri il nostro CMS

Crea il tuo sito web

Siti web già pronti per andare online. Vuoi saperne di più? Contattaci

info@roxxoitalia.com Scrivici