npm

Ready to take your JavaScript development to the next level? Meet npm Enterprise - the ultimate in enterprise JavaScript.Learn more »

karma-host-environment

2.0.1 • Public • Published

Karma Host Environment

Build Status Coverage Status

npm Dependencies License

OS and Browser Compatibility

Host Environment is a library that makes it easy to detect whether your code is running in Node.js or a web browser, Windows or Mac, Internet Explorer or Chrome, etc.

Karma Host Environment is a companion to Host Environment, specifically for the Karma test runner. It allows you to detect not only the browser that your tests are running in, but also information about the host server, such as the operating system, Node.js version, and even environment variables.

Example

import host from "host-environment";
 
if (host.env.CI) {
  // Setup CI test fixtures
}
 
if (host.browser) {
  // Test browser behavior
 
  if (host.browser.IE) {
    // Test Internet Explorer-specific behavior
  }
}
 
if (host.node) {
  // Test Node.js behavior
 
  if (host.node.version < 8) {
    // Different logic for older versions of Node
  }
 
  if (host.os.windows) {
    // Test Windows-specific behavior
  }
}

Related Projects

  • karma-config
    Karma configuration builder with sensible defaults to minimize boilerplate

  • host-environment
    Easily detect what host environment your code is running in

Installation

Use npm or yarn to install host-environment and karma-host-environment as development dependencies:

npm install --save-dev host-environment karma-host-environment

Usage

Configure Karma to use the host-environment framework plug-in:

karma.conf.js

module.exports = function(config) {
  config.set({
    frameworks: ["host-environment"],
    ...
  });
};

API

Import host-environment as you normally would:

import host from "host-environment";

The host object

You can use all of the host properties as usual:

The host.env property

Normally the host.env property would be an empty object when running in a web browser, since web browsers don't have access to environment variables. But Karma Host Environment exposes the host server's environment variables, so you can use host.env just as you would if you were running in Node.js:

if (host.env.CI) {
  // Setup CI test fixtures
}
 
if (host.env.QUICK_TEST) {
  // Skip long-running tests
}

The host.karma property

In addition to all the usual host properties, Karma Host Environment adds an additional host.karma property. This object exposes all the host properties of the Karma server itself, such as the operating system, Node.js version, environmenv variables, etc.

if (host.karma) {
  // We're running in Karma
 
  if (host.karma.node.version > 10) {
    // The server is running in Node v10+
  }
 
  if (host.karma.os.windows) {
    // The server is a Windows OS
  }
}

Contributing

Contributions, enhancements, and bug-fixes are welcome! File an issue on GitHub and submit a pull request.

Building

To build the project locally on your computer:

  1. Clone this repo
    git clone https://github.com/JS-DevTools/karma-host-environment.git

  2. Install dependencies
    npm install

  3. Link the module to itself (so Karma can find the plugin)
    npm link
    npm link karma-host-environment

  4. Run the tests
    npm test

License

karma-host-environment is 100% free and open-source, under the MIT license. Use it however you want.

Big Thanks To

Thanks to these awesome companies for their support of Open Source developers ❤

Travis CI SauceLabs Coveralls

install

npm i karma-host-environment

version

2.0.1

license

MIT

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability