TypeError [ERR_IMPORT_ATTRIBUTE_MISSING]: Module "file:///app/date/produse.json" needs an import attribute of "type: json"
Într-un modul ES nu poți importa un fișier JSON fără să spui că e JSON. Scrie import produse from "./date/produse.json" with { type: "json" }. Alternativ, citește fișierul cu fs.readFileSync și JSON.parse.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În CommonJS, require("./date.json") citește și parsează JSON-ul automat. În modulele ES, Node cere să declari explicit tipul fișierului printr-un import attribute: with { type: "json" }. Regula există din motive de securitate: un import fără atribut se așteaptă la cod JavaScript, iar serverul sau fișierul nu poate „schimba” tipul pe ascuns.
Mesajul îți dă calea completă a fișierului ca URL (file:///app/date/produse.json) și exact atributul care lipsește: type: json.
Apare când muți un proiect de pe require pe import, când adaugi "type": "module" în package.json sau când copiezi cod scris pentru un bundler (Vite, webpack), care acceptă importul de JSON fără atribut. Node nu acceptă.
De ce apare: cauzele frecvente
1Import de JSON fără atribut
import produse from "./date/produse.json";import produse from "./date/produse.json" with { type: "json" };Atributul with { type: "json" } îi spune lui Node să trateze fișierul ca JSON și să îți dea obiectul parsat ca export implicit.
2Import cu nume dintr-un JSON
import { port } from "./config.json" with { type: "json" };import config from "./config.json" with { type: "json" };
const { port } = config;Un modul JSON are doar export implicit (tot obiectul). Proprietățile le iei după import.
3Varianta fără import, cu fs
import setari from "./setari.json";import fs from "node:fs";
const setari = JSON.parse(fs.readFileSync(new URL("./setari.json", import.meta.url), "utf8"));Citirea cu fs merge în orice versiune de Node și îți permite să recitești fișierul dacă se schimbă.
Repară eroarea, direct în pagină
Programul (modul ES) importă lista de produse din date/produse.json, dar se oprește cu TypeError [ERR_IMPORT_ATTRIBUTE_MISSING]: Module "file:///app/date/produse.json" needs an import attribute of "type: json". Adaugă atributul de import potrivit, ca programul să afișeze produsele fără stoc.
import produse from "./date/produse.json";
const lipsa = produse.filter((p) => p.stoc === 0);
console.log(`Produse fără stoc: ${lipsa.length}`);
for (const p of lipsa) console.log(`- ${p.nume}`);Produse fără stoc: 2 - Ceai verde - Cană
Indiciu
După calea fișierului adaugi with { type: "json" }.
Reparația
import produse from "./date/produse.json" with { type: "json" };
const lipsa = produse.filter((p) => p.stoc === 0);
console.log(`Produse fără stoc: ${lipsa.length}`);
for (const p of lipsa) console.log(`- ${p.nume}`);De ce merge
Un import obișnuit într-un modul ES se așteaptă la cod JavaScript. Pentru JSON trebuie să declari tipul cu with { type: "json" }; atunci Node citește fișierul, îl parsează și îți dă tabloul ca export implicit, exact ce primea require în CommonJS. Restul programului lucrează cu un tablou obișnuit.
Alte forme ale mesajului
TypeError [ERR_IMPORT_ASSERTION_TYPE_MISSING]: Module "file:///app/config.json" needs an import assertion of type "json"TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".json" for /app/date/produse.jsonTypeError [ERR_IMPORT_ATTRIBUTE_MISSING]: Module "file:///app/package.json" needs an import attribute of "type: json"
Cum o eviți pe viitor
- Importă JSON în modulele ES mereu cu
with { type: "json" }. - Folosește export implicit pentru JSON:
import config from "./config.json" with { type: "json" }. - Pentru fișiere care se schimbă în timpul rulării (date, cache), citește-le cu
fs.readFileSyncsaufs.promises.readFileșiJSON.parse. - Nu presupune că ce merge în Vite sau webpack merge și direct în Node.
Întrebări frecvente
Am văzut și varianta cu assert { type: "json" }. E bună?
Nu mai e. assert a fost forma veche a propunerii și a fost scoasă din Node 22; acum dă SyntaxError: Unexpected identifier 'assert'. Forma standard este with.
De ce merge require("./date.json") fără nimic în plus?
Pentru că în CommonJS Node decide după extensie: .json e citit și parsat automat. Modulele ES au reguli mai stricte și cer atributul.
Erori înrudite
SyntaxError: Unexpected identifier 'assert' Folosești sintaxa veche import ... assert { type: "json" }, scoasă din Node 22. Înlocuiește cuvântul assert cu with: import config from "./config.json" with { type: "json" }. SyntaxError: /app/config.json: Expected double-quoted property name in JSON at position 59 (line 5 column 1) Fișierul JSON încărcat cu require are o greșeală de sintaxă: de obicei o virgulă după ultimul element, ghilimele simple sau un comentariu. Mesajul îți dă fișierul și linia; scoate virgula de la final și pune cheile între ghilimele duble. Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/app/utils/preturi.js' imported from /app/index.js Un import dintr-un modul ES arată spre un fișier care nu există: calea e greșită sau lipsește extensia. În modulele ES extensia este obligatorie: import x from "./preturi.js", nu "./preturi". Verifică dosarul și numele fișierului. Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
