html-snapshots 1.1.0 → 1.3.0

package/examples/sitemap-index/package-lock.json

@@ -8,7 +8,7 @@
       "name": "html-snapshots-example",
       "version": "0.1.0",
       "dependencies": {
-        "html-snapshots": "^1.0.1"
+        "html-snapshots": "^1.2.0"
       }
     },
     "node_modules/@sindresorhus/is": {
@@ -39,9 +39,9 @@
       "integrity": "sha512-SZs7ekbP8CN0txVG2xVRH6EgKmEm31BOxA07vkFaETzZz1xh+cbt8BcI0slpymvwhx5dlFnQG2rTlPVQn+iRPQ=="
     },
     "node_modules/@types/node": {
-      "version": "18.7.23",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.7.23.tgz",
-      "integrity": "sha512-DWNcCHolDq0ZKGizjx2DZjR/PqsYwAcYUJmfMWqtVU2MBMG5Mo+xFZrhGId5r/O5HOuMPyQEcM6KUBp5lBZZBg==",
+      "version": "18.11.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.0.tgz",
+      "integrity": "sha512-IOXCvVRToe7e0ny7HpT/X9Rb2RYtElG1a+VshjwT00HxrM2dWBApHQoqsI6WiY7Q03vdf2bCrIGzVrkF/5t10w==",
       "optional": true
     },
     "node_modules/@types/yauzl": {
@@ -397,9 +397,9 @@
       }
     },
     "node_modules/devtools-protocol": {
-      "version": "0.0.1036444",
-      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1036444.tgz",
-      "integrity": "sha512-0y4f/T8H9lsESV9kKP1HDUXgHxCdniFeJh6Erq+FbdOEvp/Ydp9t8kcAAM5gOd17pMrTDlFWntoHtzzeTUWKNw=="
+      "version": "0.0.1045489",
+      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1045489.tgz",
+      "integrity": "sha512-D+PTmWulkuQW4D1NTiCRCFxF7pQPn0hgp4YyX4wAQ6xYXKOadSWPR3ENGDQ47MW/Ewc9v2rpC/UEEGahgBYpSQ=="
     },
     "node_modules/ecc-jsbn": {
       "version": "0.1.2",
@@ -501,9 +501,9 @@
       }
     },
     "node_modules/form-data-encoder": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/form-data-encoder/-/form-data-encoder-2.1.2.tgz",
-      "integrity": "sha512-FCaIOVTRA9E0siY6FeXid7D5yrCqpsErplUkE2a1BEiKj1BE9z6FbKB4ntDTwC4NVLie9p+4E9nX4mWwEOT05A==",
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/form-data-encoder/-/form-data-encoder-2.1.3.tgz",
+      "integrity": "sha512-KqU0nnPMgIJcCOFTNJFEA8epcseEaoox4XZffTgy8jlI6pL/5EFyR54NRG7CnCJN0biY7q52DO3MH6/sJ/TKlQ==",
       "engines": {
         "node": ">= 14.17"
       }
@@ -567,9 +567,9 @@
       }
     },
     "node_modules/got": {
-      "version": "12.5.1",
-      "resolved": "https://registry.npmjs.org/got/-/got-12.5.1.tgz",
-      "integrity": "sha512-sD16AK8cCyUoPtKr/NMvLTFFa+T3i3S+zoiuvhq0HP2YiqBZA9AtlBjAdsQBsLBK7slPuvmfE0OxhGi7N5dD4w==",
+      "version": "12.5.2",
+      "resolved": "https://registry.npmjs.org/got/-/got-12.5.2.tgz",
+      "integrity": "sha512-guHGMSEcsA5m1oPRweXUJnug0vuvlkX9wx5hzOka+ZBrBUOJHU0Z1JcNu3QE5IPGnA5aXUsQHdWOD4eJg9/v3A==",
       "dependencies": {
         "@sindresorhus/is": "^5.2.0",
         "@szmarczak/http-timer": "^5.0.1",
@@ -629,18 +629,18 @@
       }
     },
     "node_modules/html-snapshots": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/html-snapshots/-/html-snapshots-1.0.1.tgz",
