jsdom-global

Enables DOM in Node.js

jsdom-global will inject

document

window

Install

Requires jsdom.

npm install --save-dev --save-exact jsdom jsdom-global

Note

jsdom-global now requires jsdom v10 or above. If you need jsdom v9 and below, use the previous version (

[email protected]

Usage

Just invoke it to turn your Node.js environment into a DOM environment.

require('jsdom-global')()

// you can now use the DOM
document.body.innerHTML = 'hello'

You may also pass parameters to jsdomGlobal() like so:

require('jsdom-global')(html, options)

options

To clean up after itself, just invoke the function it returns.

var cleanup = require('jsdom-global')()

// do things
cleanup()

Tape

In tape, run it before your other tests.

require('jsdom-global')()

test('your tests', (t) => {
  /* and so on... */
})

Mocha

Simple: Use Mocha's

--require

test/mocha.opts

-r jsdom-global/register

Advanced: For finer control, you can instead add it via mocha's

before

after

before(function () {
  this.jsdom = require('jsdom-global')()
})

after(function () {
  this.jsdom()
})

ES2015

If you prefer to use

import

require

jsdom-global/register

import 'jsdom-global/register'
import React from 'react'
import jQuery from 'jquery'
// ...

Browserify

If you use Browserify on your tests (eg: smokestack, tape-run, budo, hihat, zuul, and so on), doing

require('jsdom-global')()

• Writing your tests (

  test.js

  ):

  require('jsdom-global')()

  // ...do your tests here

• Running it with smokestack:

  browserify test.js | smokestack          # run in a browser
  node test.js                             # or the console
  browserify test.js --no-bundle-external  # also works (but why bother?)

• Running it with Babel (babelify or babel-cli):

  browserify test.js -t babelify | smokestack  # run in a browser (with babel)
  babel-node test.js                           # or the console

Thanks

jsdom-global © 2016+, Rico Sta. Cruz. Released under the MIT License.
Authored and maintained by Rico Sta. Cruz with help from contributors (list).

ricostacruz.com  ·  GitHub @rstacruz  ·  Twitter @rstacruz