Enable window and document
This package enables the window and document globals for executing most browser JS. For fully simulating the browser, see the enable-browser-mode plugin.
Usage
/* [CommonJS] */
require('enable-window-document');
- or -
/* [ES6] */
import 'enable-window-document'
No variable assignment required, just call it! The variables are stored on the global object so you can refer to them as you normally would in browser JS.
Example
Won't work:
console.log(document.createElement('a'));
> ReferenceError: document is not defined
Works like a charm:
require('enable-window-document');
console.log(document.createElement('a'));
> HTMLAnchorElement {Symbol(impl): HTMLAnchorElementImpl}
Implementation
This package simply creates a blank JSDOM with a few lines of code, and stores the global window and document variables, which point to the empty DOM:
let JSDOM = require('jsdom'),
DOM = new JSDOM.JSDOM(`<html><body></body></html>`, {
url: 'https://localhost',
resources: 'usable',
runScripts: global.UNSAFE_MODE
? 'dangerously'
: 'outside-only'
});
global.window = DOM.window,
global.document = window.document;
The url param is set for compatibility reasons related to localStorage, and resources and runScripts are set by default so that external scripts work as expected.
Unsafe Mode
By default, JSDOM is called with runScripts: 'outside-only'. Set global.UNSAFE_MODE before your require('enable-window-document') call to enable dangerous mode and execute external scripts when added to DOM.