# browser-env

> Simulates a global browser environment using jsdom

Latest version **3.3.0** (published 2019-11-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install browser-env
pnpm add browser-env
yarn add browser-env
bun add browser-env
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.3.0 |
| Published | 2019-11-05 |
| First published | 2013-02-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=4 |
| Dependencies | 1 |
| Unpacked size | 42.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 177 |
| Author | Luke Childs |
| Maintainers | lukechilds |
| Keywords | simulate, global, node, browser, environment, env |

## Links

- npm: https://www.npmjs.com/package/browser-env
- Repository: https://github.com/lukechilds/browser-env
- Homepage: https://github.com/lukechilds/browser-env#readme
- Issues: https://github.com/lukechilds/browser-env/issues
- npm.io page: https://npm.io/package/browser-env

## Dependencies (1)

- [window](https://npm.io/package/window.md) 4.2.6

## Alternatives

- [replicas-cli](https://npm.io/package/replicas-cli.md) — 3.0K weekly downloads
- [env-contract](https://npm.io/package/env-contract.md) — 133 weekly downloads
- [@openveo/api](https://npm.io/package/@openveo/api.md) — 61 weekly downloads
- [@ryniaubenpm2/cumque-error-reiciendis](https://npm.io/package/@ryniaubenpm2/cumque-error-reiciendis.md) — 54 weekly downloads
- [ts-global-type-extra](https://npm.io/package/ts-global-type-extra.md) — 11 weekly downloads

## Recent versions

- 3.3.0 (latest) — 2019-11-05
- 3.2.6 — 2019-02-23
- 3.2.5 — 2018-02-06
- 3.2.4 — 2017-11-27
- 3.2.3 — 2017-11-23
- 3.2.2 — 2017-11-03
- 3.2.1 — 2017-10-02
- 3.2.0 — 2017-08-23
- 3.1.2 — 2017-08-10
- 3.1.1 — 2017-08-10
- 3.1.0 — 2017-07-05
- 3.0.2 — 2017-06-30
- 3.0.1 — 2017-06-30
- 3.0.0 — 2017-06-30
- 2.0.31 — 2017-05-03
- … 25 more at https://npm.io/package/browser-env/versions

## README

# browser-env

> Simulates a global browser environment using [`jsdom`](https://github.com/tmpvar/jsdom).

[![Build Status](https://travis-ci.org/lukechilds/browser-env.svg?branch=master)](https://travis-ci.org/lukechilds/browser-env)
[![Coverage Status](https://coveralls.io/repos/github/lukechilds/browser-env/badge.svg?branch=master)](https://coveralls.io/github/lukechilds/browser-env?branch=master)
[![npm](https://img.shields.io/npm/dm/browser-env.svg)](https://www.npmjs.com/package/browser-env)
[![npm](https://img.shields.io/npm/v/browser-env.svg)](https://www.npmjs.com/package/browser-env)

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](https://github.com/tmpvar/jsdom/wiki/Don't-stuff-jsdom-globals-onto-the-Node-global) 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`](https://github.com/lukechilds/window) may be a better solution.

## Install

```shell
npm install --save browser-env
```

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

```shell
npm install --save-dev browser-env
```

## Usage

```js
// Init
require('browser-env')();

// 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:

```js
// Init
require('browser-env')(['window']);

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.

```js
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:

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

// or

import browserEnv from 'browser-env';
browserEnv();
```

`browser-env` can also be preloaded at node startup as:

```sh
node -r browser-env/register test.js
```

## Related

- [`window`](https://github.com/lukechilds/window) - Exports a jsdom window object

## License

MIT © Luke Childs

---
_Source: https://npm.io/package/browser-env · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._