html-snapshots 5.11.0 → 6.1.0

package/lib/html-snapshots.js

@@ -10,52 +10,19 @@
  * Licensed under the MIT license.
  */
 
-const spawn = require("child_process").spawn;
-const path = require("path");
-const EventEmitter = require("events").EventEmitter;
-const fs = require("fs");
+const { spawn } = require("node:child_process");
+const path = require("node:path");
+const { EventEmitter } = require("node:events");
+const fs = require("node:fs");
 const asyncLib = require("async");
 const common = require("./common");
 const inputFactory = require("./input-generators");
-const Notifier = require("./async").Notifier;
+const { Notifier } = require("./async");
 
-/**
- * Determine the default phantomJS module path. This is overridden by the
- * phatomjs option.
- *
- * This function, (technique and concerns) originated from karma-phantomjs-launcher:
- *
- * The MIT License
- * Copyright (C) 2011-2013 Google, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy of
- * this software and associated documentation files (the "Software"), to deal in
- * the Software without restriction, including without limitation the rights to
- * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
- * of the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- */
-function defaultPhantomJSExePath () {
-  // If the path we're given by phantomjs is to a .cmd, it is pointing to a global copy.
-  // Using the cmd as the process to execute causes problems cleaning up the processes
-  // so we walk from the cmd to the phantomjs.exe and use that instead.
-
-  const phantomSource = require("phantomjs-prebuilt").path;
-
-  if (path.extname(phantomSource).toLowerCase() === ".cmd") {
-    return path.join(path.dirname( phantomSource ), "//node_modules//phantomjs-prebuilt//lib//phantom//bin//phantomjs.exe");
-  }
-
-  return phantomSource;
-}
-
-const phantomDir = "./phantom";
-const phantomSnapshotScript = path.join(phantomDir, "default.js");
 const puppeteerDir = "./puppeteer";
 const puppeteerSnapshotScript = path.join(puppeteerDir, "index.js");
+const playwrightDir = "./playwright";
+const playwrightSnapshotScript = path.join(playwrightDir, "index.js");
 
 /**
  * This module's defaults
@@ -63,9 +30,8 @@ const puppeteerSnapshotScript = path.join(puppeteerDir, "index.js");
 const defaults = Object.freeze({
   input: "robots",
   browser: "puppeteer",
-  phantomjs: defaultPhantomJSExePath(),
-  phantomSnapshotScript: path.join(__dirname, phantomSnapshotScript),
   puppeteer: path.join(__dirname, puppeteerSnapshotScript),
+  playwright: path.join(__dirname, playwrightSnapshotScript),
   snapshotScript: path.join(__dirname, puppeteerSnapshotScript),
   outputDirClean: false,
   pollInterval: 500,
@@ -73,22 +39,18 @@ const defaults = Object.freeze({
 });
 
 /**
- * The worker task that launches phantomjs.
- *
  * @param {Object} input - An input object from an input generator.
- * @param {Array} input.phantomjsOptions - Actual Phantomjs options.
  * @param {String} input.outputFile - The output file that the html is written to.
  * @param {String} input.url - The url to get the html from.
  * @param {String} input.selector - The selector to wait for.
- * @param {String} input.timeout - The phantomjs timeout.
- * @param {String} input.checkInterval - The interval to poll for results.
- * @param {Boolean} input.useJQuery - True if selector is jquery selector.
- * @param {Boolean} input.verbose - True if verbose output is desired.
+ * @param {String} input.timeout - The entire process timeout.
+ * @param {Object} input.debug - The debug object.
+ * @param {Object} input.puppeteerLaunchOptions - overriding puppeteer launch options.
  * @param {Object} options - Input options.
  * @param {Object} options.snapshotScript - Snapshot script options.
  * @param {String} options.snapshotScript.script - Snapshot script name.
  * @param {String} options.snapshotScript.module - Snapshot script module.
- * @param {String} options.phantomjs - Full path to the Phantomjs exe.
+ * @param {String} options.puppeteer - Full path to the puppeteer exec.
  * @param {Object} notifier - The async Notifier instance for this run.
  * @param {Function} notifier.remove - Remove an outputFile from notifier.
  * @param {Function} notifier.setError - Set an error on the notifier.
@@ -96,34 +58,34 @@ const defaults = Object.freeze({
  * @param {Function} notifier.known - Check if a file is or has been processed.
  * @param {Function} qcb - async.queue callback function.
  */
