// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license. // This module is browser compatible. import { assertArg } from "../_common/from_file_url.ts"; /** * Converts a file URL to a path string. * * ```ts * import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/windows/from_file_url.ts"; * * fromFileUrl("file:///home/foo"); // "\\home\\foo" * fromFileUrl("file:///C:/Users/foo"); // "C:\\Users\\foo" * fromFileUrl("file://localhost/home/foo"); // "\\\\localhost\\home\\foo" * ``` * @param url of a file URL */ export function fromFileUrl(url: URL | string): string { url = assertArg(url); let path = decodeURIComponent( url.pathname.replace(/\//g, "\\").replace(/%(?![0-9A-Fa-f]{2})/g, "%25"), ).replace(/^\\*([A-Za-z]:)(\\|$)/, "$1\\"); if (url.hostname !== "") { // Note: The `URL` implementation guarantees that the drive letter and // hostname are mutually exclusive. Otherwise it would not have been valid // to append the hostname and path like this. path = `\\\\${url.hostname}${path}`; } return path; }