@naturalcycles/js-lib/dist/string/url.util.d.ts

Standard library for universal (browser + Node.js) javascript

import type { StringMap } from '../types.js';
/**
 * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
 * `{ a: '1', b: '2' }`
 *
 * Pass `location.search` to it in the Frontend, or any other string on the Backend (where `location.search` is not available).
 *
 * Works both with and without leading `?` character.
 *
 * Yes, there's `URLSearchParams` existing in the Frontend (not in Node yet), but it's API is not
 * as convenient. And the implementation here is super-small.
 *
 * Goal of this function is to produce exactly same output as URLSearchParams would.
 */
export declare function _parseQueryString(search: string): StringMap;
/**
 * A wrapper around `new URL(href)`, but it returns `null` instead of throwing an error.
 * While `URL.parse` exists, and behaves similarly, it's not widely supported.
 *
 * `null` was chosen instead of `undefined` in the return type union to make it easier to move to `URL.parse` if it ever becomes widely supported.
 */
export declare function _toUrlOrNull(url: string | undefined, base?: string): URL | null;