{"record":{"id":"562dba21df6b8f94","repo":"quasarframework/quasar","slug":"err-parse-args-unknown-option-562dba","errorCode":"ERR_PARSE_ARGS_UNKNOWN_OPTION","errorMessage":"Unknown error while parsing arguments","messagePattern":"Unknown error while parsing arguments","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cli/lib/get-argv.js","lineNumber":20,"sourceCode":"import { warn } from './logger.js'\n\nexport function getArgv(options, { strict = true } = {}) {\n  try {\n    const { values, positionals } = parseArgs({\n      options,\n      strict,\n      allowPositionals: true\n    })\n\n    return { ...values, _: positionals }\n  } catch (err) {\n    return {\n      help: true,\n      _: [],\n\n      // Should be handled if (argv.help) in the caller\n      __warn() {\n        warn(\n          err?.code === 'ERR_PARSE_ARGS_UNKNOWN_OPTION'\n            ? err.message\n            : 'Unknown error while parsing arguments'\n        )\n        warn()\n        process.exit(1)\n      }\n    }\n  }\n}\n","sourceCodeStart":2,"sourceCodeEnd":31,"githubUrl":"https://github.com/quasarframework/quasar/blob/4841521b5f635a971eb9e2710e5542efd194691b/cli/lib/get-argv.js#L2-L31","documentation":"The Quasar CLI's get-argv wraps util.parseArgs the same way as app-vite: on a parse failure it returns a sentinel argv whose __warn() prints the parseArgs message for ERR_PARSE_ARGS_UNKNOWN_OPTION (an unrecognized flag) or this generic fallback, then exits 1. It applies to all `quasar` CLI subcommands' argument parsing.","triggerScenarios":"Passing an option unknown to the chosen `quasar <cmd>` subcommand (e.g. `quasar build --dev`), or any other unexpected parseArgs rejection (malformed flag syntax like `--=value`).","commonSituations":"Typos in flags; mixing options between subcommands (`quasar dev` options used with `quasar build`); outdated docs/blog flags for older CLI versions; shorthand typos like `-P` instead of `-p`.","solutions":["Run `quasar <cmd> --help` (or `quasar help <cmd>`) to list valid options","Correct or remove the unknown flag; verify the flag belongs to that subcommand","Consult the current Quasar CLI docs — option sets differ between commands and versions","Quote or escape values with spaces/special characters"],"exampleFix":"// before\nquasar build --dev\n// after\nquasar build\n// or: quasar dev","handlingStrategy":"validation","validationCode":"// validate flags before scripting quasar CLI calls\nconst { execSync } = require('node:child_process')\nconst help = execSync('quasar build --help').toString()\nconst flag = '--mode'\nif (!help.includes(flag)) {\n  throw new Error(`Flag ${flag} is not supported by 'quasar build'`)\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run `quasar <cmd> --help` or `quasar help <cmd>` before using unfamiliar flags","Verify each flag belongs to the exact subcommand you're invoking","Watch for flag changes when upgrading Quasar CLI major versions","Quote values with spaces (e.g. `--theme \"my theme\"`) so tokens parse correctly"],"tags":["cli","arguments","parseargs","quasar-cli"],"backgroundTag":"unknown-cli-option","analyzedSha":"4841521b5f635a971eb9e2710e5542efd194691b","analyzedAt":"2026-08-30T01:13:14.944Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}