TypeError [ERR_INVALID_ARG_VALUE]: The argument 'filename' must be a file URL object, file URL string, or absolute path string. Received undefined
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.filenamepe o versiune de Node mai veche de 20.11, unde nu există; - ai copiat
createRequire(__filename)dintr-un fișier CommonJS și ai înlocuit__filenamecu 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
import { createRequire } from "node:module";
const require = createRequire(import.meta.fileName);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
// Node 18
const require = createRequire(import.meta.filename);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ă
const require = createRequire("./index.js");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ă 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.
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}`);Magazin: Libraria Ana Port: 3000
Indiciu
Adresa fișierului curent într-un modul ES este import.meta.url.
Reparația
import { createRequire } from "node:module";
const require = createRequire(import.meta.url);
const config = require("./config.json");
console.log(`Magazin: ${config.nume}`);
console.log(`Port: ${config.port}`);De ce merge
createRequire are nevoie de adresa modulului curent ca să rezolve căile relative ca ./config.json. import.meta.fileName (cu N mare) nu există, deci argumentul era undefined. import.meta.url conține file:///.../index.js, iar require-ul creat caută config.json în același dosar cu index.js.
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 nullTypeError [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 înpackage.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
ReferenceError: require is not defined in ES module scope, you can use import instead Fișierul este modul ES (are import/export, extensia .mjs sau "type": "module" în package.json), iar în modulele ES require nu există. Înlocuiește require cu import: const fs = require("fs") devine import fs from "fs". ReferenceError: __dirname is not defined in ES module scope În modulele ES nu există __dirname și __filename. Folosește import.meta.dirname și import.meta.filename (Node 20.11+) sau calculează-le din import.meta.url cu fileURLToPath și path.dirname. 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. Î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.
