[dayongkr]

Summary

Adds stringify to a new es-toolkit/query-string entrypoint. It turns an object into ?a=1&b=2, or '' when there is nothing to add.

Proposed in #2111 as stringifySearch in es-toolkit/util. This PR ships it as stringify in a dedicated es-toolkit/query-string entrypoint instead.

import { stringify } from 'es-toolkit/query-string';

`/items${stringify({ page: 1, tags: ['a', 'b'], q: 'hello world', ref: undefined })}`;
// '/items?page=1&tags=a&tags=b&q=hello%20world'

Changes

• New entrypoint es-toolkit/query-string (exports, files, publishConfig, postbuild root stub, check-dist entrypoint list). It is not re-exported from the main entrypoint.
• Omits null and undefined, repeats keys for arrays, and encodes with encodeURIComponent.
• Tests and docs in four languages. The docs sidebar gets a "Query String Utilities" section under the es-toolkit tab.

Input type

T extends object & { [K in keyof T]: QueryValue | readonly QueryValue[] }

• The mapped type accepts objects declared with interface, which Record<string, …> rejects, and rejects nested objects and Date.
• object & rejects null and primitives, which the mapped type alone lets through.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
es-toolkit	Ready	Preview	Oct 10, 2026 6:14am UTC