Registry / testing / plugin-javascript

plugin-javascript

library2026.6.0jsnpmunverified

A plugin for sitespeed.io that identifies and logs JavaScript errors during web performance testing. Current stable version is 2026.6.0, released as part of sitespeed.io's yearly release cycle. Integrates seamlessly with sitespeed.io to capture JS errors from browser sessions and report them. Unlike general error monitoring tools, it is specifically built for sitespeed.io's plugin architecture and complements webperf-core. Requires Node.js >=20.x and sitespeed.io as a peer dependency.

testing

npm install plugin-javascript

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PLUGIN-JAVASCRIPT

plugin-javascript

testingjavascriptv2026.6.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import pluginJavascript from 'plugin-javascript'

✗ const pluginJavascript = require('plugin-javascript');

Package is ESM-only since v2026; CommonJS require will fail.

PluginJavascript

✓ import { PluginJavascript } from 'plugin-javascript'

✗ import PluginJavascript from 'plugin-javascript'

Named export for TypeScript type usage.

registerPlugin

✓ import { registerPlugin } from 'plugin-javascript'

✗ import { register } from 'plugin-javascript'

Function to manually register the plugin if not using auto-detection.

Shows how to enable and use the plugin with sitespeed.io programmatically, capturing JavaScript errors from a web page.

import pluginJavascript from 'plugin-javascript'; import sitespeedio from 'sitespeed.io'; const options = { urls: ['https://www.example.com'], plugins: { 'plugin-javascript': { enabled: true } } }; (async () => { const result = await sitespeedio.run(options); console.log('JS errors found:', result.javascriptErrors); })();

Debug

Known issues

breakingVersion 2026.0+ drops support for Node.js <20

fix

Upgrade Node.js to version 20.x or higher.

affects: >=2026.0

breakingESM-only: CommonJS require() will throw an error

fix

Use import syntax or dynamic import().

affects: >=2026.0

deprecatedThe plugin configuration key 'javascript' is deprecated; use 'plugin-javascript' instead

fix

Change config from { javascript: { ... } } to { 'plugin-javascript': { ... } }.

affects: >=2025.0

gotchaPlugin only works when sitespeed.io is installed; cannot be used standalone

fix

Ensure sitespeed.io is a peer dependency and loaded first.

affects: all

gotchaJavaScript errors are only captured if the browser supports error logging; some headless modes may miss errors

fix

Use a browser configuration that enables JavaScript error reporting.

affects: all

Errors

Common errors & fixes

Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'plugin-javascript'

Package not installed or not in node_modules

fix

Run npm install plugin-javascript

TypeError: config.plugins['plugin-javascript'] is not a valid plugin configuration

Using deprecated key 'javascript' instead of 'plugin-javascript'

fix

Change config to use 'plugin-javascript' as the plugin key

SyntaxError: The requested module 'plugin-javascript' does not provide an export named 'default'

Using CommonJS require() with ESM-only package

fix

Use import or dynamic import, or downgrade to a version that supports CommonJS

Upgrade

Version history

2026.6.0latest on npm

Audit

Dependencies

sitespeed.iorequiredPeer dependency; the plugin only works when loaded by sitespeed.io

Agent activity

9 hits · last 30 days

node

Resources

githubhttps://github.com/Webperf-se/plugin-javascript ↗

packageplugin-javascript ↗

homepagehttps://github.com/Webperf-se/plugin-javascript#readme ↗