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

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

/**
 * 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 function _parseQueryString(search) {
    const qs = {};
    search
        .slice(search.startsWith('?') ? 1 : 0)
        .split('&')
        .forEach(p => {
        const [k, v] = p.split('=');
        if (!k)
            return;
        qs[decodeURIComponent(k)] = decodeURIComponent(v || '');
    });
    return qs;
}
/**
 * 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 function _toUrlOrNull(url, base) {
    if (typeof url !== 'string')
        return null;
    try {
        return new URL(url, base || undefined);
    }
    catch {
        return null;
    }
}