\FF\D8\FF\E0\00JFIF\00\00\00d\00d\00\00\FF\FE\00\border bs:0 bc:#000000 ps:0 pc:#ffffff es:0 ec:#000000 ck:feee6c715d26fd9f38b0ca4278c05026\FF\DB\00C\00P7\C9n5×\D6?\BDê\9Ds\EBp\9F[`8m\B7)o\B5\E8\E6I\99\FE3]]A2\BA\8Cw\D6E\93\\DEv\C8\009\F2\F1NI?uc\\F5\EA\96k\xN<~buv\EA\C8\D7 \8B\84\CEcxI\BBg\AE\9E=\D6+n\EC\80\C8A\8C\AE\EB\CF\D5\DA\E9"2\A4\B9j5\EB\F3W\B63\96\B30Yu\DA\FC8\ED\DF\E7Ms\FB\F1\8E\B3\FA\EA\E8\E6(\883zs\F2_\8DFk\8Bh \00\8C\DCw\D3R\B5+6X\BA\B2\C4j\AB0\B4\FCMw\C2I\8E\9B\E3\A9~9u\FA\D3l\80\C8%p\EE\FDn2€ \00 $\FEj\C4e\A9\DB\~\95\A7\A5\80EK\BB\8DDsP\00@@AD'k\CF\E8\DB\D2(\80\9AK\D3\85\D6lb\F2\BA\8C*\80\00)\95 59\A3R:\F3\CE"\B6\80\88\00\00i1u4ê\E9\F2á\A6\A2\FACM\93WMb*\E0*\00\00\00\00\00(\A8\80\00\00\80\00\00\00\00\00\00\00\00\00\FF\D9 C/// export interface ParseOptions { /** Decode the keys and values. URI components are decoded with [`decode-uri-component`](https://github.com/SamVerschueren/decode-uri-component). @default true */ readonly decode?: boolean; /** @default 'none' - `bracket`: Parse arrays with bracket representation: ``` import queryString = require('query-string'); queryString.parse('foo[]=1&foo[]=2&foo[]=3', {arrayFormat: 'bracket'}); //=> {foo: ['1', '2', '3']} ``` - `index`: Parse arrays with index representation: ``` import queryString = require('query-string'); queryString.parse('foo[0]=1&foo[1]=2&foo[3]=3', {arrayFormat: 'index'}); //=> {foo: ['1', '2', '3']} ``` - `comma`: Parse arrays with elements separated by comma: ``` import queryString = require('query-string'); queryString.parse('foo=1,2,3', {arrayFormat: 'comma'}); //=> {foo: ['1', '2', '3']} ``` - `separator`: Parse arrays with elements separated by a custom character: ``` import queryString = require('query-string'); queryString.parse('foo=1|2|3', {arrayFormat: 'separator', arrayFormatSeparator: '|'}); //=> {foo: ['1', '2', '3']} ``` - `none`: Parse arrays with elements using duplicate keys: ``` import queryString = require('query-string'); queryString.parse('foo=1&foo=2&foo=3'); //=> {foo: ['1', '2', '3']} ``` */ readonly arrayFormat?: 'bracket' | 'index' | 'comma' | 'separator' | 'none'; /** The character used to separate array elements when using `{arrayFormat: 'separator'}`. @default , */ readonly arrayFormatSeparator?: string; /** Supports both `Function` as a custom sorting function or `false` to disable sorting. If omitted, keys are sorted using `Array#sort`, which means, converting them to strings and comparing strings in Unicode code point order. @default true @example ``` import queryString = require('query-string'); const order = ['c', 'a', 'b']; queryString.parse('?a=one&b=two&c=three', { sort: (itemLeft, itemRight) => order.indexOf(itemLeft) - order.indexOf(itemRight) }); //=> {c: 'three', a: 'one', b: 'two'} ``` @example ``` import queryString = require('query-string'); queryString.parse('?a=one&c=three&b=two', {sort: false}); //=> {a: 'one', c: 'three', b: 'two'} ``` */ readonly sort?: ((itemLeft: string, itemRight: string) => number) | false; /** Parse the value as a number type instead of string type if it's a number. @default false @example ``` import queryString = require('query-string'); queryString.parse('foo=1', {parseNumbers: true}); //=> {foo: 1} ``` */ readonly parseNumbers?: boolean; /** Parse the value as a boolean type instead of string type if it's a boolean. @default false @example ``` import queryString = require('query-string'); queryString.parse('foo=true', {parseBooleans: true}); //=> {foo: true} ``` */ readonly parseBooleans?: boolean; /** Parse the fragment identifier from the URL and add it to result object. @default false @example ``` import queryString = require('query-string'); queryString.parseUrl('https://foo.bar?foo=bar#xyz', {parseFragmentIdentifier: true}); //=> {url: 'https://foo.bar', query: {foo: 'bar'}, fragmentIdentifier: 'xyz'} ``` */ readonly parseFragmentIdentifier?: boolean; } export interface ParsedQuery { [key: string]: T | T[] | null; } /** Parse a query string into an object. Leading `?` or `#` are ignored, so you can pass `location.search` or `location.hash` directly. The returned object is created with [`Object.create(null)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/create) and thus does not have a `prototype`. @param query - The query string to parse. */ export function parse(query: string, options: {parseBooleans: true, parseNumbers: true} & ParseOptions): ParsedQuery; export function parse(query: string, options: {parseBooleans: true} & ParseOptions): ParsedQuery; export function parse(query: string, options: {parseNumbers: true} & ParseOptions): ParsedQuery; export function parse(query: string, options?: ParseOptions): ParsedQuery; export interface ParsedUrl { readonly url: string; readonly query: ParsedQuery; /** The fragment identifier of the URL. Present when the `parseFragmentIdentifier` option is `true`. */ readonly fragmentIdentifier?: string; } /** Extract the URL and the query string as an object. If the `parseFragmentIdentifier` option is `true`, the object will also contain a `fragmentIdentifier` property. @param url - The URL to parse. @example ``` import queryString = require('query-string'); queryString.parseUrl('https://foo.bar?foo=bar'); //=> {url: 'https://foo.bar', query: {foo: 'bar'}} queryString.parseUrl('https://foo.bar?foo=bar#xyz', {parseFragmentIdentifier: true}); //=> {url: 'https://foo.bar', query: {foo: 'bar'}, fragmentIdentifier: 'xyz'} ``` */ export function parseUrl(url: string, options?: ParseOptions): ParsedUrl; export interface StringifyOptions { /** Strictly encode URI components with [`strict-uri-encode`](https://github.com/kevva/strict-uri-encode). It uses [`encodeURIComponent`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) if set to `false`. You probably [don't care](https://github.com/sindresorhus/query-string/issues/42) about this option. @default true */ readonly strict?: boolean; /** [URL encode](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) the keys and values. @default true */ readonly encode?: boolean; /** @default 'none' - `bracket`: Serialize arrays using bracket representation: ``` import queryString = require('query-string'); queryString.stringify({foo: [1, 2, 3]}, {arrayFormat: 'bracket'}); //=> 'foo[]=1&foo[]=2&foo[]=3' ``` - `index`: Serialize arrays using index representation: ``` import queryString = require('query-string'); queryString.stringify({foo: [1, 2, 3]}, {arrayFormat: 'index'}); //=> 'foo[0]=1&foo[1]=2&foo[2]=3' ``` - `comma`: Serialize arrays by separating elements with comma: ``` import queryString = require('query-string'); queryString.stringify({foo: [1, 2, 3]}, {arrayFormat: 'comma'}); //=> 'foo=1,2,3' ``` - `separator`: Serialize arrays by separating elements with character: ``` import queryString = require('query-string'); queryString.stringify({foo: [1, 2, 3]}, {arrayFormat: 'separator', arrayFormatSeparator: '|'}); //=> 'foo=1|2|3' ``` - `none`: Serialize arrays by using duplicate keys: ``` import queryString = require('query-string'); queryString.stringify({foo: [1, 2, 3]}); //=> 'foo=1&foo=2&foo=3' ``` */ readonly arrayFormat?: 'bracket' | 'index' | 'comma' | 'separator' | 'none'; /** The character used to separate array elements when using `{arrayFormat: 'separator'}`. @default , */ readonly arrayFormatSeparator?: string; /** Supports both `Function` as a custom sorting function or `false` to disable sorting. If omitted, keys are sorted using `Array#sort`, which means, converting them to strings and comparing strings in Unicode code point order. @default true @example ``` import queryString = require('query-string'); const order = ['c', 'a', 'b']; queryString.stringify({a: 1, b: 2, c: 3}, { sort: (itemLeft, itemRight) => order.indexOf(itemLeft) - order.indexOf(itemRight) }); //=> 'c=3&a=1&b=2' ``` @example ``` import queryString = require('query-string'); queryString.stringify({b: 1, c: 2, a: 3}, {sort: false}); //=> 'b=1&c=2&a=3' ``` */ readonly sort?: ((itemLeft: string, itemRight: string) => number) | false; /** Skip keys with `null` as the value. Note that keys with `undefined` as the value are always skipped. @default false @example ``` import queryString = require('query-string'); queryString.stringify({a: 1, b: undefined, c: null, d: 4}, { skipNull: true }); //=> 'a=1&d=4' queryString.stringify({a: undefined, b: null}, { skipNull: true }); //=> '' ``` */ readonly skipNull?: boolean; /** Skip keys with an empty string as the value. @default false @example ``` import queryString = require('query-string'); queryString.stringify({a: 1, b: '', c: '', d: 4}, { skipEmptyString: true }); //=> 'a=1&d=4' ``` @example ``` import queryString = require('query-string'); queryString.stringify({a: '', b: ''}, { skipEmptyString: true }); //=> '' ``` */ readonly skipEmptyString?: boolean; } export type Stringifiable = string | boolean | number | null | undefined; export type StringifiableRecord = Record< string, Stringifiable | readonly Stringifiable[] >; /** Stringify an object into a query string and sort the keys. */ export function stringify( // TODO: Use the below instead when the following TS issues are fixed: // - https://github.com/microsoft/TypeScript/issues/15300 // - https://github.com/microsoft/TypeScript/issues/42021 // Context: https://github.com/sindresorhus/query-string/issues/298 // object: StringifiableRecord, object: Record, options?: StringifyOptions ): string; /** Extract a query string from a URL that can be passed into `.parse()`. Note: This behaviour can be changed with the `skipNull` option. */ export function extract(url: string): string; export interface UrlObject { readonly url: string; /** Overrides queries in the `url` property. */ readonly query?: StringifiableRecord; /** Overrides the fragment identifier in the `url` property. */ readonly fragmentIdentifier?: string; } /** Stringify an object into a URL with a query string and sorting the keys. The inverse of [`.parseUrl()`](https://github.com/sindresorhus/query-string#parseurlstring-options) Query items in the `query` property overrides queries in the `url` property. The `fragmentIdentifier` property overrides the fragment identifier in the `url` property. @example ``` queryString.stringifyUrl({url: 'https://foo.bar', query: {foo: 'bar'}}); //=> 'https://foo.bar?foo=bar' queryString.stringifyUrl({url: 'https://foo.bar?foo=baz', query: {foo: 'bar'}}); //=> 'https://foo.bar?foo=bar' queryString.stringifyUrl({ url: 'https://foo.bar', query: { top: 'foo' }, fragmentIdentifier: 'bar' }); //=> 'https://foo.bar?top=foo#bar' ``` */ export function stringifyUrl( object: UrlObject, options?: StringifyOptions ): string; /** Pick query parameters from a URL. @param url - The URL containing the query parameters to pick. @param keys - The names of the query parameters to keep. All other query parameters will be removed from the URL. @param filter - A filter predicate that will be provided the name of each query parameter and its value. The `parseNumbers` and `parseBooleans` options also affect `value`. @returns The URL with the picked query parameters. @example ``` queryString.pick('https://foo.bar?foo=1&bar=2#hello', ['foo']); //=> 'https://foo.bar?foo=1#hello' queryString.pick('https://foo.bar?foo=1&bar=2#hello', (name, value) => value === 2, {parseNumbers: true}); //=> 'https://foo.bar?bar=2#hello' ``` */ export function pick( url: string, keys: readonly string[], options?: ParseOptions & StringifyOptions ): string export function pick( url: string, filter: (key: string, value: string | boolean | number) => boolean, options?: {parseBooleans: true, parseNumbers: true} & ParseOptions & StringifyOptions ): string export f