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

TypeError [ERR_INVALID_ARG_VALUE]: The argument 'filename' must be a file URL object, file URL string, or absolute path string. Received undefined

Pe scurt

createRequire() a primit undefined în loc de adresa fișierului curent. Într-un modul ES apelează createRequire(import.meta.url): import.meta.url există în toate versiunile, spre deosebire de import.meta.filename (abia din Node 20.11) sau de o proprietate scrisă greșit.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

createRequire din node:module îți dă o funcție require într-un modul ES, de exemplu ca să încarci un fișier JSON sau un pachet CommonJS vechi. Are nevoie să știe față de ce fișier rezolvă căile relative, așa că primește adresa modulului curent: un URL file://, un string file://... sau o cale absolută.

Mesajul spune că argumentul filename a fost undefined (sau alt lucru nepotrivit, de exemplu o cale relativă). Cel mai des:

  • proprietatea e scrisă greșit (import.meta.fileName, import.meta.file);
  • folosești import.meta.filename pe o versiune de Node mai veche de 20.11, unde nu există;
  • ai copiat createRequire(__filename) dintr-un fișier CommonJS și ai înlocuit __filename cu ceva greșit.

Linia din stivă (at file:///app/index.js:2:17) arată apelul createRequire.

De ce apare: cauzele frecvente

1Proprietate scrisă greșit

Greșit
JavaScript
import { createRequire } from "node:module";
const require = createRequire(import.meta.fileName);
Corect
JavaScript
import { createRequire } from "node:module";
const require = createRequire(import.meta.url);

import.meta.fileName nu există, deci e undefined. import.meta.url (de forma file:///app/index.js) e acceptat direct.

2import.meta.filename pe Node vechi

Greșit
JavaScript
// Node 18
const require = createRequire(import.meta.filename);
Corect
JavaScript
const require = createRequire(import.meta.url);

import.meta.filename și import.meta.dirname au apărut în Node 20.11. import.meta.url merge peste tot.

3Cale relativă în loc de absolută

Greșit
JavaScript
const require = createRequire("./index.js");
Corect
JavaScript
const require = createRequire(import.meta.url);

O cale relativă e refuzată cu aceeași eroare (Received './index.js'), pentru că nu se știe față de ce dosar e relativă.

Repară tu

Repară eroarea, direct în pagină

Modulul ES de mai jos vrea să încarce config.json cu un require creat prin createRequire, dar îi dă import.meta.fileName, care nu există, și primește ERR_INVALID_ARG_VALUE. Repară apelul ca programul să afișeze numele magazinului și portul.

Codul care dă eroarea
JavaScript
import { createRequire } from "node:module";

const require = createRequire(import.meta.fileName);
const config = require("./config.json");

console.log(`Magazin: ${config.nume}`);
console.log(`Port: ${config.port}`);
După reparație, programul afișează
Magazin: Libraria Ana
Port: 3000
Indiciu

Adresa fișierului curent într-un modul ES este import.meta.url.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'filename' must be a file URL object, file URL string, or absolute path string. Received './index.js'
  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'filename' must be a file URL object, file URL string, or absolute path string. Received null
  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'filename' must be a file URL object, file URL string, or absolute path string. Received 'index.js'

Cum o eviți pe viitor

  • Folosește mereu forma standard: const require = createRequire(import.meta.url);.
  • Pentru JSON într-un modul ES poți renunța la createRequire: import date from "./date.json" with { type: "json" };.
  • Dacă folosești import.meta.filename / import.meta.dirname, cere în package.json "engines": { "node": ">=20.11" }.
  • Lasă editorul să-ți completeze proprietățile lui import.meta.

Întrebări frecvente

Când am nevoie de createRequire?

Când într-un modul ES vrei sincron un fișier JSON, un pachet CommonJS care nu merge cu import sau require.resolve. Pentru restul, import e de ajuns.

Merge și cu new URL(import.meta.url)?

Da, un obiect URL file: e acceptat la fel ca string-ul. Important e să fie adresa fișierului curent, nu a dosarului.

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.