NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #91 most downloaded on npm
A querystring parser that supports nesting and arrays, with a depth limit
Latest stable
6.17.1
Last release 24 days ago
28 Oct 2026
Release timing varies
gaps range from 2 weeks to 12 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
16 years old
158 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
[Fix] parse: interpretNumericEntities: decode code points above U+FFFF as surrogate pairs
parse: interpretNumericEntities: decode code points above U+FFFF as surrogate pairs (#640)parse: respect plainObjects for [] with parseArrays: false (#639)utils: merge: count the elements of a sparse array against arrayLimit, not its holesparse: guard bracket-wrapped prototype keys at depth 0 (#638)parse: extract wrapping-bracket stripping helperdepth: 0 and depth: false keep keys flatparse: pin depth-0 bracket stripping and prototype keys kept by allowPrototypes/plainObjects[New] stringify: add WHATWG format
stringify: add WHATWG format (#623)stringify: do not sort the caller's filter array in place (#637)parse: copy an own __proto__ key as data (#636)parse: decode percent-encoded dots case-insensitively (#635)stringify: encode keys when allowEmptyArrays is set (#561)parse: preserve comma arrays when interpreting numeric entities (#630)parse: allow scalar fields with a zero array limit (#627)parse: do not count an existing comma array toward arrayLimit when duplicates discards or replaces itutils: encode: encode lone surrogates as U+FFFD instead of consuming the next code unit (#624)format argumenteslint, evalmd, npmignorestringify: pin allowEmptyArrays output for keys that need no encodingstringify: pin sort order for nested keys selected by an array filterparse: cover interpretNumericEntities across value shapes, keys, and the charset sentinelparse: cover more input that builds no array at a zero or negative arrayLimitparse: cover comma with a zero or negative arrayLimit, and combining a full comma arrayparse: pin the behavior of a zero or negative arrayLimitutils/stringify: pin ~, *, and parens encoding in RFC3986 and RFC1738Your coding agent can read these notes before it upgrades. Set up the MCP server →
[Fix] stringify: encode keys when allowEmptyArrays is set
stringify: encode keys when allowEmptyArrays is set (#561)evalmd, npmignorestringify: pin allowEmptyArrays output for keys that need no encoding[Fix] parse: do not mutate an object input
parse: do not mutate an object inputstringify: stop re-encoding structural separator dots when encodeDotInKeys is set (#564)stringify: arrayFormat: 'comma': pass the full encoder arguments with encodeValuesOnlyutils: encode + as %2B in iso-8859-1 mode so values round-trip (#565)stringify: ignore inherited array format names (#622)stringify: arrayFormat: 'comma': do not throw on elements with no callable toStringutils: merge: seed an overflow container's index from its own keys, not just the sourceutils: merge: keep a strictMerge conflict container's index and arrayLimit correctparse: only treat [] as array syntax when it ends the keydecode: skip decoders when there is no percent sign (#583)utils: merge: apply arrayLimit to the two-element array built for colliding valuesparse: bound the nesting added by repeated strictMerge conflicts (credit @Yeaseen)qs and flat parsers disagree about parameter namesthrowOnLimitExceeded limits each array, not the total number of valuescache-modeutils: decode: add missing casesparse: characterize the ]= split when an = precedes any bracket group (#620)parse: allowDots: cover stray close brackets before a dot@ljharb/eslint-config, eslint, tape[New] stringify: add a depth option to bound recursion depth (default Infinity)
stringify: add a depth option to bound recursion depth (default Infinity)parse: enforce arrayLimit on comma groups under []= when throwOnLimitExceeded is setparse: flatten a collection appended to an overflowed array (#571)utils: isBuffer: do not invoke a non-callable constructor.isBufferstringify: do not let allowEmptyArrays skip cycle detection (or drop own keys) on an empty array with own propertiesstringify: encode dots in a top-level key with a primitive value when encodeDotInKeys is set (#562)stringify deep-nesting DoS is caller-boundedarrayLimit is a representation threshold, not an element-count capparse: remove a test that pinned []= comma groups escaping arrayLimitstringify: pin current encodeDotInKeys separator-dot behavior@ljharb/eslint-config, eslinteslint, evalmd[Fix] stringify: encode keys when allowEmptyArrays is set
stringify: encode keys when allowEmptyArrays is set (#561)@ljharb/eslint-config, evalmd, npmignore, tapestringify: pin allowEmptyArrays output for keys that need no encoding[Fix] parse: enforce throwOnLimitExceeded for cumulative array growth via combine/merge
parse: enforce throwOnLimitExceeded for cumulative array growth via combine/mergeutils: respect encoding of surrogate pairs across chunks (#559)parse: throw the arrayLimit error before splitting oversized comma valuesutils.merge / utils.assign: avoid invoking __proto__ setter when copying own propertiesutils: enforce arrayLimit consistently across merge's array pathsutils: make compact O(n) via a side-channel visited-set instead of Array.indexOfside-channeleslint, mock-property, tapeparse: characterize current lenient handling of unbalanced bracket keys (#558)[Fix] stringify: skip null/undefined entries in arrayFormat: 'comma' + encodeValuesOnly instead of crashing in encoder
stringify: skip null/undefined entries in arrayFormat: 'comma' + encodeValuesOnly instead of crashing in encoderstringify: use configured delimiter after charsetSentinel (#555)stringify: apply formatter to encoded key under strictNullHandling (#554)stringify: skip null/undefined filter-array entries instead of crashing in encoder (#551)parse: handle nested bracket groups and add regression tests (#530); changes output for some unbalanced bracket keys (see #558)@ljharb/eslint-config[Fix] parse: parameterLimit: Infinity with throwOnLimitExceeded: true silently drops all parameters
parse: parameterLimit: Infinity with throwOnLimitExceeded: true silently drops all parameters@ljharb/eslint-config@ljharb/eslint-config, iconv-lite[New] parse: add strictMerge option to wrap object/primitive conflicts in an array (#425, #122)
parse: add strictMerge option to wrap object/primitive conflicts in an array (#425, #122)duplicates option should not apply to bracket notation keys (#514)[Fix] stringify: encode keys when allowEmptyArrays is set
stringify: encode keys when allowEmptyArrays is set (#561)side-channel@ljharb/eslint-config, es-value-fixtures, eslint, evalmd, mock-property, npmignore, tapestringify: pin allowEmptyArrays output for keys that need no encoding[Fix] parse: mark overflow objects for indexed notation exceeding arrayLimit
parse: mark overflow objects for indexed notation exceeding arrayLimit (#546)arrayLimit means max count, not max index, in combine/merge/parseArrayValueparse: throw on arrayLimit exceeded with indexed notation when throwOnLimitExceeded is true (#529)parse: enforce arrayLimit on comma-parsed valuesparse: fix error message to reflect arrayLimit as max index; remove extraneous comments (#545).push, use voidaddQueryPrefix does not add ? to empty output (#418)parseArrays and arrayLimit documentation (#543)arrayLength → arrayLimit)[Fix] ensure arrayLimit applies to [] notation as well
arrayLimit applies to [] notation as wellparse: when a custom decoder returns null for a key, ignore that keyparse: extract key segment splitting helperstringify: increase coverageeslint, @ljharb/eslint-config, npmignore, es-value-fixtures, for-each, object-inspect[New] parse: add throwOnParameterLimitExceeded option
parse: add throwOnParameterLimitExceeded option (#517)parse: use utils.combine moreparse: add explicit throwOnLimitExceeded defaultside-channeles-value-fixtures, has-bigints, has-proto, has-symbols[Fix] stringify: encode keys when allowEmptyArrays is set
stringify: encode keys when allowEmptyArrays is set (#561)side-channel@ljharb/eslint-config, es-value-fixtures, eslint, evalmd, for-each, has-symbols, mock-property, npmignore, object-inspect, tapestringify: pin allowEmptyArrays output for keys that need no encoding[Fix] fix regressions from robustness refactor [actions] update reusable workflows
[Fix] fix regressions from robustness refactor [actions] update reusable workflows
[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] stringify: avoid a crash when a filter key is null
stringify: avoid a crash when a filter key is nullutils.merge: functions should not be stringified into keysparse: avoid a crash with interpretNumericEntities: true, comma: true, and iso charsetstringify: ensure a non-string filter does not crash__proto__ syntax instead of Object.create for null objectsutils.merge: add some coveragees-value-fixtures, mock-property, object-inspect, tape[New] parse: add strictDepth option
parse: add strictDepth option (#511)npm audit instead of aud[Fix] stringify: encode keys when allowEmptyArrays is set
stringify: encode keys when allowEmptyArrays is set (#561)npm audit instead of audside-channel@ljharb/eslint-config, es-value-fixtures, eslint, evalmd, for-each, has-symbols, mock-property, npmignore, object-inspect, tapestringify: pin allowEmptyArrays output for keys that need no encoding[Fix] fix regressions from robustness refactor
[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] parse: properly account for strictNullHandling when allowEmptyArrays
parse: properly account for strictNullHandling when allowEmptyArrays[Fix] parse: parse encoded square brackets
parse: parse encoded square brackets (#506)[Fix] parse: Disable decodeDotInKeys by default to restore previous behavior
parse: Disable decodeDotInKeys by default to restore previous behavior (#501)utils: Optimize performance under large data volumes, reduce memory usage, and speed up processing (#502)utils: use +=[New] parse/stringify: add decodeDotInKeys/encodeDotKeys options
parse/stringify: add decodeDotInKeys/encodeDotKeys options (#488)parse: add duplicates optionparse/stringify: add allowEmptyArrays option to allow [] in object values (#487)parse/stringify: move allowDots config logic to its own variablestringify: move option-handling code into normalizeStringifyOptionsstringify: clarify default arrayFormat behaviorside-channelsideEffects flagparse: remove useless tests; add coveragestringify: increase coveragemock-propertystringify: improve coverage@ljharb/eslint-config , aud, has-override-mistake, has-property-descriptors, mock-property, npmignore, object-inspect, tapeglob, since v10.3.8+ requires a broken jackspeakjackspeak since 2.1.2+ depends on npm aliases, which kill the install process in npm < 6[Fix] fix regressions from robustness refactor
[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] parse: Fix parsing when the global Object prototype is frozen
parse: Fix parsing when the global Object prototype is frozen (#473)[Fix] stringify: encode comma values more consistently
stringify: encode comma values more consistently (#463)filter option for injecting custom serialization, i.e. of custom types (#447)@ljharb/eslint-config, aud, object-inspect, tape[New] [Fix] stringify: revert 0e903c0; add commaRoundTrip option
stringify: revert 0e903c0; add commaRoundTrip option (#442)[Fix] fix regressions from robustness refactor
[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] stringify: with arrayFormat: comma, properly include an explicit [] on a single-item array
stringify: with arrayFormat: comma, properly include an explicit [] on a single-item array (#434)[Fix] stringify: with arrayFormat: comma, include an explicit [] on a single-item array
stringify: with arrayFormat: comma, include an explicit [] on a single-item array (#441)npmignore to autogenerate an npmignore fileeslint, @ljharb/eslint-config, aud, has-symbol, object-inspect, tape[Fix] parse: ignore __proto__ keys
parse: ignore __proto__ keys (#428)stringify: avoid relying on a global undefined (#427)eslint, @ljharb/eslint-config, object-inspect, tape[Fix] stringify: actually fix cyclic references
stringify: actually fix cyclic references (#426)stringify: avoid encoding arrayformat comma when encodeValuesOnly = true (#424)eslint, @ljharb/eslint-config, aud, object-inspect, safe-publish-latest, tape[Fix] stringify: avoid exception on repeated object values
stringify: avoid exception on repeated object values (#402)[New] stringify: throw on cycles, instead of an infinite loop (#395, #394, #393)
stringify: throw on cycles, instead of an infinite loop (#395, #394, #393)parse: add allowSparse option for collapsing arrays with missing indices (#312)npm run dist in publish, not installeslint, @ljharb/eslint-config, aud, has-symbols, tapeljharb/actions/node/install instead of ljharb/actions/node/run[Fix] fix regressions from robustness refactor
npmignore to autogenerate an npmignore file[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] parse: ignore __proto__ keys
parse: ignore __proto__ keys (#428)stringify: avoid encoding arrayformat comma when encodeValuesOnly = true (#424)stringify: avoid relying on a global undefined (#427)[Fix] restore dist dir; mistakenly removed in d4f6c32
dist dir; mistakenly removed in d4f6c32[Fix] stringify: do not encode parens for RFC1738
stringify: do not encode parens for RFC1738stringify: fix arrayFormat comma with empty array/objects (#350)format: remove util.assign callpull_request_target eventstringify: add tests for #378nyc on all tests; use tape runnereslint, @ljharb/eslint-config, browserify, mkdirp, object-inspect, tape; add aud[Fix] stringify: when arrayFormat is comma, respect serializeDate
stringify: when arrayFormat is comma, respect serializeDate (#364)stringify: reduce branching (part of #350)maybeMap to utilsbrowserify, tape[Fix] proper comma parsing of URL-encoded commas
[Fix] parse: Fix parsing array from object with comma true
parse: Fix parsing array from object with comma true (#359)parse: throw a TypeError instead of an Error for bad charset (#349)eslint, @ljharb/eslint-config, object-inspect, has-symbols, tape, mkdirp, iconv-lite[Fix] parse: with comma true, handle field that holds an array of arrays
parse: with comma true, handle field that holds an array of arrays (#335)parse: with comma true, do not split non-string values (#334)funding fieldeslint, @ljharb/eslint-config[New] parse/stringify: Pass extra key/value argument to decoder
parse/stringify: Pass extra key/value argument to decoder (#333)eslint, @ljharb/eslint-config, evalmdparse: add passing arrayFormat testsposttest using npx aud to run npm audit without a lockfilenode v12.10, v11.15, v10.16, v8.16Buffer.from in node v5.0-v5.9 and v4.0-v4.4 requires a TypedArray[Fix] fix regressions from robustness refactor
npmignore to autogenerate an npmignore file[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] parse: ignore __proto__ keys
parse: ignore __proto__ keys (#428)stringify: avoid relying on a global undefined (#427)stringify: avoid encoding arrayformat comma when encodeValuesOnly = true (#424)stringify: reduce branching[Fix] proper comma parsing of URL-encoded commas
[Fix] parse: Fix parsing array from object with comma true
parse: Fix parsing array from object with comma true (#359)parse: throw a TypeError instead of an Error for bad charset (#349)parse: with comma true, handle field that holds an array of arrays (#335)parse: with comma true, do not split non-string values (#334)funding fieldeslint, @ljharb/eslint-config, tape, safe-publish-latest, evalmd, has-symbols, iconv-lite, mkdirp, object-inspectparse: add passing arrayFormat testsBuffer.from in node v5.0-v5.9 and v4.0-v4.4 requires a TypedArray[New] add depth=false to preserve the original key; [Fix] depth=0 should preserve the original key
depth=false to preserve the original key; [Fix] depth=0 should preserve the original key (#326)formats: tiny bit of cleanup.eslint, @ljharb/eslint-config, browserify, safe-publish-latest, iconv-lite, tapedepth=0 and depth=false behavior, both current and intuitive/intended (#326)eclint instead of editorconfig-tools[Fix] fix regressions from robustness refactor
npmignore to autogenerate an npmignore file[Robustness] avoid .push, use void
.push, use voidparseArrays and arrayLimit documentation (#543)addQueryPrefix does not add ? to empty output (#418)[Fix] parse: ignore __proto__ keys
parse: ignore __proto__ keys (#428)stringify: avoid encoding arrayformat comma when encodeValuesOnly = true (#424)stringify: avoid relying on a global undefined (#427)nyc for coverage[Fix] proper comma parsing of URL-encoded commas
[Fix] parse: Fix parsing array from object with comma true
parse: Fix parsing array from object with comma true (#359)parse: with comma true, handle field that holds an array of arrays (#335)parse: with comma true, do not split non-string values (#334)parse: throw a TypeError instead of an Error for bad charset (#349)formats: tiny bit of cleanup.funding fieldeslint, @ljharb/eslint-config, tape, safe-publish-latest, evalmd, iconv-lite, mkdirp, object-inspect, browserifyparse: add passing arrayFormat testsBuffer.from in node v5.0-v5.9 and v4.0-v4.4 requires a TypedArraydepth=0 and depth=false behavior, both current and intuitive/intendedeclint instead of editorconfig-toolsOne column per quarter.