Simulates a global browser environment using jsdom
Latest commit 71aed2b Feb 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Fix code linting errors Jun 30, 2017
test Update window to the latest version 🚀 (#65) Feb 6, 2018
.gitignore Remove babel Oct 12, 2016
.npmignore Add test dir to .npmignore (#42) May 3, 2017
.travis.yml Don't support Node.js v4 Jun 30, 2017
LICENSE Add LICENSE file Oct 14, 2016 Update Node.js version info Jun 30, 2017
package.json 3.2.5 Feb 6, 2018


Simulates a global browser environment using jsdom.

Build Status Coverage Status npm npm

This allows you to run browser modules in Node.js 6 or newer with minimal or no effort. Can also be used to test browser modules with any Node.js test framework. Please note, only the DOM is simulated, if you want to run a module that requires more advanced browser features (like localStorage), you'll need to polyfill that seperately.

Use browser-env@2 to support older Node.js versions.

❗️Important note

This module adds properties from the jsdom window namespace to the Node.js global namespace. This is explicitly recommended against by jsdom. There may be scenarios where this is ok for your use case but please read through the linked wiki page and make sure you understand the caveats. If you don't need the browser environment enabled globally, window may be a better solution.


npm install --save browser-env

Or if you're just using for testing you'll probably want:

npm install --save-dev browser-env


// Init

// Now you have access to a browser like environment in Node.js:

typeof window;
// 'object'

typeof document;
// 'object'

var div = document.createElement('div');
// HTMLDivElement

div instanceof HTMLElement
// true

By default everything in the jsdom window namespace is tacked on to the Node.js global namespace (excluding existing Node.js properties e.g console, setTimout). If you want to trim this down you can pass an array of required properties:

// Init

typeof window;
// 'object'

typeof document;
// 'undefined'

You can also pass a config object straight through to jsdom. This can be done with or without specifying required properties.

require('browser-env')(['window'], { userAgent: 'My User Agent' });

// or

require('browser-env')({ userAgent: 'My User Agent' });

You can of course also assign to a function:

var browserEnv = require('browser-env');

// or

import browserEnv from 'browser-env';


  • window - Exports a jsdom window object


MIT © Luke Childs