Added properties for the current CWD and process path

Author: JamesMessinger

README.md

@@ -102,6 +102,18 @@ API
 ### `host.global`
 When running in a web browser, `host.global` is a reference to the `window` object.  When running in Node.js, it's a reference to the `global` object.
 
+### `host.path`
+The path of the host process, as a string. When running in Node.js, this is set to [`process.execPath`](https://nodejs.org/api/process.html#process_process_execpath). When running in a web browser, it is the URL of the web page (`window.location.href`).
+
+### `host.url`
+The same as `host.path`, but as a parsed [URL object](https://developer.mozilla.org/en-US/docs/Web/API/URL).  When running in Node.js, this will be a `file://` URL.
+
+### `host.cwd`
+The current working directory, as a string. When running in Node.js, this is set to [`process.cwd`](https://nodejs.org/api/process.html#process_process_cwd). When running in a web browser, it is the parent directory of the current web page
+
+### `host.cwdURL`
+The same as `host.cwd`, but as a parsed [URL object](https://developer.mozilla.org/en-US/docs/Web/API/URL).  When running in Node.js, this will be a `file://` URL.
+
 
 ### `host.os`
 This property is an object with the following structure:

karma.conf.js

@@ -12,9 +12,9 @@ module.exports = karmaConfig({
   browsers: {
     chrome: host.ci ? host.os.linux : true,
     firefox: host.ci ? host.os.linux : true,
-    safari: host.ci ? host.os.linux : host.os.mac,
-    edge: host.ci ? host.os.linux : host.os.windows,
-    ie: host.os.windows,
+    safari: host.ci ? host.os.linux : host.os.mac,    // SauceLabs in CI
+    edge: host.ci ? host.os.linux : host.os.windows,  // SauceLabs in CI
+    ie: host.ci ? host.os.windows : false,  // IE needs to run by itself, due to Babel transforms
   },
   config: {
     // Prevent Karma-Config from using the "karma-host-environment" framework,

src/host.ts

@@ -10,6 +10,30 @@ export interface Host {
    */
   global: Global;
 
+  /**
+   * The path of the host process.
+   * In Node, this is `process.execPath`. In web browsers, it is the URL of the current page.
+   */
+  path: string;
+
+  /**
+   * The URL of the host process.
+   * In Node, this will be a "file://" URL. In web browsers it will be an "http://" or "https://" URL.
+   */
+  url: URL;
+
+  /**
+   * The current working directory.
+   * In Node, this is `process.cwd()`. In web browsers it's the parent directory of the current page URL.
+   */
+  cwd: string;
+
+  /**
+   * The current working directory as a URL.
+   * In Node, this will be a "file://" URL. In web browsers it will be an "http://" or "https://" URL.
+   */
+  cwdURL: URL;
+
   /**
    * Information about the host operating system.
    * In web browsers the OS info is inferred from the user agent.

src/isomorphic.browser.ts

@@ -3,11 +3,18 @@ import { Browsers, BrowsersRecord, Global, Host, OSInfo, OSInfoRecord } from "./
 import { merge, mergeGlobalHost } from "./merge";
 import { toJSON } from "./to-json";
 
+let url = new URL(window.location.href);
+let cwdURL = new URL(".", url);
+
 /**
  * Information about the host environment that the code is running in.
  */
 export const host: Host = {
   global: window as unknown as Global,
+  url,
+  path: url.href,
+  cwdURL,
+  cwd: cwdURL.href,
   os: getOSInfo(),
   node: false,
   browser: getBrowserInfo(),

src/isomorphic.node.ts

@@ -1,14 +1,22 @@
 /* eslint-env node */
 import * as ci from "@qawolf/ci-info";
+import { pathToFileURL } from "url";
 import { CIInfo, Global, Host, NodeInfo, OSInfo } from "./host";
 import { merge, mergeGlobalHost } from "./merge";
 import { toJSON } from "./to-json";
 
+const cwd = process.cwd();
+const execPath = process.execPath;
+
 /**
  * Information about the host environment that the code is running in.
  */
 export const host: Host = {
   global: global as unknown as Global,
+  path: execPath,
+  url: pathToFileURL(execPath),
+  cwd,
+  cwdURL: pathToFileURL(cwd),
   os: getOSInfo(),
   node: getNodeInfo(),
   browser: false,

test/specs/exports.spec.js

@@ -20,6 +20,10 @@ describe("package exports", () => {
 
     expect(keys).to.have.same.members([
       "global",
+      "path",
+      "url",
+      "cwd",
+      "cwdURL",
       "os",
       "env",
       "ci",