NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #1861 most downloaded on npm
Parse and stringify URL query strings
Latest stable
10.0.0
Last release 1 months ago
21 Oct 2026
Release timing varies
gaps range from 9 days to 8 months
Nearly every release is documented
notes for 57 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
93 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
stringify() now throws a TypeError for values it cannot represent, like objects, functions, symbols, and Date 99d9c07
stringify() now throws a TypeError for values it cannot represent, like objects, functions, symbols, and Date 99d9c07
{a: {}} became a=%5Bobject%20Object%5D. Use the replacer option to convert such values.parse() now collects a repeated key into an array with every arrayFormat 27018f4 a6d6a7f
bracket, index, colon-list-separator, bracket-separator, comma, and separator kept only the last value, so foo=1&foo=2 gave {foo: '2'}.types entry now always takes precedence over parseNumbers and parseBooleans, and a value that does not match its type stays a string 04649de f48a249string[] and number[] types now always give an array (except with arrayFormat: 'none', as documented) 04649de 2a6984fU+FFFD, like URLSearchParams, instead of being kept as-is 19331dearrayFormat: 'bracket-separator' no longer splits on a percent-encoded separator, like comma and separator (#398) deb9784
foo[]=a%2Cb,c now gives ['a,b', 'c'].stringifyUrl() now percent-encodes % in fragmentIdentifier 1602ae0
parseUrl(). If you passed an already encoded fragment identifier, pass it decoded.pick() and exclude() now write the kept parameters back exactly as they were in the URL 1646c64 e087ca9 a7391f2
parseNumbers, parseBooleans, types, and decode only change the value the filter receives. Before, pick('https://foo.bar?id=007', ['id'], {parseNumbers: true}) gave id=7.decode-uri-component dependency and decode in linear time 19331de
parse() being quadratic for a key that repeats many times with arrayFormat: 'comma' and 'separator' 00a52ffparseNumbers, parseBooleans, and types options, also for parseUrl(), pick(), and exclude() d239f4f 472777f 789fc36undefined now uses its default value 1646c64stringify() output that did not parse back to the same value 13bc381 b63dc56 deb9784
- or . inside a value, null items with colon-list-separator, and arrays that became empty after skipping items with bracket-separator.stringify() throwing URIError for a string with a lone surrogate b9ff3f8sort option 220906a 678ddff 6c6506d
sort: true threw in stringify(), parse() threw when sort was not a boolean or a function, sort: false broke arrayFormat: 'index', and pick() ignored sort: false.stringifyUrl() turning an index format array that is already in the URL into [object Object] (#422) 220906astringifyUrl(), pick(), and exclude() corrupting the query and the fragment identifier with encode: false 7268b7a c75c681stringifyUrl() changing the parameters that are already in the URL when you give it parse options 93c3e1eparseUrl() and stringifyUrl() keeping leading and trailing whitespace 1d91dbf 93c3e1eparse() throwing for arrayFormat: 'index' when a plain value comes before the indexed entries 8e9d58dparse() using types keys inherited from Object.prototype, like toString (#421) 0682872stringify() ignoring the replacer result for skipNull and skipEmptyString 42210eastringify() reading each value twice, which ran getters and Proxy traps two times 5e50210stringifyUrl() not accepting an interface for query cd042b8https://github.com/sindresorhus/query-string/compare/v9.5.1...v10.0.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix stringifyUrl() dropping a leading # in the fragment identifier and throwing on some absolute URLs 47b5b30
stringifyUrl() dropping a leading # in the fragment identifier and throwing on some absolute URLs 47b5b30https://github.com/sindresorhus/query-string/compare/v9.5.0...v9.5.1
https://github.com/sindresorhus/query-string/compare/v9.4.1...v9.5.0
https://github.com/sindresorhus/query-string/compare/v9.4.1...v9.5.0
Fix relative URLs with fragments 872fb6f
https://github.com/sindresorhus/query-string/compare/v9.4.0...v9.4.1
https://github.com/sindresorhus/query-string/compare/v9.3.1...v9.4.0
https://github.com/sindresorhus/query-string/compare/v9.3.1...v9.4.0
Fix custom type functions with array formats 720f2ff
https://github.com/sindresorhus/query-string/compare/v9.3.0...v9.3.1
Add `replacer` option to stringify() 509014d
replacer option to stringify() 509014dhttps://github.com/sindresorhus/query-string/compare/v9.2.2...v9.3.0
Accept valueless parameters as true when using a boolean with types option (#410) 557a550
true when using a boolean with types option (#410) 557a550https://github.com/sindresorhus/query-string/compare/v9.2.1...v9.2.2
Fix stringifyUrl not respecting passed in options 38dae7b
stringifyUrl not respecting passed in options 38dae7bhttps://github.com/sindresorhus/query-string/compare/v9.2.0...v9.2.1
Add support for boolean type in the types option (#407) 10d263a
boolean type in the types option (#407) 10d263ahttps://github.com/sindresorhus/query-string/compare/v9.1.2...v9.2.0
Fix types option with arrayFormat: comma and one item in array (#406) 3e61882
types option with arrayFormat: comma and one item in array (#406) 3e61882https://github.com/sindresorhus/query-string/compare/v9.1.1...v9.1.2
Fix arrayFormat bracket-separator with a URL encoded value (#392) 19c43d4
arrayFormat bracket-separator with a URL encoded value (#392) 19c43d4https://github.com/sindresorhus/query-string/compare/v9.1.0...v9.1.1
Add `types` option to the .parse() method (#385) 672eb82
types option to the .parse() method (#385) 672eb82https://github.com/sindresorhus/query-string/compare/v9.0.0...v9.1.0
Fix passing empty fragmentIdentifier to stringifyUrl() cc232cb
fragmentIdentifier to stringifyUrl() cc232cbhttps://github.com/sindresorhus/query-string/compare/v8.2.0...v9.0.0
Allow BigInt as stringifiable value in the types (#377) 7f84490
https://github.com/sindresorhus/query-string/compare/v8.1.0...v8.2.0
Upgrade dependencies (#365) 20cc109
https://github.com/sindresorhus/query-string/compare/v8.0.3...v8.1.0
Fix typo in a TypeScript type 7bba5bb
https://github.com/sindresorhus/query-string/compare/v8.0.2...v8.0.3
Improve compatibility with bundlers (#361) 81f78e6
https://github.com/sindresorhus/query-string/compare/v8.0.1...v8.0.2
Fix TypeScript compatibility 76f8fc5
https://github.com/sindresorhus/query-string/compare/v8.0.0...v8.0.1
This package is now pure ESM. Please [read this](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
"module": "node16", "moduleResolution": "node16" to your tsconfig.json. (Example)fragmentIdentifier (#355) 16a7b8fhttps://github.com/sindresorhus/query-string/compare/v7.1.3...v8.0.0
Update dependencies (#354) e60e797
https://github.com/sindresorhus/query-string/compare/v7.1.2...v7.1.3
Update dependency (#353) d2c3596
https://github.com/sindresorhus/query-string/compare/v7.1.1...v7.1.2
Fix ParsedQuery type to allow null in array (#338) 5331579
ParsedQuery type to allow null in array (#338) 5331579https://github.com/sindresorhus/query-string/compare/v7.1.0...v7.1.1
Add support for parameters with an explicit :list marker (#335) 6d220e6
:list marker (#335) 6d220e6https://github.com/sindresorhus/query-string/compare/v7.0.1...v7.1.0
Don't encode the fragment identifier in .pick and .exclude (#320) fd3e779
.pick and .exclude (#320) fd3e779https://github.com/sindresorhus/query-string/compare/v7.0.0...v7.0.1
This is a breaking change to the default functionality of .stringify() for comma and separator array modes given that skipNull and skipEmptyString are…
.stringify() for comma and separator array modes given that skipNull and skipEmptyString are default false but the original functionality of .stringify() for these 2 modes behaved as though skipNull and skipEmptyString were true.arrayFormat: 'bracket-separator' (#276) b10bc19https://github.com/sindresorhus/query-string/compare/v6.14.1...v7.0.0
Fix TypeScript type for stringifyUrl() a6d4a3f
stringifyUrl() a6d4a3fhttps://github.com/sindresorhus/query-string/compare/v6.14.0...v6.14.1
Add `.pick()` and `.exclude()` (#282) 6ed5cb3
.pick() and .exclude() (#282) 6ed5cb3https://github.com/sindresorhus/query-string/compare/v6.13.8...v6.14.0
Work around TypeScript bug 94ebcd4
https://github.com/sindresorhus/query-string/compare/v6.13.7...v6.13.8
Allow readonly Stringifiable[] in StringifiableRecord (#291) 71d84b7
Stringifiable[] in StringifiableRecord (#291) 71d84b7https://github.com/sindresorhus/query-string/compare/v6.13.6...v6.13.7
When only receiving values with encoded array value, decode values (#287) b38f06c
https://github.com/sindresorhus/query-string/compare/v6.13.5...v6.13.6
Allow null and undefined in Stringifiable TypeScript type (#281) df4cbb3
null and undefined in Stringifiable TypeScript type (#281) df4cbb3https://github.com/sindresorhus/query-string/compare/v6.13.4...v6.13.5
Fix the TypeScript types for .stringify() and .stringifyUrl() (#279) 38906bc
.stringify() and .stringifyUrl() (#279) 38906bchttps://github.com/sindresorhus/query-string/compare/v6.13.3...v6.13.4
Fix the TypeScript type for the .stringifyUrl() method b15f945
.stringifyUrl() method b15f945https://github.com/sindresorhus/query-string/compare/v6.13.2...v6.13.3
Fix the ParsedQuery TypeScript type 56d2923
ParsedQuery TypeScript type 56d2923https://github.com/sindresorhus/query-string/compare/v6.13.1...v6.13.2
Fix sorting existing query params in URL when sort option is false (#265) 549d677
sort option is false (#265) 549d677https://github.com/sindresorhus/query-string/compare/v6.13.0...v6.13.1
Add support for parsing/stringifying fragment identifier (#222) ce06095
https://github.com/sindresorhus/query-string/compare/v6.12.1...v6.13.0
Fix value being decoded twice with arrayFormat option set to separator (#243) 3b4c295
arrayFormat option set to separator (#243) 3b4c295https://github.com/sindresorhus/query-string/compare/v6.12.0...v6.12.1
Add `skipEmptyString` option (#252) 20233a6
skipEmptyString option (#252) 20233a6https://github.com/sindresorhus/query-string/compare/v6.11.1...v6.12.0
Fix arrayFormatSeparator TypeScript type (#245) 338072a
arrayFormatSeparator TypeScript type (#245) 338072ahttps://github.com/sindresorhus/query-string/compare/v6.11.0...v6.11.1
Support custom array separator (#234) 7712622
arrayFormat: 'comma' (#236) a1d108fhttps://github.com/sindresorhus/query-string/compare/v6.10.1...v6.11.0
Fix issue with using Rollup b3179c4
https://github.com/sindresorhus/query-string/compare/v6.10.0...v6.10.1
Add `.stringifyUrl()` method (#217) 1604958
.stringifyUrl() method (#217) 1604958https://github.com/sindresorhus/query-string/compare/v6.9.0...v6.10.0
Add option to skip keys with the value of null in .stringify() (#215) 20d8069
null in .stringify() (#215) 20d8069+ to space when decode is true (#214) e20ab65https://github.com/sindresorhus/query-string/compare/v6.8.3...v6.9.0
Make parseNumbers and parseBooleans options work with arrayFormat (#202) d2451aa
parseNumbers and parseBooleans options work with arrayFormat (#202) d2451aahttps://github.com/sindresorhus/query-string/compare/v6.8.2...v6.8.3
Ensure empty string & spaces are parsed as string when parseNumber: true (#195) 504c29b
parseNumber: true (#195) 504c29bhttps://github.com/sindresorhus/query-string/compare/v6.8.1...v6.8.2
Fix using the parseNumbers and parseBooleans options together (#187) 90eb40e
parseNumbers and parseBooleans options together (#187) 90eb40ehttps://github.com/sindresorhus/query-string/compare/v6.8.0...v6.8.1
Add parseBooleans option to .parse() (#183) f958329
Enhancements:
parseBooleans option to .parse() (#183) f958329Fixes:
https://github.com/sindresorhus/query-string/compare/v6.7.0...v6.8.0
Add parseNumbers option to .parse() (#171) f7be831
parseNumbers option to .parse() (#171) f7be831https://github.com/sindresorhus/query-string/compare/v6.6.0...v6.7.0
Add sort option to .parse() (#177) b75ca4a
Enhancements:
sort option to .parse() (#177) b75ca4aFixes:
https://github.com/sindresorhus/query-string/compare/v6.5.0...v6.6.0
Support stringifying array containing value 0 (#173) 317cb36
.extract() (#174) 64a30dahttps://github.com/sindresorhus/query-string/compare/v6.4.2...v6.5.0
Correctly handle query strings that contain = (#169) 78e321c
= (#169) 78e321chttps://github.com/sindresorhus/query-string/compare/v6.4.0...v6.4.2
Add comma format to the arrayFormat option (#167) b22c2af
comma format to the arrayFormat option (#167) b22c2afParsedQuery TypeScript type (#170) 49d2203https://github.com/sindresorhus/query-string/compare/v6.3.0...v6.4.0
Add TypeScript definition (#168) 2c2e77a
https://github.com/sindresorhus/query-string/compare/v6.2.0...v6.3.0
Supports hash in parseUrl(). https://github.com/sindresorhus/query-string/commit/5b4ce872f826b7a919f6d062b728d0dc28c18291
parseUrl(). https://github.com/sindresorhus/query-string/commit/5b4ce872f826b7a919f6d062b728d0dc28c18291{sort: false}. https://github.com/sindresorhus/query-string/commit/b20493effe099e662df234110f2958bda2567a01https://github.com/sindresorhus/query-string/compare/v6.1.0...v6.2.0
Added decode option to .parse(). https://github.com/sindresorhus/query-string/commit/3fd6fd9c3ffb5232107e47afd787e43ed5df78c1
decode option to .parse(). https://github.com/sindresorhus/query-string/commit/3fd6fd9c3ffb5232107e47afd787e43ed5df78c1.stringify() for bracket mode with arrays containing null. https://github.com/sindresorhus/query-string/commit/e5a6c1f16d0a3483bbc03f2049d86398227941fbhttps://github.com/sindresorhus/query-string/compare/v6.0.0...v6.1.0
We now target Node.js 6 or later and the latest version of Chrome, Firefox, and Safari. If you want support for older browsers, use version 5: npm ins
We now target Node.js 6 or later and the latest version of Chrome, Firefox, and Safari. If you want support for older browsers, use version 5: npm install query-string@5. Same goes for Create React App v1 users (v2 works though), since it doesn't transpile node_modules.
https://github.com/sindresorhus/query-string/compare/v5.1.1...v6.0.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.