...
Eroare Node.js · Module ES: import, export și "type": "module"

TypeError [ERR_IMPORT_ATTRIBUTE_MISSING]: Module "file:///app/date/produse.json" needs an import attribute of "type: json"

Pe scurt

Î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

Greșit
JavaScript
import produse from "./date/produse.json";
Corect
JavaScript
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

Greșit
JavaScript
import { port } from "./config.json" with { type: "json" };
Corect
JavaScript
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

Greșit
JavaScript
import setari from "./setari.json";
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Produse fără stoc: 2
- Ceai verde
- Cană
Indiciu

După calea fișierului adaugi with { type: "json" }.

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.json
  • TypeError [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.readFileSync sau fs.promises.readFile și JSON.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

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.