-function phantomjsWorker (input, options, notifier, qcb) {
-  let cp, customModule;
+function puppeteerWorker (input, options, notifier, qcb) {
+  let filter = "false";
   let snapshotScript = options.snapshotScript;
-  const phantomjsOptions =
-    Array.isArray(input.phantomjsOptions) ? input.phantomjsOptions : [input.phantomjsOptions];
 
   // If the outputFile has NOT already been seen by the notifier, process.
   if (!notifier.known(input.outputFile)) {
 
-    // map snapshotScript object script to a real path
+    // map snapshotScript object script
     if (common.isObject(options.snapshotScript)) {
-      snapshotScript = `${path.join(__dirname, phantomDir, options.snapshotScript.script)}.js`;
-      customModule = options.snapshotScript.module;
+      snapshotScript = options.puppeteer;
+      if (options.snapshotScript.script === "removeScripts") {
+        filter = "./removeScripts";
+      } else {
+        filter = options.snapshotScript.module;
+      }
     }
 
-    cp = spawn(
-      options.phantomjs,
-      phantomjsOptions.concat([
-        snapshotScript,
-        input.outputFile,
+    const cp = spawn(
+      snapshotScript,
+      [ input.outputFile,
         input.url,
         input.selector,
         input.timeout,
-        input.checkInterval,
-        input.useJQuery,
-        input.verbose,
-        customModule
-      ]), { cwd: process.cwd(), stdio: "inherit", detached: true }
+        filter,
+        input.debug.flag,
+        input.debug.slowMo,
+        JSON.stringify(input.puppeteerLaunchOptions)
+      ], { cwd: process.cwd(), stdio: "inherit", detached: true }
     );
 
     cp.on("error", function (e) {
@@ -139,8 +101,7 @@ function phantomjsWorker (input, options, notifier, qcb) {
 
     // start counting
     notifier.add(input.outputFile, input.timeout);
-  }
-  else {
+  } else {
     // The input.outputFile is being or has been processed this run.
     qcb(0);
   }
@@ -153,12 +114,14 @@ function phantomjsWorker (input, options, notifier, qcb) {
  * @param {String} input.selector - The selector to wait for.
  * @param {String} input.timeout - The entire process timeout.
  * @param {Object} input.debug - The debug object.
- * @param {Object} input.puppeteerLaunchOptions - overriding puppeteer launch options.
+ * @param {Object} input.playwrightLaunchOptions - overriding playwright launch options.
+ *   May include a `browserType` key ("chromium" | "firefox" | "webkit") to select
+ *   the browser engine. Defaults to "chromium".
  * @param {Object} options - Input options.
  * @param {Object} options.snapshotScript - Snapshot script options.
  * @param {String} options.snapshotScript.script - Snapshot script name.
  * @param {String} options.snapshotScript.module - Snapshot script module.
- * @param {String} options.puppeteer - Full path to the puppeteer exec.
+ * @param {String} options.playwright - Full path to the playwright exec.
  * @param {Object} notifier - The async Notifier instance for this run.
  * @param {Function} notifier.remove - Remove an outputFile from notifier.
  * @param {Function} notifier.setError - Set an error on the notifier.
@@ -166,7 +129,7 @@ function phantomjsWorker (input, options, notifier, qcb) {
  * @param {Function} notifier.known - Check if a file is or has been processed.
  * @param {Function} qcb - async.queue callback function.
  */
-function puppeteerWorker (input, options, notifier, qcb) {
+function playwrightWorker (input, options, notifier, qcb) {
   let filter = "false";
   let snapshotScript = options.snapshotScript;
   
@@ -175,7 +138,7 @@ function puppeteerWorker (input, options, notifier, qcb) {
 
     // map snapshotScript object script
     if (common.isObject(options.snapshotScript)) {
-      snapshotScript = options.puppeteer;
+      snapshotScript = options.playwright;
       if (options.snapshotScript.script === "removeScripts") {
         filter = "./removeScripts";
       } else {
@@ -192,7 +155,7 @@ function puppeteerWorker (input, options, notifier, qcb) {
         filter,
         input.debug.flag,
         input.debug.slowMo,
-        JSON.stringify(input.puppeteerLaunchOptions)
+        JSON.stringify(input.playwrightLaunchOptions)
       ], { cwd: process.cwd(), stdio: "inherit", detached: true }
     );
 
@@ -230,10 +193,10 @@ function prepOptions (options) {
     options.input = "array";
   }
 
-  // If phantomjs browser, make sure the default snapshotScript is correctly set.
-  if (options.browser === 'phantomjs') {
+  // If playwright browser, make sure the default snapshotScript is correctly set.
+  if (options.browser === "playwright") {
     if (!options.snapshotScript || options.snapshotScript === options.puppeteer) {
-      options.snapshotScript = options.phantomSnapshotScript;
+      options.snapshotScript = options.playwright;
     }
   }
 }
@@ -306,7 +269,7 @@ function run (options, listener) {
     options._abort = notifier.abort.bind(notifier, q);
 
     const worker =
-      options.browser === 'puppeteer' ? puppeteerWorker : phantomjsWorker;
+      options.browser === "playwright" ? playwrightWorker : puppeteerWorker;
 
     // generate input for the snapshots.
     return inputGenerator.run(options, input => {

package/lib/input-generators/_base.js

@@ -7,9 +7,9 @@
  * Licensed under the MIT license.
  */
 
-const EventEmitter = require("events").EventEmitter;
-const path = require("path");
-const urlm = require("url");
+const { EventEmitter } = require("node:events");
+const path = require("node:path");
+const urlm = require("node:url");
 const common = require("../common");
 
 // Defaults for this module
@@ -25,7 +25,7 @@ const defaults = Object.freeze({
   checkInterval: 250,
   useJQuery: false,
   verbose: false,
-  phantomjsOptions: "",
+  playwrightLaunchOptions: {},
   puppeteerLaunchOptions: {},
   debug: {
     flag: "false",
@@ -116,7 +116,8 @@ function prepOptions (options, listener) {
 
   // Prep single, global object options for normalization.
   [
-    "puppeteerLaunchOptions"
+    "puppeteerLaunchOptions",
+    "playwrightLaunchOptions"
   ]
   .forEach((optionName) => {
     prepSingleObjectOptions(optionName, options);  
@@ -126,7 +127,7 @@ function prepOptions (options, listener) {
   // The certain arguments are per-page options.
   // However, outputPath is a special case
   [
-    "selector", "timeout", "useJQuery", "verbose", "phantomjsOptions",
+    "selector", "timeout", "useJQuery", "verbose", "playwrightLaunchOptions",
     "puppeteerLaunchOptions"
   ]
   .forEach((perPageOption) => {
@@ -152,7 +153,7 @@ function prepOptions (options, listener) {
  * @returns {String} The 'path' part of the file output path.
  */
 function getOutputPath (options, page, parse) {
-  const pagePart = urlm.parse(page);
+  const pagePart = common.parseUrl(page);
   // if outputPath was normalized with an object, let the key passthru
   let outputPath = options.outputPath(page, true);
 
@@ -163,7 +164,7 @@ function getOutputPath (options, page, parse) {
 
   // if the outputPath is really still a url, fix it to path+hash
   if (common.isUrl(outputPath)) {
-    outputPath = pagePart.path + (pagePart.hash ? pagePart.hash : "");
+    outputPath = `${pagePart.pathname}${pagePart.search}${pagePart.hash ? pagePart.hash : ""}`;
   }
 
   // if the caller wants the url parse output, return it
@@ -254,7 +255,7 @@ module.exports = {
    * @param {Number} options.checkInterval - The millisecond resolute poll interval.
    * @param {Function} options.userJQuery - Produces a jquery bool given a page url.
    * @param {Function} options.verbose - Produces a verbose bool given a page url.
-   * @param {Function} options.phantomjsOptions - Produces phantomjs options given a page url.
+   * @param {Function} options.playwrightLaunchOptions - Produces playwright launch options given a page url.
    * @param {Function} options.puppeteerLaunchOptions - Produces puppeteer launch options given a page url.
    * @param {Object} options.debug - Produces debug options given a page url.
    * @param {Function} options._inputEmitter - The EventEmitter to generate input.
@@ -288,8 +289,8 @@ module.exports = {
         useJQuery: options.useJQuery(page),
         // map the input page to a verbose flag
         verbose: options.verbose(page),
-        // map the input page to phantomJS options
-        phantomjsOptions: options.phantomjsOptions(page),
+        // map the input page to playwright launch options
+        playwrightLaunchOptions: options.playwrightLaunchOptions(page),
         // map the input page to puppeteer launch options
         puppeteerLaunchOptions: options.puppeteerLaunchOptions(page),
         // useful for puppeteer testing, debugging

package/lib/input-generators/array.js

@@ -8,7 +8,6 @@
  * Licensed under the MIT license.
  */
 
-const urlm = require("url");
 const common = require("../common");
 const base = require("./_base");
 
@@ -38,7 +37,7 @@ function generateInput (options) {
   const result = new Promise((resolve, reject) => {
     if (Array.isArray(options.source)) {
       const all = options.source.every(sourceUrl => {
-        const url = urlm.parse(sourceUrl);
+        const url = common.parseUrl(sourceUrl);
         const opts = Object.assign({}, options, {
           protocol: url.protocol,
           auth: url.auth,

package/lib/input-generators/index.js

@@ -28,7 +28,7 @@ module.exports = {
 
     if (input) {
       input = (""+input).replace(" ", "").toLowerCase();
-      hasInput = input && input.charAt(0) !== '_' && input !== "index";
+      hasInput = input && input.charAt(0) !== "_" && input !== "index";
     }
 
     try {
@@ -36,7 +36,7 @@ module.exports = {
         result = require( "./" + input);
       }
     } catch (e) {
-      console.error("Input generator load failed '" + input + "'", e)
+      console.error(`Input generator load failed '${input}'`, e);
       /* return the "null" generator on error */
     }
 

package/lib/input-generators/robots.js

@@ -8,7 +8,7 @@
  * Licensed under the MIT license.
  */
 
-const fs = require("fs").promises;
+const { promises: fs } = require("node:fs");
 const common = require("../common");
 const { sitemapCollection: smc } = require("../common/sitemap");
 const base = require("./_base");

package/lib/input-generators/textfile.js

@@ -8,7 +8,7 @@
  * Licensed under the MIT license.
  */
 
-const fs = require("fs").promises;
+const { promises: fs } = require("node:fs");
 const base = require("./_base");
 const common = require("../common");
 
@@ -50,7 +50,7 @@ function generateInput (options) {
     .then(data => {
       if (data) {
         let error;
-        data.toString().split('\n').every(line => {
+        data.toString().split("\n").every(line => {
           const page = line.replace(/^\s+|\s+$/g, "");
 
           if (!base.input(options, page)) {

package/lib/playwright/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env -S node --unhandled-rejections=strict
+/**
+ * playwright process entry point
+ *
+ * Command line arguments:
+ * 0   - /path/to/node
+ * 1   - *this script*
+ * 2   - outputFile
+ * 3   - url
+ * 4   - selector
+ * [5] - timeout
+ * [6] - filter
+ * [7] - debug
+ * [8] - slowMo
+ * [9] - arbitrary launchOptions (JSON)
+ *
+ * launchOptions may include a `browserType` key ("chromium" | "firefox" | "webkit")
+ * to select the browser engine. Defaults to "chromium".
+ *
+ * Copyright (c) 2013 - 2025 Alex Grant, LocalNerve, contributors
+ * Licensed under the MIT license.
+ */
+const path = require("node:path");
+const { promises: fs } = require("node:fs");
+const playwright = require("playwright");
+
+if (process.argv.length < 5) {
+  throw Error(`playwright script '${
+    process.argv[1]
+  }' expected these arguments:\n\
+  OUTPUTFILE URL SELECTOR [TIMEOUT FILTER DEBUG SLOWMO LAUNCHOPTIONS]`);
+}
+
+const launchOpts = process.argv[9] ? JSON.parse(process.argv[9]) : null;
+
+// browserType is a playwright concern, not a launch option — extract it before
+// passing the rest through to playwright.launch()
+const { browserType: browserTypeKey = "chromium", ...extraLaunchOpts } = launchOpts ?? {};
+
+if (!["chromium", "firefox", "webkit"].includes(browserTypeKey)) {
+  throw Error(`playwright script: unsupported browserType '${browserTypeKey}'. \
+Must be one of: chromium, firefox, webkit`);
+}
+
+const options = {
+  outputFile: process.argv[2],
+  url: process.argv[3],
+  selector: process.argv[4],
+  timeout: process.argv[5] ? parseInt(process.argv[5], 10) : 10000,
+  filter: process.argv[6] && process.argv[6] !== "false" ? process.argv[6] : null,
+  debug: process.argv[7] && process.argv[7].toLowerCase() === "true",
+  slowMo: process.argv[8] ? parseInt(process.argv[8], 10) : 500,
+};
+
+const launchOptions = {
+  ...(options.debug ? {
+    headless: false,
+    slowMo: options.slowMo,
+    devtools: browserTypeKey === "chromium"  // devtools only supported in chromium
+  } : {
+    headless: true
+  }),
+  ...extraLaunchOpts
+};
+
+/**
+ * Run the snapshot script.
+ *
+ * @returns {Promise<string>} on completion
+ */
+async function run () {
+  let timeLeft, browser;
+  const start = Date.now();
+
+  timeLeft = options.timeout - 200; // leave some room for reporting
+  if (timeLeft < 0) timeLeft = 0;
+
+  try {
+    const filter =
+      options.filter ? require(options.filter) : passthru => passthru;
+
+    const browserType = playwright[browserTypeKey];
+    browser = await browserType.launch(launchOptions);
+    const page = await browser.newPage();
+
+    await page.goto(options.url, {
+      timeout: timeLeft
+    });
+
+    timeLeft -= (Date.now() - start);
+    if (timeLeft < 0) timeLeft = 0;
+
+    await fs.mkdir(path.dirname(options.outputFile), {
+      recursive: true
+    });
+
+    await page.waitForSelector(options.selector, {
+      state: "visible",
+      timeout: timeLeft
+    });
+
+    const content = await page.content();
+    await fs.writeFile(options.outputFile, filter(content));
+    const elapsed = Date.now() - start;
+
+    await browser.close();
+
+    return `snapshot for ${options.url} finished in ${elapsed} ms\n\
+  written to ${options.outputFile}`;
+  } catch (e) {
+    const err = new Error(`failed to snapshot ${options.url}`, {
+      cause: e
+    });
+    if (browser) {
+      browser.close().finally(() => {
+        throw err;
+      });
+    }
+    throw err;
+  }
+}
+
+run().then(console.log).catch(e => {
+  throw e;
+});

package/lib/playwright/removeScripts.js

@@ -0,0 +1,11 @@
+/**
+ * Remove all script tags from content
+ * 
+ * Copyright (c) 2013 - 2025 Alex Grant, LocalNerve, contributors
+ * Licensed under the MIT license. 
+ */
+function removeScriptTags (content) {
+  return content.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "");
+}
+
+module.exports = removeScriptTags;

package/lib/puppeteer/index.js

@@ -17,9 +17,9 @@
  * Copyright (c) 2013 - 2025 Alex Grant, LocalNerve, contributors
  * Licensed under the MIT license.
  */
-const puppeteer = require('puppeteer');
-const path = require('path');
-const { promises: fs } = require('fs');
+const path = require("node:path");
+const { promises: fs } = require("node:fs");
+const puppeteer = require("puppeteer");
 
 if (process.argv.length < 5) {
   throw Error(`puppeteer script '${
@@ -33,8 +33,8 @@ const options = {
   url: process.argv[3],
   selector: process.argv[4],
   timeout: process.argv[5] ? parseInt(process.argv[5], 10) : 10000,
-  filter: process.argv[6] && process.argv[6] !== 'false' ? process.argv[6] : null,
-  debug: process.argv[7] && process.argv[7].toLowerCase() === 'true' ? true : false,
+  filter: process.argv[6] && process.argv[6] !== "false" ? process.argv[6] : null,
+  debug: process.argv[7] && process.argv[7].toLowerCase() === "true" ? true : false,
   slowMo: process.argv[8] ? parseInt(process.argv[8], 10) : 500,
   launchOpts: process.argv[9] ? JSON.parse(process.argv[9]) : null
 };
@@ -44,7 +44,7 @@ const launchOptions = {
     slowMo: options.slowMo,
     devtools: true
   } : {
-    headless: 'new'
+    headless: true
   }),
   ...(options.launchOpts ?? {})
 };
@@ -79,7 +79,7 @@ async function run () {
     });
 
     await page.waitForSelector(options.selector, {
-      Visible: true,
+      visible: true,
       timeout: timeLeft
     });
 

package/lib/puppeteer/removeScripts.js

@@ -5,7 +5,7 @@
  * Licensed under the MIT license. 
  */
 function removeScriptTags (content) {
-  return content.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '');
+  return content.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "");
 }
 
 module.exports = removeScriptTags;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "html-snapshots",
-  "version": "5.11.0",
+  "version": "6.1.0",
   "author": {
     "name": "Alex Grant",
     "email": "alex@localnerve.com",
     "url": "https://www.localnerve.com"
   },
   "homepage": "https://github.com/localnerve/html-snapshots",
-  "description": "A selector-based html snapshot tool using Puppeteer or PhantomJS that sources sitemap.xml, robots.txt, or arbitrary input",
+  "description": "A selector-based html snapshot tool using Puppeteer or Playwright that sources sitemap.xml, robots.txt, or arbitrary input",
   "contributors": [
     {
       "name": "Alex Grant",
@@ -19,26 +19,38 @@
   },
   "scripts": {
     "lint": "eslint .",
-    "test": "mocha test/mocha/**/*.js --exit --recursive --reporter spec",
-    "test:async": "mocha test/mocha/async/test.js --exit --reporter spec",
-    "test:common": "mocha test/mocha/common/*.js --exit --reporter spec",
-    "test:common:debug": "mocha --inspect-brk test/mocha/common/*.js --exit --reporter spec",
-    "test:browsers": "mocha test/mocha/browsers/test.js --exit --reporter spec",
-    "test:browsers:cover": "c8 -- npm run test:browsers",
-    "test:input-generators": "mocha test/mocha/input-generators/*.js --exit --reporter spec",
-    "test:input-generators:debug": "mocha --inspect-brk test/mocha/input-generators/*.js --exit --reporter spec",
-    "test:html-snapshots": "mocha test/mocha/html-snapshots/*.js --exit --reporter spec",
-    "test:html-snapshots:robots": "mocha test/mocha/html-snapshots/*.js --grep \"robots\" --exit --reporter spec",
-    "test:html-snapshots:puppeteer": "mocha test/mocha/html-snapshots/*.js --grep \"puppeteer specific\" --exit --reporter spec",
-    "test:html-snapshots:debug": "mocha --inspect-brk test/mocha/html-snapshots/*.js --exit --reporter spec",
-    "test:cover": "c8 -- npm test",
-    "validate": "npm ls"
+    "_cleancov": "node -e \"const fs=require('fs');fs.rmSync('coverage',{recursive:true,force:true});fs.mkdirSync('coverage',{recursive:true})\"",
+    "_test": "node --test --experimental-test-coverage --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=\"coverage/lcov.info\"",
+    "pretest": "npm run _cleancov",
+    "test": "npm run _test -- --test-coverage-exclude=\"test/**\" --test-concurrency=1 \"test/suites/**/*.spec.js\"",
+    "pretest:24": "npm run _cleancov",
+    "test:24": "npm run _test -- --test-coverage-exclude=\"test/**\" --test-isolation=none \"test/suites/**/*.spec.js\"",
+    "pretest:async": "npm run _cleancov",
+    "test:async": "npm run _test -- \"test/suites/async/*.spec.js\" --test-coverage-exclude=\"test/**\"",
+    "pretest:common": "npm run _cleancov",
+    "test:common": "npm run _test -- \"test/suites/common/*.spec.js\" --test-coverage-exclude=\"test/**\"",
+    "pretest:browsers": "npm run _cleancov",
+    "test:browsers": "npm run _test -- \"test/suites/browsers/*.spec.js\" --test-coverage-exclude=\"test/**\"",
+    "pretest:input-generators": "npm run _cleancov",
+    "test:input-generators": "npm run _test -- \"test/suites/input-generators/*.spec.js\" --test-coverage-exclude=\"test/**\"",
+    "pretest:html-snapshots": "npm run _cleancov",
+    "test:html-snapshots": "node --test --experimental-test-coverage --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=\"coverage/lcov.info\" \"test/suites/html-snapshots/*.spec.js\" --test-coverage-exclude=\"test/**\""
   },
   "main": "./lib/html-snapshots",
   "repository": {
     "type": "git",
     "url": "https://github.com/localnerve/html-snapshots.git"
   },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/localnerve"
+    },
+    {
+      "type": "paypal",
+      "url": "https://www.paypal.com/ncp/payment/DHCB5GUYMGX5U"
+    }
+  ],
   "keywords": [
     "SEO",
     "html",
@@ -52,30 +64,21 @@
   "dependencies": {
     "async": "3.2.6",
     "async-lock": "1.4.1",
-    "combine-errors": "3.0.3",
-    "phantomjs-prebuilt": "2.1.16",
-    "puppeteer": "^24.43.0",
+    "playwright": "1.61.0",
+    "puppeteer": "25.1.0",
     "xml2js": "0.6.2"
   },
   "devDependencies": {
-    "eslint": "^10.3.0",
     "@eslint/js": "^10.0.1",
-    "globals": "^17.6.0",
+    "eslint": "^10.5.0",
+    "eslint-plugin-n": "18.1.0",
     "express": "^5.2.1",
-    "mocha": "^11.7.5",
-    "c8": "^11.0.0",
+    "globals": "^17.6.0",
     "server-destroy": "^1.0.1",
     "sitemap-xml": "^0.1.0"
   },
-  "overrides": {
-    "request": "npm:@cypress/request@4.0.0",
-    "diff": "^9.0.0",
-    "glob": "^13.0.6",
-    "serialize-javascript": "^7.0.5",
-    "brace-expansion": "^5.0.5"
-  },
   "license": "MIT",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   }
 }