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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
util.parseArgs({ args, options }) citește argumentele din linia de comandă (implicit process.argv.slice(2)) după o descriere: fiecare opțiune are un nume, un tip ("string" sau "boolean") și opțional o literă scurtă (short: "p").
În modul implicit, strict: true, orice opțiune necunoscută oprește programul cu ERR_PARSE_ARGS_UNKNOWN_OPTION. E un lucru bun: o greșeală ca --prot 8080 nu trece neobservată, iar serverul nu pornește pe portul implicit fără să afli.
Mesajul spune exact opțiunea necunoscută ('--prot'). Uneori adaugă și un sfat: dacă voiai un argument normal care începe cu -, pune-l după --. Verifică lista options din cod și comanda scrisă în terminal sau în package.json (scripts).
De ce apare: cauzele frecvente
1Opțiune scrisă greșit în comandă
node server.js --prot 8080node server.js --port 8080Numele din comandă trebuie să fie identic cu cheia din options.
2Opțiune nedeclarată în cod
parseArgs({ options: { port: { type: "string" } } });
// comanda: node server.js --port 8080 --verboseparseArgs({
options: {
port: { type: "string" },
verbose: { type: "boolean" },
},
});Fiecare opțiune acceptată trebuie descrisă în options.
3Scurtătură nedeclarată
parseArgs({ options: { port: { type: "string" } } });
// comanda: node server.js -p 8080parseArgs({ options: { port: { type: "string", short: "p" } } });-p e acceptat doar dacă îl declari ca short al unei opțiuni.
Repară eroarea, direct în pagină
Scriptul de pornire primește argumentele --port 8080 --verbose, dar în options e declarată doar opțiunea port, așa că util.parseArgs se oprește cu Unknown option '--verbose'. Declară și opțiunea verbose (de tip boolean), ca scriptul să afișeze portul și modul detaliat.
const { parseArgs } = require("util");
// în terminal: node server.js --port 8080 --verbose
const args = ["--port", "8080", "--verbose"];
const { values } = parseArgs({
args,
options: {
port: { type: "string", default: "3000" },
},
});
console.log(`Port: ${values.port}`);
console.log(`Detaliat: ${values.verbose === true}`);Port: 8080 Detaliat: true
Indiciu
Adaugă în options: verbose: { type: "boolean" }.
Reparația
const { parseArgs } = require("util");
// în terminal: node server.js --port 8080 --verbose
const args = ["--port", "8080", "--verbose"];
const { values } = parseArgs({
args,
options: {
port: { type: "string", default: "3000" },
verbose: { type: "boolean", default: false },
},
});
console.log(`Port: ${values.port}`);
console.log(`Detaliat: ${values.verbose === true}`);De ce merge
În modul strict (implicit), parseArgs acceptă doar opțiunile descrise în options și oprește programul la orice altceva, ca să prindă greșelile de scriere. După ce declari verbose ca boolean, --verbose devine values.verbose = true, iar port primește valoarea "8080" din argumente în locul celei implicite.
Alte forme ale mesajului
TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '-p'TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '--prot'. To specify a positional argument starting with a '-', place it at the end of the command after '--', as in '-- "--prot"TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '--verbose'
Cum o eviți pe viitor
- Declară toate opțiunile în
options, cushortpentru scurtături. - Prinde eroarea și afișează un mesaj de ajutor cu opțiunile acceptate, apoi ieși cu
process.exitCode = 1. - Folosește
defaultpentru valorile implicite (port: { type: "string", default: "3000" }). - Pune comenzile frecvente în
package.json("start": "node server.js --port 8080") ca să nu le scrii de mână.
Întrebări frecvente
Ce face strict: false?
Acceptă orice opțiune: cele necunoscute apar în values cu valoarea true sau cu valoarea dată. E util pentru scripturi care trimit opțiunile mai departe, dar pierzi verificarea greșelilor de scriere.
Din ce versiune există util.parseArgs?
A apărut în Node 18.3 și 16.17 și e stabil din Node 20. În versiunile mai vechi, util.parseArgs e undefined și primești parseArgs is not a function.
Erori înrudite
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". 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.