-      "integrity": "sha512-BnVQ7pL/ybYWVdoktSHvp1NybZ1UOt3xd5vTQ8agO388hwU63oTqgZV4Xe2nxW0Bb83Xia9/VNiWPGrJ320Uhw==",
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/html-snapshots/-/html-snapshots-1.2.0.tgz",
+      "integrity": "sha512-/erOUW66PXzxzmq9daIt9F/sOGtLCKIjT7VuFUutNeZCtjiK6eM6bBiF9CFq9SOsyJ1sWqFasBUsq7F9GSnWpA==",
       "dependencies": {
         "async": "3.2.4",
         "async-lock": "1.3.2",
         "combine-errors": "3.0.3",
-        "got": "12.5.1",
+        "got": "12.5.2",
         "lodash": "4.17.21",
         "mkdirp": "1.0.4",
         "phantomjs-prebuilt": "2.1.16",
-        "puppeteer": "^18.0.5",
+        "puppeteer": "^19.0.0",
         "rimraf": "3.0.2",
         "xml2js": "0.4.23"
       },
@@ -1126,28 +1126,41 @@
       }
     },
     "node_modules/puppeteer": {
-      "version": "18.0.5",
-      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-18.0.5.tgz",
-      "integrity": "sha512-s4erjxU0VtKojPvF+KvLKG6OHUPw7gO2YV1dtOsoryyCbhrs444fXb4QZqGWuTv3V/rgSCUzeixxu34g0ZkSMA==",
+      "version": "19.0.0",
+      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-19.0.0.tgz",
+      "integrity": "sha512-3Ga5IVerQQ2hKU9q7T28RmcUsd8F2kL6cYuPcPCzeclSjmHhGydPBZL/KJKC02sG6J6Wfry85uiWpbkjQ5qBiw==",
       "hasInstallScript": true,
+      "dependencies": {
+        "https-proxy-agent": "5.0.1",
+        "progress": "2.0.3",
+        "proxy-from-env": "1.1.0",
+        "puppeteer-core": "19.0.0"
+      },
+      "engines": {
+        "node": ">=14.1.0"
+      }
+    },
+    "node_modules/puppeteer-core": {
+      "version": "19.0.0",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-19.0.0.tgz",
+      "integrity": "sha512-OljQ9W5M4cBX68vnOAGbcRkVENDHn6lfj6QYoGsnLQsxPAh6ExTQAhHauwdFdQkhYdDExZFWlKArnBONzeHY+g==",
       "dependencies": {
         "cross-fetch": "3.1.5",
         "debug": "4.3.4",
-        "devtools-protocol": "0.0.1036444",
+        "devtools-protocol": "0.0.1045489",
         "extract-zip": "2.0.1",
         "https-proxy-agent": "5.0.1",
-        "progress": "2.0.3",
         "proxy-from-env": "1.1.0",
         "rimraf": "3.0.2",
         "tar-fs": "2.1.1",
         "unbzip2-stream": "1.4.3",
-        "ws": "8.8.1"
+        "ws": "8.9.0"
       },
       "engines": {
         "node": ">=14.1.0"
       }
     },
-    "node_modules/puppeteer/node_modules/debug": {
+    "node_modules/puppeteer-core/node_modules/debug": {
       "version": "4.3.4",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz",
       "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==",
@@ -1163,7 +1176,7 @@
         }
       }
     },
-    "node_modules/puppeteer/node_modules/extract-zip": {
+    "node_modules/puppeteer-core/node_modules/extract-zip": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-2.0.1.tgz",
       "integrity": "sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==",
@@ -1182,7 +1195,7 @@
         "@types/yauzl": "^2.9.1"
       }
     },
