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".
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 8080sau--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ă
node server.js --portnode server.js --port 8080O opțiune de tip string are nevoie de o valoare imediat după ea.
2Comutator declarat ca string
options: { verbose: { type: "string" } }
// comanda: node app.js --verboseoptions: { verbose: { type: "boolean" } }Un comutator (activ / inactiv) e boolean și nu cere valoare.
3Valoare dată unui boolean
options: { verbose: { type: "boolean" } }
// comanda: node app.js --verbose=da// comanda: node app.js --verboseOpțiunile boolean nu primesc valoare; prezența lor înseamnă true.
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ă.
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"}`);Format: csv Comprimare: da
Indiciu
Un comutator fără valoare are type: "boolean".
Reparația
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: "boolean", short: "c", default: false },
},
});
console.log(`Format: ${values.format}`);
console.log(`Comprimare: ${values.comprima === true ? "da" : "nu"}`);De ce merge
Cu type: "string", parseArgs cere o valoare după --comprima, iar comanda nu are nimic după ea, deci primești argument missing. Declarată boolean, opțiunea devine un comutator: simpla ei prezență înseamnă true, iar default: false acoperă cazul în care lipsește. --format csv rămâne string și înlocuiește valoarea implicită json.
Alte forme ale mesajului
TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '--port <value>' argument missingTypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '--verbose' does not take an argumentTypeError [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
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_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). TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received type string ('eroare') process.exit() și process.exitCode primesc un cod numeric: 0 înseamnă succes, orice altceva (de obicei 1) înseamnă eroare. De la Node 20, un text ca "eroare" nu mai e acceptat. Afișează mesajul cu console.error și ieși cu process.exit(1), sau setează process.exitCode = 1. Î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.
