Function fileUrlToAbsolutePath

src/common/urlUtils.ts:261–305

(urlOrPath: string)

export function fileUrlToAbsolutePath(urlOrPath: FileUrl): string;
export function fileUrlToAbsolutePath(urlOrPath: string): string | undefined;
export function fileUrlToAbsolutePath(urlOrPath: string): string | undefined {
  const webviewResource = vscodeWebviewResourceSchemeRe.exec(urlOrPath);
  if (webviewResource) {
    urlOrPath = `${webviewResource[1]}:///${webviewResource[2]}`;
  } else if (urlOrPath.startsWith('vscode-webview-resource://')) {
    // todo@connor4312: is this still in use?
    const url = new URL(urlOrPath);
    // Strip off vscode webview url part: vscode-webview-resource://<36-char-guid>/file...
    urlOrPath = url.pathname
      .replace(/%2F/gi, '/')
      .replace(/^\/([a-z0-9\-]+)(\/{1,2})/i, (_: string, scheme: string, sep: string) => {
        if (sep.length === 1) {
          return `${scheme}:///`; // Add empty authority.
        } else {
          return `${scheme}://`; // Url has own authority.
        }
      });
  } else if (urlOrPath.startsWith(vscodeAppResource)) {
    urlOrPath = urlOrPath.slice(vscodeAppResource.length);
  } else if (!isFileUrl(urlOrPath)) {
    return undefined;
  }

  urlOrPath = urlOrPath.replace('file:///', '');
  urlOrPath = decodeURIComponent(urlOrPath);

  // UNC paths are returned from Chrome in the form `file:////shared/folder`,
  // rather than `file:///`. This is not _entirely_ prescriptive since some
  // applications can use four slashes for posix paths as well (even though V8
  // doesn't seem to), so only do this if the debugger is currently running on Windows.
  if (urlOrPath.startsWith('/') && process.platform === 'win32') {
    if (urlOrPath[1] !== '/') {
      urlOrPath = '/' + urlOrPath; // restore extra slash
    }
  }

  if (urlOrPath[0] !== '/' && !urlOrPath.match(/^[A-Za-z]:/)) {
    // If it has a : before the first /, assume it's a windows path or url.
    // Ensure unix-style path starts with /, it can be removed when file:/// was stripped.
    // Don't add if the url still has a protocol
    urlOrPath = '/' + urlOrPath;
  }

  return fixDriveLetterAndSlashes(urlOrPath);
}

/**
 * Converts a file URL to a windows network path, if possible.