123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203
// Copyright Joyent, Inc. and other Node contributors.//// Permission is hereby granted, free of charge, to any person obtaining a// copy of this software and associated documentation files (the// "Software"), to deal in the Software without restriction, including// without limitation the rights to use, copy, modify, merge, publish,// distribute, sublicense, and/or sell copies of the Software, and to permit// persons to whom the Software is furnished to do so, subject to the// following conditions://// The above copyright notice and this permission notice shall be included// in all copies or substantial portions of the Software.//// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE// USE OR OTHER DEALINGS IN THE SOFTWARE.
import {  ERR_INVALID_ARG_TYPE,  ERR_INVALID_ARG_VALUE,  ERR_INVALID_FILE_URL_HOST,  ERR_INVALID_FILE_URL_PATH,  ERR_INVALID_URL_SCHEME,} from "./_errors.ts";import {  CHAR_BACKWARD_SLASH,  CHAR_FORWARD_SLASH,  CHAR_LOWERCASE_A,  CHAR_LOWERCASE_Z,} from "../path/_constants.ts";import * as path from "./path.ts";import { isWindows, osType } from "../_util/os.ts";
const forwardSlashRegEx = /\//g;const percentRegEx = /%/g;const backslashRegEx = /\\/g;const newlineRegEx = /\n/g;const carriageReturnRegEx = /\r/g;const tabRegEx = /\t/g;
const _url = URL;export { _url as URL };
/** * Get fully resolved platform-specific file path from the given URL string/ object * @param path The file URL string or URL object to convert to a path */export function fileURLToPath(path: string | URL): string {  if (typeof path === "string") path = new URL(path);  else if (!(path instanceof URL)) {    throw new ERR_INVALID_ARG_TYPE("path", ["string", "URL"], path);  }  if (path.protocol !== "file:") {    throw new ERR_INVALID_URL_SCHEME("file");  }  return isWindows ? getPathFromURLWin(path) : getPathFromURLPosix(path);}
function getPathFromURLWin(url: URL): string {  const hostname = url.hostname;  let pathname = url.pathname;  for (let n = 0; n < pathname.length; n++) {    if (pathname[n] === "%") {      const third = pathname.codePointAt(n + 2)! | 0x20;      if (        (pathname[n + 1] === "2" && third === 102) || // 2f 2F /        (pathname[n + 1] === "5" && third === 99) // 5c 5C \      ) {        throw new ERR_INVALID_FILE_URL_PATH(          "must not include encoded \\ or / characters",        );      }    }  }
  pathname = pathname.replace(forwardSlashRegEx, "\\");  pathname = decodeURIComponent(pathname);  if (hostname !== "") {    // TODO(bartlomieju): add support for punycode encodings    return `\\\\${hostname}${pathname}`;  } else {    // Otherwise, it's a local path that requires a drive letter    const letter = pathname.codePointAt(1)! | 0x20;    const sep = pathname[2];    if (      letter < CHAR_LOWERCASE_A ||      letter > CHAR_LOWERCASE_Z || // a..z A..Z      sep !== ":"    ) {      throw new ERR_INVALID_FILE_URL_PATH("must be absolute");    }    return pathname.slice(1);  }}
function getPathFromURLPosix(url: URL): string {  if (url.hostname !== "") {    throw new ERR_INVALID_FILE_URL_HOST(osType);  }  const pathname = url.pathname;  for (let n = 0; n < pathname.length; n++) {    if (pathname[n] === "%") {      const third = pathname.codePointAt(n + 2)! | 0x20;      if (pathname[n + 1] === "2" && third === 102) {        throw new ERR_INVALID_FILE_URL_PATH(          "must not include encoded / characters",        );      }    }  }  return decodeURIComponent(pathname);}
/** *  The following characters are percent-encoded when converting from file path *  to URL: *  - %: The percent character is the only character not encoded by the *       `pathname` setter. *  - \: Backslash is encoded on non-windows platforms since it's a valid *       character but the `pathname` setters replaces it by a forward slash. *  - LF: The newline character is stripped out by the `pathname` setter. *        (See whatwg/url#419) *  - CR: The carriage return character is also stripped out by the `pathname` *        setter. *  - TAB: The tab character is also stripped out by the `pathname` setter. */function encodePathChars(filepath: string): string {  if (filepath.includes("%")) {    filepath = filepath.replace(percentRegEx, "%25");  }  // In posix, backslash is a valid character in paths:  if (!isWindows && filepath.includes("\\")) {    filepath = filepath.replace(backslashRegEx, "%5C");  }  if (filepath.includes("\n")) {    filepath = filepath.replace(newlineRegEx, "%0A");  }  if (filepath.includes("\r")) {    filepath = filepath.replace(carriageReturnRegEx, "%0D");  }  if (filepath.includes("\t")) {    filepath = filepath.replace(tabRegEx, "%09");  }  return filepath;}
/** * Get fully resolved platform-specific File URL from the given file path * @param filepath The file path string to convert to a file URL */export function pathToFileURL(filepath: string): URL {  const outURL = new URL("file://");  if (isWindows && filepath.startsWith("\\\\")) {    // UNC path format: \\server\share\resource    const paths = filepath.split("\\");    if (paths.length <= 3) {      throw new ERR_INVALID_ARG_VALUE(        "filepath",        filepath,        "Missing UNC resource path",      );    }    const hostname = paths[2];    if (hostname.length === 0) {      throw new ERR_INVALID_ARG_VALUE(        "filepath",        filepath,        "Empty UNC servername",      );    }
    // TODO(wafuwafu13): To be `outURL.hostname = domainToASCII(hostname)` once `domainToASCII` are implemented    outURL.hostname = hostname;    outURL.pathname = encodePathChars(      paths.slice(3).join("/"),    );  } else {    let resolved = path.resolve(filepath);    // path.resolve strips trailing slashes so we must add them back    const filePathLast = filepath.charCodeAt(filepath.length - 1);    if (      (filePathLast === CHAR_FORWARD_SLASH ||        (isWindows && filePathLast === CHAR_BACKWARD_SLASH)) &&      resolved[resolved.length - 1] !== path.sep    ) {      resolved += "/";    }
    outURL.pathname = encodePathChars(resolved);  }  return outURL;}
export default {  fileURLToPath,  pathToFileURL,  URL,};