node:querystring API Reference

Legacy query-string parsing and formatting

For new code, prefer URLSearchParams. node:querystring remains available for compatibility with existing packages.

import querystring from "node:querystring";

const parsed = querystring.parse("name=Ada&role=engineer&role=manager");
console.log(parsed.role); // ["engineer", "manager"]

console.log(querystring.stringify({ name: "Ada", role: ["engineer", "manager"] }));
// name=Ada&role=engineer&role=manager

The module exports parse, stringify, escape, unescape, and the aliases decode and encode. Custom separators and assignment delimiters are supported.

parse converts + to spaces, combines duplicate keys into arrays, and returns an object with a null prototype. unescape does not convert +. Array values passed to stringify become repeated key/value pairs.

See the Node.js querystring documentation for standard options and coercion rules.