Quokka plugin to enable browser environment via jsdom

Downloads in past


8451.0.164 years ago7 years agoMinified + gzip package size for jsdom-quokka-plugin in KB


Quokka.js plugin to enable browser-like environment via jsdom.


npm install jsdom-quokka-plugin

Note that you may install the plugin to the Quokka config folder instead of installing it to your local project.


Specify the plugin in Quokka configuration settings:
    "plugins": ["jsdom-quokka-plugin"]

If you need to, you may pass additional configuration options to the plugin:
    "plugins": ["jsdom-quokka-plugin"],
    "jsdom": {
        "file": "/html/file/path"
        "html": "...",
        "userAgent": "...",
        "config": {...}

The jsdom.file setting allows to specify a path to any HTML file.
The jsdom.html setting allows to specify any HTML as a string.
The jsdom.config setting is the jsdom options setting.

Web Canvas API

If you want to use HTMLCanvasElement objects with Quokka and jsdom then you must also install the canvas package in the same location as jsdom-quokka-plugin:

Example 1

Specify inline Quokka configuration to use the jsdom-quokka-plugin setting html from config:
    plugins: ['jsdom-quokka-plugin'],
    jsdom: {html: `<div id="test">Hello</div>`}

const testDiv = document.getElementById('test');


screen shot 2018-03-08 at 1 12 27 pm
In this example, inline Quokka config is used. You may also place the config into the global Quokka config file or into your package.json.

Example 2

Create a new project that loads config from project configuration and sets html from a file:
  1. Create a new folder for your scratch project.
  2. Using terminal in the new folder, run npm init (accept all defaults).
  3. Using terminal in the new folder, Install jsdom-quokka-plugin with npm install jsdom-quokka-plugin –save-dev.
  4. In the root of the new folder, create a file test.html with the contents:
    <title>This is my sample page.</title>
    <p id="testDiv">Hello World</p>

  1. In the root of the new folder, create a file test.js with the contents:
const testDiv = document.getElementById('testDiv');

testDiv.textContent //?

  1. In the root of the new folder, create a file .quokka with the contents:
  "plugins": ["jsdom-quokka-plugin"],
  "jsdom": {"file": "test.html"}

  1. Start Quokka on test.js. You should now see editor output and Quokka console output of Hello World.