-    "node_modules/puppeteer/node_modules/get-stream": {
+    "node_modules/puppeteer-core/node_modules/get-stream": {
       "version": "5.2.0",
       "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-5.2.0.tgz",
       "integrity": "sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==",
@@ -1196,7 +1209,7 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/puppeteer/node_modules/ms": {
+    "node_modules/puppeteer-core/node_modules/ms": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz",
       "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w=="
@@ -1528,9 +1541,9 @@
       "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="
     },
     "node_modules/ws": {
-      "version": "8.8.1",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.8.1.tgz",
-      "integrity": "sha512-bGy2JzvzkPowEJV++hF07hAD6niYSr0JzBNo/J29WsB57A2r7Wlc1UFcTR9IzrPvuNVO4B8LGqF8qcpsVOhJCA==",
+      "version": "8.9.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.9.0.tgz",
+      "integrity": "sha512-Ja7nszREasGaYUYCI2k4lCKIRTt+y7XuqVoHR44YpI49TtryyqbqvDMn5eqfW7e6HzTukDRIsXqzVHScqRcafg==",
       "engines": {
         "node": ">=10.0.0"
       },
@@ -1597,9 +1610,9 @@
       "integrity": "sha512-SZs7ekbP8CN0txVG2xVRH6EgKmEm31BOxA07vkFaETzZz1xh+cbt8BcI0slpymvwhx5dlFnQG2rTlPVQn+iRPQ=="
     },
     "@types/node": {
-      "version": "18.7.23",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.7.23.tgz",
-      "integrity": "sha512-DWNcCHolDq0ZKGizjx2DZjR/PqsYwAcYUJmfMWqtVU2MBMG5Mo+xFZrhGId5r/O5HOuMPyQEcM6KUBp5lBZZBg==",
+      "version": "18.11.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.0.tgz",
+      "integrity": "sha512-IOXCvVRToe7e0ny7HpT/X9Rb2RYtElG1a+VshjwT00HxrM2dWBApHQoqsI6WiY7Q03vdf2bCrIGzVrkF/5t10w==",
       "optional": true
     },
     "@types/yauzl": {
@@ -1873,9 +1886,9 @@
       "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="
     },
     "devtools-protocol": {
-      "version": "0.0.1036444",
-      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1036444.tgz",
-      "integrity": "sha512-0y4f/T8H9lsESV9kKP1HDUXgHxCdniFeJh6Erq+FbdOEvp/Ydp9t8kcAAM5gOd17pMrTDlFWntoHtzzeTUWKNw=="
+      "version": "0.0.1045489",
+      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1045489.tgz",
+      "integrity": "sha512-D+PTmWulkuQW4D1NTiCRCFxF7pQPn0hgp4YyX4wAQ6xYXKOadSWPR3ENGDQ47MW/Ewc9v2rpC/UEEGahgBYpSQ=="
     },
     "ecc-jsbn": {
       "version": "0.1.2",
@@ -1964,9 +1977,9 @@
       }
     },
     "form-data-encoder": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/form-data-encoder/-/form-data-encoder-2.1.2.tgz",
-      "integrity": "sha512-FCaIOVTRA9E0siY6FeXid7D5yrCqpsErplUkE2a1BEiKj1BE9z6FbKB4ntDTwC4NVLie9p+4E9nX4mWwEOT05A=="
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/form-data-encoder/-/form-data-encoder-2.1.3.tgz",
+      "integrity": "sha512-KqU0nnPMgIJcCOFTNJFEA8epcseEaoox4XZffTgy8jlI6pL/5EFyR54NRG7CnCJN0biY7q52DO3MH6/sJ/TKlQ=="
     },
     "fs-constants": {
       "version": "1.0.0",
@@ -2015,9 +2028,9 @@
       }
     },
     "got": {
-      "version": "12.5.1",
-      "resolved": "https://registry.npmjs.org/got/-/got-12.5.1.tgz",
-      "integrity": "sha512-sD16AK8cCyUoPtKr/NMvLTFFa+T3i3S+zoiuvhq0HP2YiqBZA9AtlBjAdsQBsLBK7slPuvmfE0OxhGi7N5dD4w==",
+      "version": "12.5.2",
+      "resolved": "https://registry.npmjs.org/got/-/got-12.5.2.tgz",
+      "integrity": "sha512-guHGMSEcsA5m1oPRweXUJnug0vuvlkX9wx5hzOka+ZBrBUOJHU0Z1JcNu3QE5IPGnA5aXUsQHdWOD4eJg9/v3A==",
       "requires": {
         "@sindresorhus/is": "^5.2.0",
         "@szmarczak/http-timer": "^5.0.1",
@@ -2061,18 +2074,18 @@
       }
     },
     "html-snapshots": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/html-snapshots/-/html-snapshots-1.0.1.tgz",
