add support for injectScript

Author: mbrevda

README.md

@@ -105,6 +105,7 @@ _The default WPT server can also be specified via environment variable `WEBPAGET
 * **-K, --keepua**: do not add PTST to the original browser User Agent string
 * **-m, --dom** _\<element\>_: DOM element to record for sub-measurement
 * **-N, --duration** _\<seconds\>_: minimum test duration in seconds
+* **--injectScript** _\<string\>_: JavaScript to run on the page as soon as the document exists
 * **-E, --tester** _\<name\>_: run the test on a specific PC (name must match exactly or the test will not run)
 * **-W, --mobile**: (experimental) emulate mobile browser: Chrome mobile user agent, 640x960 screen, 2x scaling and fixed viewport (Chrome only)
 * **--device** _\<string\>_: device name from mobile_devices.ini to use for mobile emulation (only when mobile=1 is specified to enable emulation and only for Chrome)

lib/mapping.js

@@ -153,6 +153,12 @@ var options = {
       param: 'name',
       info: 'run the test on a specific PC (name must match exactly or the test will not run)'
     },
+   'injectScript': {
+      name: "injectScript",
+      api: "injectScript",
+      param: "script",
+      info: "JavaScript to run after the document has started loading",
+    },
 
     // Chrome tab
     'mobile': {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "webpagetest",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "WebPageTest API wrapper for NodeJS",
   "author": "WebPageTest <[email protected]> (http://github.com/WebPageTest)",
   "homepage": "http://github.com/WebPageTest/webpagetest-api",

test/fixtures/command-line/help-test.txt

@@ -32,6 +32,8 @@ Options:
   -N, --duration <seconds>            minimum test duration in seconds
   -E, --tester <name>                 run the test on a specific PC (name must
                                       match exactly or the test will not run)
+      --injectScript <script>         JavaScript to run after the document has
+                                      started loading
   -W, --mobile                        (experimental) emulate mobile browser:
                                       Chrome mobile user agent, 640x960 screen,
                                       2x scaling and fixed viewport (Chrome
@@ -90,14 +92,24 @@ Options:
   -bh, --browserheight <pixels>       Browser window height (in display pixels)
   -vh, --viewportheight <pixels>      Viewport Height in css pixels
   -vw, --viewportwidth <pixels>       Viewport Width in css pixels
-  -dpr, --devicetopixelratio <ratio>    Device To Pixel Ratio
-  -au, --appendua <string>            String to append to the user agent string. This is in addition to the default PTST/ver string
-  -tt, --testtype <string>            For running alternative test types, can specify traceroute or lighthouse
-  -pr, --profiler <number>            Set to 1 to enable the V8 sampling profiler (Chromium only)
-  -avif, --disableAVIF <number>       Set to 1 to disable AVIF support (Chromium 88+)
-  -webp, --disableWEBP <number>       Set to 1 to disable WEBP support (Chromium 88+)
-  -jxl, --disableJXL <number>         Set to 1 to disable JpegXL support (Chromium 88+)
-  -dts, --dtShaper <number>           Set to 1 to use Chrome's built-in traffic-shaping instead of the packet-level netem shaping usually used by the test agents
+  -dpr, --devicetopixelratio <ratio>  Device To Pixel Ratio
+  -au, --appendua <string>            String to append to the user agent
+                                      string. This is in addition to the
+                                      default PTST/ver string
+  -tt, --testtype <string>            For running alternative test types, can
+                                      specify traceroute or lighthouse
+  -pr, --profiler <number>            Set to 1 to enable the V8 sampling
+                                      profiler (Chromium only)
+  -avif, --disableAVIF <number>       Set to 1 to disable AVIF support
+                                      (Chromium 88+)
+  -webp, --disableWEBP <number>       Set to 1 to disable WEBP support
+                                      (Chromium 88+)
+  -jxl, --disableJXL <number>         Set to 1 to disable JpegXL support
+                                      (Chromium 88+)
+  -dts, --dtShaper <number>           Set to 1 to use Chrome's built-in
+                                      traffic-shaping instead of the
+                                      packet-level netem shaping usually used
+                                      by the test agents
   -Y, --latency <time>                first-hop Round Trip Time in ms (used
                                       when specifying a custom connectivity
                                       profile)