NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #60 most downloaded on npm
the mighty option parser used by yargs
Last release 1 years ago
26 May 2025
Ships unpredictably
gaps range from 8 days to 2.8 years
Most releases are documented
notes for 49 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
84 releases · first in 2016
## 22.0.0 (2025-05-26) ### ⚠ BREAKING CHANGES * yargs is now ESM first (#503) ### Features * yargs is now ESM first
One column per quarter.
allow the browser build to be imported
21.0.1 (2022-02-27) Bug Fixes return deno env object
build: fixed automated release pipeline
### Bug Fixes * deno: force relese for Deno
populate--: -- should always be array
do not lowercase camel cased string
deno: address import issues in Deno
exports: node 13.0 and 13.1 require the dotted object form _with_ a string fallback
exports: node 13.0-13.6 require a string fallback
deno: update types for deno ^1.4.0
string-utils: export looksLikeNumber helper
adds parse-positional-numbers configuration
### Bug Fixes * build: fixing publication
build: push tag created for deno
ts: projects using @types/yargs-parser may see variations in type definitions.
@types/yargs-parser may see variations in type definitions.Nothing published for this version
Nothing published for this version
This is a pre-release for testing purposes of #279.
This is a pre-release for testing purposes of #279.
Install by running npm install yargs-parser@next
This is a pre-release for testing purposes of #279.
This is a pre-release for testing purposes of #279.
Install by running npm install yargs-parser@next
setArg: options using camel-case and dot-notation populated twice
array, nargs: support -o=--value and --option=--value format
\_\_proto\_\_ will now be replaced with \_\_\_proto\_\_\_ in parse (#258), patching a potential prototype pollution vulnerability. This was reported b…
Nothing published for this version
introduce single-digit boolean aliases
the narg count is now enforced when parsing arrays.
introduce greedy-arrays config, for specifying whether arrays consume multiple positionals
normalized keys were not enumerable
this reverts parsing behavior of booleans to that of yargs@14
populate error if incompatible narg/count or array/count options are used
Nothing published for this version
build: should use releases_created when using manifest
perf: address slow parse when using unknown-options-as-args
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
convert values to strings when tokenizing
Nothing published for this version
don't coerce number from string with leading '0' or '+'
Nothing published for this version
better handling of quoted strings
undefined.<a name="11.1.1"></a>
<a name="11.1.0"></a>
Nothing published for this version
add halt-at-non-option configuration option
flatten-duplicate-arrays:false for more than 2 arrays
<a name="10.1.0"></a>
add set-placeholder-key configuration
do not set boolean flags if not defined in argv
boolean flags defined without a default value will now behave like other option type and won't be set in the parsed results when the user doesn't set the corresponding CLI arg.Previous behavior:
var parse = require('yargs-parser');
parse('--flag', {boolean: ['flag']});
// => { _: [], flag: true }
parse('--no-flag', {boolean: ['flag']});
// => { _: [], flag: false }
parse('', {boolean: ['flag']});
// => { _: [], flag: false }
New behavior:
var parse = require('yargs-parser');
parse('--flag', {boolean: ['flag']});
// => { _: [], flag: true }
parse('--no-flag', {boolean: ['flag']});
// => { _: [], flag: false }
parse('', {boolean: ['flag']});
// => { _: [] } => flag not set similarly to other option type
<a name="9.0.2"></a>
<a name="9.0.1"></a>
<a name="9.0.0"></a>
Nothing published for this version
Nothing published for this version
narg arguments no longer consume flag arguments
ensure consistent parsing of dot-notation arguments
<a name="8.0.0"></a>
Ignore multiple spaces between arguments.
populate-- now defaults to false.
Nothing published for this version
environment variables should take precedence over config file
<a name="5.0.0"></a>
security: address GHSA-p9pc-299p-vxgp
environment variables should take precedence over config file
<a name="4.2.1"></a>
<a name="4.2.0"></a>
Your coding agent can read these notes before it upgrades. Set up the MCP server →