TypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'raport.txt'. This command does not take positional arguments
util.parseArgs a primit un argument fără -- în față (de exemplu un nume de fișier), dar nu i-ai permis argumente poziționale. Adaugă allowPositionals: true și citește-le din positionals, sau transformă argumentul într-o opțiune (--fisier raport.txt).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Argumentele din linia de comandă sunt de două feluri: opțiuni (--port 8080, -v) și argumente poziționale (raport.txt, date.csv), care contează după poziția lor.
În modul strict, util.parseArgs nu acceptă poziționale decât dacă îi spui explicit, cu allowPositionals: true. Altfel, primul argument care nu e opțiune oprește programul cu ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL, iar mesajul arată argumentul ('raport.txt').
Mai apare când o valoare ajunge separată de opțiunea ei: de exemplu --verbose da, unde --verbose e boolean (nu ia valoare), iar da rămâne un argument pozițional nepermis. La fel --port 80 80, cu un spațiu în plus.
De ce apare: cauzele frecvente
1Fișiere date ca argumente simple
parseArgs({ options: { format: { type: "string" } } });
// comanda: node converteste.js raport.txt --format csvconst { values, positionals } = parseArgs({
options: { format: { type: "string" } },
allowPositionals: true,
});Cu allowPositionals: true, raport.txt ajunge în tabloul positionals.
2Valoare după o opțiune boolean
// verbose e boolean
node app.js --verbose danode app.js --verboseOpțiunile boolean nu iau valoare, deci da e tratat ca argument pozițional.
3Spațiu în plus în valoare
node server.js --host 127.0.0.1 --port 80 80node server.js --host 127.0.0.1 --port 8080Al doilea 80 nu aparține niciunei opțiuni.
Repară eroarea, direct în pagină
Scriptul numara.js primește numele fișierelor de numărat și opțiunea --detaliat, dar parseArgs nu permite argumente poziționale și se oprește cu Unexpected argument 'ianuarie.txt'. Permite-le și numără liniile fiecărui fișier din positionals.
const fs = require("fs");
const { parseArgs } = require("util");
// în terminal: node numara.js ianuarie.txt februarie.txt --detaliat
const args = ["ianuarie.txt", "februarie.txt", "--detaliat"];
const { values, positionals = [] } = parseArgs({
args,
options: { detaliat: { type: "boolean", default: false } },
});
for (const fisier of positionals) {
const linii = fs.readFileSync(fisier, "utf8").trim().split("\n").length;
console.log(values.detaliat ? `${fisier}: ${linii} linii` : linii);
}ianuarie.txt: 3 linii februarie.txt: 2 linii
Indiciu
Adaugă allowPositionals: true și citește positionals din rezultat.
Reparația
const fs = require("fs");
const { parseArgs } = require("util");
// în terminal: node numara.js ianuarie.txt februarie.txt --detaliat
const args = ["ianuarie.txt", "februarie.txt", "--detaliat"];
const { values, positionals } = parseArgs({
args,
options: { detaliat: { type: "boolean", default: false } },
allowPositionals: true,
});
for (const fisier of positionals) {
const linii = fs.readFileSync(fisier, "utf8").trim().split("\n").length;
console.log(values.detaliat ? `${fisier}: ${linii} linii` : linii);
}De ce merge
În modul strict, parseArgs acceptă argumente fără -- doar dacă îi spui asta cu allowPositionals: true. Atunci numele fișierelor ajung, în ordine, în positionals, iar --detaliat rămâne o opțiune boolean, chiar dacă vine după ele. Scriptul citește fiecare fișier și afișează numărul de linii.
Alte forme ale mesajului
TypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'date.csv'. This command does not take positional argumentsTypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'da'. This command does not take positional argumentscode: 'ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL'
Cum o eviți pe viitor
- Hotărăște de la început dacă scriptul primește fișiere ca argumente și pune
allowPositionals: true. - Verifică după citire numărul de poziționale (
if (positionals.length === 0) ...) și afișează un mesaj de ajutor. - Valorile cu spații le pui între ghilimele în terminal:
--titlu "Raport lunar".
Întrebări frecvente
Unde ajung argumentele poziționale?
În tabloul positionals din rezultat, în ordinea din comandă: const { values, positionals } = parseArgs({ ..., allowPositionals: true }).
Ce înseamnă -- într-o comandă?
Tot ce urmează după -- e tratat ca argument pozițional, chiar dacă începe cu -. E util pentru nume de fișiere ciudate sau pentru a trimite argumente mai departe (npm run start -- --port 8080).
Erori înrudite
TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '--prot' util.parseArgs a primit o opțiune care nu e definită în options, de obicei scrisă greșit (--prot în loc de --port) sau nedeclarată. Adaugă opțiunea în options ori corectează comanda; dacă vrei să accepți și opțiuni necunoscute, pune strict: false. TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '-p, --port <value>' argument missing Opțiunea e declarată cu type: "string", deci așteaptă o valoare după ea, dar comanda nu i-a dat-o (node server.js --port). Scrie valoarea (--port 8080 sau --port=8080), iar dacă opțiunea e doar un comutator, declar-o cu type: "boolean". Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. Î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.
