File size: 2,926 Bytes
f119c28 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 | /*
MIT License http://www.opensource.org/licenses/mit-license.php
*/
"use strict";
// A runtime-agnostic port of Node's `url.fileURLToPath`, built on the global
// `URL` (available in Node, browsers, Deno and Bun) so the resolver does not
// depend on the Node `url` builtin. The platform branch can be forced via the
// `windows` option; otherwise it follows the host platform like Node does.
const CHAR_LOWERCASE_A = 97;
const CHAR_LOWERCASE_Z = 122;
const isWindows =
typeof process !== "undefined" && process.platform === "win32";
const forwardSlashRegEx = /\//g;
/**
* @param {URL} url file: URL instance
* @returns {string} Windows filesystem path
*/
function getPathFromURLWin32(url) {
const { hostname } = url;
let { pathname } = url;
for (let n = 0; n < pathname.length; n++) {
if (pathname[n] === "%") {
const third = (pathname.codePointAt(n + 2) || 0) | 0x20;
if (
(pathname[n + 1] === "2" && third === 102) || // 2f 2F (/)
(pathname[n + 1] === "5" && third === 99) // 5c 5C (\)
) {
throw new TypeError(
"File URL path must not include encoded \\ or / characters",
);
}
}
}
pathname = pathname.replace(forwardSlashRegEx, "\\");
pathname = decodeURIComponent(pathname);
if (hostname !== "") {
// UNC path: `\\host\share\…`. Node runs the host through
// `domainToUnicode`; we keep the (already punycode) hostname as-is,
// which is identical for ASCII hosts and only differs for rare IDN UNC.
return `\\\\${hostname}${pathname}`;
}
const letter = (pathname.codePointAt(1) || 0) | 0x20;
const sep = pathname.charAt(2);
if (letter < CHAR_LOWERCASE_A || letter > CHAR_LOWERCASE_Z || sep !== ":") {
throw new TypeError("File URL path must be absolute");
}
return pathname.slice(1);
}
/**
* @param {URL} url file: URL instance
* @returns {string} POSIX filesystem path
*/
function getPathFromURLPosix(url) {
if (url.hostname !== "") {
throw new TypeError('File URL host must be "localhost" or empty');
}
const { pathname } = url;
for (let n = 0; n < pathname.length; n++) {
if (pathname[n] === "%") {
const third = (pathname.codePointAt(n + 2) || 0) | 0x20;
if (pathname[n + 1] === "2" && third === 102) {
throw new TypeError(
"File URL path must not include encoded / characters",
);
}
}
}
return decodeURIComponent(pathname);
}
/**
* @param {string | URL} path a `file:` URL string or `URL` instance
* @param {{ windows?: boolean }=} options force the platform branch
* @returns {string} the filesystem path
*/
function fileURLToPath(path, options) {
const url = typeof path === "string" ? new URL(path) : path;
if (url.protocol !== "file:") {
throw new TypeError("The URL must be of scheme file");
}
const windows =
options && options.windows !== undefined ? options.windows : isWindows;
return windows ? getPathFromURLWin32(url) : getPathFromURLPosix(url);
}
module.exports = fileURLToPath;
|