Package Exports

fast-querystring
fast-querystring/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (fast-querystring) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

fast-querystring

Fast query-string parser to replace the legacy node:querystring parse & stringify functions.

Installation

npm i fast-querystring

Features

Supports both parse and stringify methods from node:querystring module
Parsed object does not have prototype methods
Uses & separator as default
Supports only input of type string
Supports repeating keys in query string
- foo=bar&foo=baz parses into {foo: ['bar', 'baz']}
Supports pairs with missing values
- foo=bar&hola parses into {foo: 'bar', hola: ''}
Stringify does not support nested values (just like node:querystring)

Usage

const qs = require('fast-querystring')

// Parsing a querystring
console.log(qs.parse('hello=world&foo=bar&values=v1&values=v2'))
// {
//   hello: 'world',
//   foo: 'bar',
//   values: ['v1', 'v2']
// }

// Stringifying an object
console.log(qs.stringify({ foo: ['bar', 'baz'] }))
// 'foo=bar&foo=baz'

Benchmark

Parsing a query-string

> node benchmark/parse.mjs

╔═════════════════════════════════════════╤═════════╤═══════════════════╤═══════════╗
║ Slower tests                            │ Samples │            Result │ Tolerance ║
╟─────────────────────────────────────────┼─────────┼───────────────────┼───────────╢
║ qs                                      │   10000 │  317841.53 op/sec │  ± 1.18 % ║
║ query-string                            │   10000 │  341009.91 op/sec │  ± 1.06 % ║
║ querystringify                          │    1000 │  451609.79 op/sec │  ± 0.61 % ║
║ @aws-sdk/querystring-parser             │    1000 │  477241.09 op/sec │  ± 0.69 % ║
║ URLSearchParams-with-Object.fromEntries │   10000 │  870095.07 op/sec │  ± 3.29 % ║
║ URLSearchParams-with-construct          │   10000 │ 1232650.60 op/sec │  ± 2.95 % ║
║ node:querystring                        │   10000 │ 1462802.04 op/sec │  ± 3.69 % ║
╟─────────────────────────────────────────┼─────────┼───────────────────┼───────────╢
║ Fastest test                            │ Samples │            Result │ Tolerance ║
╟─────────────────────────────────────────┼─────────┼───────────────────┼───────────╢
║ fast-querystring                        │   10000 │ 1809816.84 op/sec │  ± 3.19 % ║
╚═════════════════════════════════════════╧═════════╧═══════════════════╧═══════════╝

Stringify a query-string

> node benchmark/stringify.mjs

╔════════════════════════════╤═════════╤═══════════════════╤═══════════╗
║ Slower tests               │ Samples │            Result │ Tolerance ║
╟────────────────────────────┼─────────┼───────────────────┼───────────╢
║ query-string               │   10000 │  284130.63 op/sec │  ± 1.62 % ║
║ qs                         │   10000 │  334799.48 op/sec │  ± 1.93 % ║
║ http-querystring-stringify │   10000 │  482642.49 op/sec │  ± 1.72 % ║
║ URLSearchParams            │   10000 │  587274.65 op/sec │  ± 1.88 % ║
║ querystringify             │   10000 │  753960.35 op/sec │  ± 2.20 % ║
║ node:querystring           │   10000 │ 1796993.95 op/sec │  ± 5.34 % ║
╟────────────────────────────┼─────────┼───────────────────┼───────────╢
║ Fastest test               │ Samples │            Result │ Tolerance ║
╟────────────────────────────┼─────────┼───────────────────┼───────────╢
║ fast-querystring           │   10000 │ 2051022.89 op/sec │  ± 4.52 % ║
╚════════════════════════════╧═════════╧═══════════════════╧═══════════╝