refactor: Rename runtime/rt to runtime/js (#8806)

runtime/js/06_util.js

@@ -0,0 +1,148 @@
+// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
+
+((window) => {
+  const { build } = window.__bootstrap.build;
+  const internals = window.__bootstrap.internals;
+  let logDebug = false;
+  let logSource = "JS";
+
+  function setLogDebug(debug, source) {
+    logDebug = debug;
+    if (source) {
+      logSource = source;
+    }
+  }
+
+  function log(...args) {
+    if (logDebug) {
+      // if we destructure `console` off `globalThis` too early, we don't bind to
+      // the right console, therefore we don't log anything out.
+      globalThis.console.log(`DEBUG ${logSource} -`, ...args);
+    }
+  }
+
+  class AssertionError extends Error {
+    constructor(msg) {
+      super(msg);
+      this.name = "AssertionError";
+    }
+  }
+
+  function assert(cond, msg = "Assertion failed.") {
+    if (!cond) {
+      throw new AssertionError(msg);
+    }
+  }
+
+  function createResolvable() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+      resolve = res;
+      reject = rej;
+    });
+    promise.resolve = resolve;
+    promise.reject = reject;
+    return promise;
+  }
+
+  function immutableDefine(
+    o,
+    p,
+    value,
+  ) {
+    Object.defineProperty(o, p, {
+      value,
+      configurable: false,
+      writable: false,
+    });
+  }
+
+  // Keep in sync with `fromFileUrl()` in `std/path/win32.ts`.
+  function pathFromURLWin32(url) {
+    let path = decodeURIComponent(
+      url.pathname
+        .replace(/^\/*([A-Za-z]:)(\/|$)/, "$1/")
+        .replace(/\//g, "\\")
+        .replace(/%(?![0-9A-Fa-f]{2})/g, "%25"),
+    );
+    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;
+  }
+
+  // Keep in sync with `fromFileUrl()` in `std/path/posix.ts`.
+  function pathFromURLPosix(url) {
+    if (url.hostname !== "") {
+      throw new TypeError(`Host must be empty.`);
+    }
+
+    return decodeURIComponent(
+      url.pathname.replace(/%(?![0-9A-Fa-f]{2})/g, "%25"),
+    );
+  }
+
+  function pathFromURL(pathOrUrl) {
+    if (pathOrUrl instanceof URL) {
+      if (pathOrUrl.protocol != "file:") {
+        throw new TypeError("Must be a file URL.");
+      }
+
+      return build.os == "windows"
+        ? pathFromURLWin32(pathOrUrl)
+        : pathFromURLPosix(pathOrUrl);
+    }
+    return pathOrUrl;
+  }
+
+  internals.exposeForTest("pathFromURL", pathFromURL);
+
+  function writable(value) {
+    return {
+      value,
+      writable: true,
+      enumerable: true,
+      configurable: true,
+    };
+  }
+
+  function nonEnumerable(value) {
+    return {
+      value,
+      writable: true,
+      configurable: true,
+    };
+  }
+
+  function readOnly(value) {
+    return {
+      value,
+      enumerable: true,
+    };
+  }
+
+  function getterOnly(getter) {
+    return {
+      get: getter,
+      enumerable: true,
+    };
+  }
+
+  window.__bootstrap.util = {
+    log,
+    setLogDebug,
+    createResolvable,
+    assert,
+    AssertionError,
+    immutableDefine,
+    pathFromURL,
+    writable,
+    nonEnumerable,
+    readOnly,
+    getterOnly,
+  };
+})(this);