32 lines
1.1 KiB
JavaScript
32 lines
1.1 KiB
JavaScript
/**
|
||
* Checks if a value has the shape of a WHATWG URL object.
|
||
*
|
||
* Using a symbol or instanceof would not be able to recognize URL objects
|
||
* coming from other implementations (e.g. in Electron), so instead we are
|
||
* checking some well known properties for a lack of a better test.
|
||
*
|
||
* We use `href` and `protocol` as they are the only properties that are
|
||
* easy to retrieve and calculate due to the lazy nature of the getters.
|
||
*
|
||
* We check for auth attribute to distinguish legacy url instance with
|
||
* WHATWG URL instance.
|
||
*
|
||
* @param {unknown} fileUrlOrPath
|
||
* File path or URL.
|
||
* @returns {fileUrlOrPath is URL}
|
||
* Whether it’s a URL.
|
||
*/
|
||
// From: <https://github.com/nodejs/node/blob/6a3403c/lib/internal/url.js#L720>
|
||
export function isUrl(fileUrlOrPath) {
|
||
return Boolean(
|
||
fileUrlOrPath !== null &&
|
||
typeof fileUrlOrPath === 'object' &&
|
||
'href' in fileUrlOrPath &&
|
||
fileUrlOrPath.href &&
|
||
'protocol' in fileUrlOrPath &&
|
||
fileUrlOrPath.protocol &&
|
||
// @ts-expect-error: indexing is fine.
|
||
fileUrlOrPath.auth === undefined
|
||
)
|
||
}
|