...
Eroare Node.js · Proces, terminal și intrare de la tastatură

TypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'raport.txt'. This command does not take positional arguments

Pe scurt

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

Greșit
JavaScript
parseArgs({ options: { format: { type: "string" } } });
// comanda: node converteste.js raport.txt --format csv
Corect
JavaScript
const { values, positionals } = parseArgs({
  options: { format: { type: "string" } },
  allowPositionals: true,
});

Cu allowPositionals: true, raport.txt ajunge în tabloul positionals.

2Valoare după o opțiune boolean

Greșit
JavaScript
// verbose e boolean
node app.js --verbose da
Corect
JavaScript
node app.js --verbose

Opțiunile boolean nu iau valoare, deci da e tratat ca argument pozițional.

3Spațiu în plus în valoare

Greșit
JavaScript
node server.js --host 127.0.0.1 --port 80 80
Corect
JavaScript
node server.js --host 127.0.0.1 --port 8080

Al doilea 80 nu aparține niciunei opțiuni.

Repară tu

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.

Codul care dă eroarea
JavaScript
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);
}
După reparație, programul afișează
ianuarie.txt: 3 linii
februarie.txt: 2 linii
Indiciu

Adaugă allowPositionals: true și citește positionals din rezultat.

Alte forme ale mesajului

  • TypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'date.csv'. This command does not take positional arguments
  • TypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'da'. This command does not take positional arguments
  • code: '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

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