-      "integrity": "sha512-BnVQ7pL/ybYWVdoktSHvp1NybZ1UOt3xd5vTQ8agO388hwU63oTqgZV4Xe2nxW0Bb83Xia9/VNiWPGrJ320Uhw==",
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/html-snapshots/-/html-snapshots-1.2.0.tgz",
+      "integrity": "sha512-/erOUW66PXzxzmq9daIt9F/sOGtLCKIjT7VuFUutNeZCtjiK6eM6bBiF9CFq9SOsyJ1sWqFasBUsq7F9GSnWpA==",
       "requires": {
         "async": "3.2.4",
         "async-lock": "1.3.2",
         "combine-errors": "3.0.3",
-        "got": "12.5.1",
+        "got": "12.5.2",
         "lodash": "4.17.21",
         "mkdirp": "1.0.4",
         "phantomjs-prebuilt": "2.1.16",
-        "puppeteer": "^18.0.5",
+        "puppeteer": "^19.0.0",
         "rimraf": "3.0.2",
         "xml2js": "0.4.23"
       }
@@ -2449,21 +2462,38 @@
       "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A=="
     },
     "puppeteer": {
-      "version": "18.0.5",
-      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-18.0.5.tgz",
-      "integrity": "sha512-s4erjxU0VtKojPvF+KvLKG6OHUPw7gO2YV1dtOsoryyCbhrs444fXb4QZqGWuTv3V/rgSCUzeixxu34g0ZkSMA==",
+      "version": "19.0.0",
+      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-19.0.0.tgz",
+      "integrity": "sha512-3Ga5IVerQQ2hKU9q7T28RmcUsd8F2kL6cYuPcPCzeclSjmHhGydPBZL/KJKC02sG6J6Wfry85uiWpbkjQ5qBiw==",
+      "requires": {
+        "https-proxy-agent": "5.0.1",
+        "progress": "2.0.3",
+        "proxy-from-env": "1.1.0",
+        "puppeteer-core": "19.0.0"
+      },
+      "dependencies": {
+        "progress": {
+          "version": "2.0.3",
+          "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
+          "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA=="
+        }
+      }
+    },
+    "puppeteer-core": {
+      "version": "19.0.0",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-19.0.0.tgz",
+      "integrity": "sha512-OljQ9W5M4cBX68vnOAGbcRkVENDHn6lfj6QYoGsnLQsxPAh6ExTQAhHauwdFdQkhYdDExZFWlKArnBONzeHY+g==",
       "requires": {
         "cross-fetch": "3.1.5",
         "debug": "4.3.4",
-        "devtools-protocol": "0.0.1036444",
+        "devtools-protocol": "0.0.1045489",
         "extract-zip": "2.0.1",
         "https-proxy-agent": "5.0.1",
-        "progress": "2.0.3",
         "proxy-from-env": "1.1.0",
         "rimraf": "3.0.2",
         "tar-fs": "2.1.1",
         "unbzip2-stream": "1.4.3",
-        "ws": "8.8.1"
+        "ws": "8.9.0"
       },
       "dependencies": {
         "debug": {
@@ -2497,11 +2527,6 @@
           "version": "2.1.2",
           "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz",
           "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w=="
-        },
-        "progress": {
-          "version": "2.0.3",
-          "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
-          "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA=="
         }
       }
     },
@@ -2773,9 +2798,9 @@
       "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="
     },
     "ws": {
-      "version": "8.8.1",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.8.1.tgz",
-      "integrity": "sha512-bGy2JzvzkPowEJV++hF07hAD6niYSr0JzBNo/J29WsB57A2r7Wlc1UFcTR9IzrPvuNVO4B8LGqF8qcpsVOhJCA==",
+      "version": "8.9.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.9.0.tgz",
+      "integrity": "sha512-Ja7nszREasGaYUYCI2k4lCKIRTt+y7XuqVoHR44YpI49TtryyqbqvDMn5eqfW7e6HzTukDRIsXqzVHScqRcafg==",
       "requires": {}
     },
     "xml2js": {

package/examples/sitemap-index/package.json

@@ -7,6 +7,6 @@
     "start": "node ./snapshot.js"
   },
   "dependencies": {
-    "html-snapshots": "^1.0.1"
+    "html-snapshots": "^1.2.0"
   }
 }

package/lib/html-snapshots.js

@@ -154,7 +154,8 @@ function phantomjsWorker (input, options, notifier, qcb) {
  * @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 entire process timeout.
- * @param {String} input.debug - The debug object.
+ * @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.
@@ -192,7 +193,8 @@ function puppeteerWorker (input, options, notifier, qcb) {
         input.timeout,
         filter,
         input.debug.flag,
-        input.debug.slowMo
+        input.debug.slowMo,
+        JSON.stringify(input.puppeteerLaunchOptions)
       ], { cwd: process.cwd(), stdio: "inherit", detached: true }
     );
 

