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

TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '-p, --port <value>' argument missing

Pe scurt

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

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

Ce înseamnă

La util.parseArgs, tipul opțiunii decide cum e citită:

  • type: "string": opțiunea trebuie urmată de o valoare (--port 8080 sau --port=8080);
  • type: "boolean": opțiunea e un comutator, fără valoare (--verbose).

Mesajul Option '-p, --port <value>' argument missing apare când o opțiune de tip string e ultima din comandă sau e urmată direct de altă opțiune (--port --verbose). Partea <value> din mesaj îți amintește că opțiunea cere o valoare, iar -p, --port arată și scurtătura declarată.

Cazul invers dă același cod, cu alt mesaj: Option '--verbose' does not take an argument, când dai o valoare (--verbose=da) unei opțiuni boolean.

De ce apare: cauzele frecvente

1Valoarea lipsește din comandă

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

O opțiune de tip string are nevoie de o valoare imediat după ea.

2Comutator declarat ca string

Greșit
JavaScript
options: { verbose: { type: "string" } }
// comanda: node app.js --verbose
Corect
JavaScript
options: { verbose: { type: "boolean" } }

Un comutator (activ / inactiv) e boolean și nu cere valoare.

3Valoare dată unui boolean

Greșit
JavaScript
options: { verbose: { type: "boolean" } }
// comanda: node app.js --verbose=da
Corect
JavaScript
// comanda: node app.js --verbose

Opțiunile boolean nu primesc valoare; prezența lor înseamnă true.

Repară tu

Repară eroarea, direct în pagină

Scriptul de export are opțiunea --comprima, care ar trebui să fie un simplu comutator, dar e declarată cu type: "string". Comanda --format csv --comprima se oprește cu Option '-c, --comprima <value>' argument missing. Declară opțiunea corect, ca scriptul să afișeze formatul și dacă se comprimă.

Codul care dă eroarea
JavaScript
const { parseArgs } = require("util");

// în terminal: node export.js --format csv --comprima
const args = ["--format", "csv", "--comprima"];

const { values } = parseArgs({
  args,
  options: {
    format: { type: "string", short: "f", default: "json" },
    comprima: { type: "string", short: "c" },
  },
});

console.log(`Format: ${values.format}`);
console.log(`Comprimare: ${values.comprima === true ? "da" : "nu"}`);
După reparație, programul afișează
Format: csv
Comprimare: da
Indiciu

Un comutator fără valoare are type: "boolean".

Alte forme ale mesajului

  • TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '--port <value>' argument missing
  • TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '--verbose' does not take an argument
  • TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '-o, --output <value>' argument is ambiguous. Did you forget to specify the option argument for '-o'? To specify an option argument starting with a dash use '--output=-XYZ' or '-o-XYZ'.

Cum o eviți pe viitor

  • Alege tipul după cum se folosește opțiunea: comutator = boolean, valoare = string.
  • Dă valori implicite cu default, ca utilizatorul să poată omite opțiunea complet.
  • Prinde eroarea și afișează exemple de folosire (Exemplu: node server.js --port 8080).
  • Pentru numere, convertește valoarea după citire (Number(values.port)): parseArgs întoarce doar string-uri și boolean-uri.

Întrebări frecvente

Pot face o opțiune cu valoare opțională?

Nu direct în parseArgs. Fie o declari string cu default, fie folosești două opțiuni (--log boolean și --log-file string).

De ce --port --verbose dă argument missing?

Pentru că --verbose începe cu - și e tratat ca opțiune separată, nu ca valoarea lui --port. Dacă valoarea chiar începe cu -, scrie --port=-1.

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.