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

TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '--prot'

Pe scurt

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ă

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

Numele din comandă trebuie să fie identic cu cheia din options.

2Opțiune nedeclarată în cod

Greșit
JavaScript
parseArgs({ options: { port: { type: "string" } } });
// comanda: node server.js --port 8080 --verbose
Corect
JavaScript
parseArgs({
  options: {
    port: { type: "string" },
    verbose: { type: "boolean" },
  },
});

Fiecare opțiune acceptată trebuie descrisă în options.

3Scurtătură nedeclarată

Greșit
JavaScript
parseArgs({ options: { port: { type: "string" } } });
// comanda: node server.js -p 8080
Corect
JavaScript
parseArgs({ options: { port: { type: "string", short: "p" } } });

-p e acceptat doar dacă îl declari ca short al unei opțiuni.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Port: 8080
Detaliat: true
Indiciu

Adaugă în options: verbose: { type: "boolean" }.

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, cu short pentru scurtături.
  • Prinde eroarea și afișează un mesaj de ajutor cu opțiunile acceptate, apoi ieși cu process.exitCode = 1.
  • Folosește default pentru 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

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