package/lib/input-generators/_base.js

@@ -27,6 +27,7 @@ const defaults = Object.freeze({
   useJQuery: false,
   verbose: false,
   phantomjsOptions: "",
+  puppeteerLaunchOptions: {},
   debug: {
     flag: "false",
     slowMo: 500
@@ -86,6 +87,23 @@ function supplyMissingDefault (options, name) {
   }
 }
 
+/**
+ * Prepare single Object options so that it is always used for all pages (globally).
+ *
+ * @param {String} name - The property name.
+ * @param {Object} options - Input generator options.
+ */
+function prepSingleObjectOptions (name, options) {
+  const objectOpt = options[name];
+  const toString = Object.prototype.toString;
+  const isObj = toString.call(objectOpt) === "[object Object]";
+  if (isObj) {
+    options[name] = {
+      __default: objectOpt
+    };
+  }
+}
+
 /**
  * Prepare options for use by an input generator.
  *
@@ -96,11 +114,20 @@ function prepOptions (options, listener) {
   // Ensure defaults are represented
   common.ensure(options, defaults);
 
+  // Prep single, global object options for normalization.
+  [
+    "puppeteerLaunchOptions"
+  ]
+  .forEach((optionName) => {
+    prepSingleObjectOptions(optionName, options);  
+  });
+
   // Normalize certain arguments if they are not functions.
   // The certain arguments are per-page options.
   // However, outputPath is a special case
   [
-    "selector", "timeout", "useJQuery", "verbose", "phantomjsOptions"
+    "selector", "timeout", "useJQuery", "verbose", "phantomjsOptions",
+    "puppeteerLaunchOptions"
   ]
   .forEach((perPageOption) => {
     options[perPageOption] = normalize(options[perPageOption]);
@@ -228,7 +255,8 @@ module.exports = {
    * @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.debug - Produces debug 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.
    * @param {String} page - The url to the page resource.
    * @returns {String} The full output file path.
@@ -262,7 +290,9 @@ module.exports = {
         verbose: options.verbose(page),
         // map the input page to phantomJS options
         phantomjsOptions: options.phantomjsOptions(page),
-        // useful for testing, debugging
+        // map the input page to puppeteer launch options
+        puppeteerLaunchOptions: options.puppeteerLaunchOptions(page),
+        // useful for puppeteer testing, debugging
         debug: options.debug,
         __page: page
       });

package/lib/puppeteer/index.js

@@ -12,6 +12,7 @@
  * [6] - filter
  * [7] - debug
  * [8] - slowMo
+ * [9] - arbitrary launchOptions
  */
 const puppeteer = require('puppeteer');
 const path = require('path');
@@ -31,13 +32,17 @@ const options = {
   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,
-  slowMo: process.argv[8] ? parseInt(process.argv[8], 10) : 500
+  slowMo: process.argv[8] ? parseInt(process.argv[8], 10) : 500,
+  launchOpts: process.argv[9] ? JSON.parse(process.argv[9]) : null
+};
+const launchOptions = {
+  ...(options.debug ? {
+    headless: false,
+    slowMo: options.slowMo,
+    devtools: true
+  } : {}),
+  ...(options.launchOpts ?? {})
 };
-const launchOptions = options.debug ? {
-  headless: false,
-  slowMo: options.slowMo,
-  devtools: true
-} : {};
 
 /**
  * Run the snapshot script.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html-snapshots",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "author": {
     "name": "Alex Grant",
     "email": "alex@localnerve.com",
@@ -53,18 +53,18 @@
     "async": "3.2.4",
     "async-lock": "1.3.2",
     "combine-errors": "3.0.3",
-    "got": "12.5.1",
+    "got": "12.5.2",
     "lodash": "4.17.21",
     "mkdirp": "1.0.4",
     "phantomjs-prebuilt": "2.1.16",
-    "puppeteer": "^18.2.1",
+    "puppeteer": "^19.1.1",
     "rimraf": "3.0.2",
     "xml2js": "0.4.23"
   },
   "devDependencies": {
-    "eslint": "8.23.1",
-    "express": "4.18.1",
-    "mocha": "10.0.0",
+    "eslint": "8.26.0",
+    "express": "4.18.2",
+    "mocha": "10.1.0",
     "c8": "7.12.0",
     "precommit-hook": "3.0.0",
     "server-destroy": "1.0.1",

package/test/mocha/browsers/puppeteer.js

@@ -43,7 +43,7 @@ function puppeteerTests () {
     });
     
     it("should succeed with minimal args", function (done) {
-      this.timeout(5000);
+      this.timeout(4000);
 
       rimraf(outputDir);
 
@@ -54,6 +54,28 @@ function puppeteerTests () {
       ], done);
     });
 
+    it("should succeed with stringified puppeteerLaunchOptions", function (done) {
+      this.timeout(4000);
+      rimraf(outputDir);
+
+      // override the debug options to prove stringified launch opts worked.
+      const puppeteerLaunchOptions = {
+        headless: true,
+        devTools: false
+      };
+
+      spawnPuppeteer([
+        outputFile,
+        `http://localhost:${port}/`,
+        "body",
+        4000,
+        "false",
+        "true",
+        10,
+        JSON.stringify(puppeteerLaunchOptions)
+      ], done);
+    });
+
     it("should fail if insufficient input args", function (done) {
       rimraf(outputDir);
       
@@ -98,6 +120,7 @@ function puppeteerTests () {
         10
       ], done);
     });
+
   };
 }
 

package/test/mocha/input-generators/test.js

@@ -921,6 +921,96 @@ describe("input-generator", function () {
 
       });
 
+      describe("puppeteerLaunchOptions option", function () {
+        it("should accept a single object and apply globally", function (done) {
+          let count = 0;
+          const puppeteerLaunchOptions = {
+            one: 'one',
+            two: 2,
+            three: ['three', 'four', 'five'],
+            six: {
+              seven: 'seven'
+            }
+          };
+
+          const result = gen.run(options.decorate({
+            source,
+            puppeteerLaunchOptions,
+            outputDir: thisOutputDir
+          }), function (input) {
+            const classString = Object.prototype.toString;
+
+            assert.equal(classString.call(input.puppeteerLaunchOptions), classString.call(puppeteerLaunchOptions),
+              `${input.__page}:\ninput.puppeteerLaunchOptions should be an object:\n${
+                require("util").inspect(input.puppeteerLaunchOptions)
+              }`
+            );
+
+            assert.deepEqual(input.puppeteerLaunchOptions, puppeteerLaunchOptions,
+              `${input.__page}:\ninput.puppeteerLaunchOptions should be equal to the original input`);
+
+            count++;
+            if (count === urls) {
+              done();
+            }
+          });
+
+          result
+            .then(function () {
+              assert.ok(true);
+            })
+            .catch(function (err) {
+              assert.fail(`Run should not fail: ${err.toString()}`);
+            });
+        });
+
+        it("should accept a function and apply per url", function (done) {
+          const plo1 = { one: "one" },
+            plo2 = { two: "two" },
+            plo3 = { three: "three" };
+
+          const globalOptions = {
+            "/": plo1,
+            "/contact": plo2,
+            "/services/carpets": plo3
+          };
+          const localOptions = {
+            "http://northstar.local/": plo1,
+            "http://northstar.local/contact": plo2,
+            "http://northstar.local/services/carpets": plo3
+          };
+          const opts = globalUrl ? globalOptions : localOptions;
+          let count = 0;
+          const ploFn = function (url) {
+            return opts[url];
+          };
+
+          const result = gen.run(options.decorate({
+            source: source,
+            outputDir: thisOutputDir,
+            puppeteerLaunchOptions: ploFn
+          }), function (input) {
+            const testOption = opts[input.__page] ? opts[input.__page] : base.defaults({}).puppeteerLaunchOptions;
+
+            assert.deepEqual(input.puppeteerLaunchOptions, testOption,
+              `${input.__page}:\ninput.puppeteerLaunchOptions: ${input.puppeteerLaunchOptions} != testPuppeteerLaunchOption: ${testOption}`);
+
+            count++;
+            if (count === urls) {
+              done();
+            }
+          });
+
+          result
+            .then(function () {
+              assert.ok(true);
+            })
+            .catch(function (err) {
+              assert.fail(`Run should not fail: ${err.toString()}`);
+            });
+        });
+      });
+
       describe("url behavior", function () {
 
         it("should replace the default hostname in results", function (done) {