Skip to content
module@warp-drive/utilities

Function sortQueryParams() ​

ts
function sortQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): URLSearchParams;

Defined in: index.ts:697

Sorts query params by both key and value returning a new URLSearchParams object with the keys inserted in sorted order.

See Cache Keys for Requests for why builders need stable query params.

Treats included specially, splicing it into an array if it is a string and sorting the array.

The params given are never mutated: neither the object itself nor any array value it holds is reordered or replaced, so passing state that is also rendered (a tracked array of filter values, for instance) is safe.

Options:

  • arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'

'bracket': appends [] to the key for every value e.g. &ids[]=1&ids[]=2 'indices': appends [i] to the key for every value e.g. &ids[0]=1&ids[1]=2 'repeat': appends the key for every value e.g. &ids=1&ids=2 'comma' (default): appends the key once with a comma separated list of values e.g. &ids=1,2

Parameters ​

params ​

QueryParamsSource

options? ​

QueryParamsSerializationOptions

Returns ​

URLSearchParams

A URLSearchParams with keys inserted in sorted order

Released under the MIT License.