Feat: support for puppeteer-extra plugins

README.md

@@ -156,6 +156,27 @@ try {
 
 Instead, a `Node\Exception` will be thrown, the Node process will stay alive and usable.
 
+### Puppeteer plugins
+
+To use puppeteer-extra plugins add them to your project:
+```shell
+npm install puppeteer puppeteer-extra puppeteer-extra-plugin-stealth
+```
+
+Then override js inclusion with js_extra option
+```php
+    $puppeteer = new Puppeteer([
+        'js_extra' => /** @lang JavaScript */ "
+            const puppeteer = require('puppeteer-extra');
+            const StealthPlugin = require('puppeteer-extra-plugin-stealth');
+            puppeteer.use(StealthPlugin());
+            instruction.setDefaultResource(puppeteer);
+        "
+    ]);
+```
+
+
+
 ## License
 
 The MIT License (MIT). Please see [License File](LICENSE) for more information.

src/Puppeteer.php

@@ -28,6 +28,9 @@ class Puppeteer extends AbstractEntryPoint
 
         // Logs the output of Browser's console methods (console.log, console.debug, etc...) to the PHP logger
         'log_browser_console' => false,
+
+        //Custom js to load puppeteer-extra plugins
+        'js_extra' => ''
     ];
 
     /**

src/PuppeteerConnectionDelegate.js

@@ -1,7 +1,6 @@
 'use strict';
 
-const puppeteer = require('puppeteer'),
-    {ConnectionDelegate} = require('@nesk/rialto'),
+const {ConnectionDelegate} = require('@nesk/rialto'),
     Logger = require('@nesk/rialto/src/node-process/Logger'),
     ConsoleInterceptor = require('@nesk/rialto/src/node-process/NodeInterceptors/ConsoleInterceptor'),
     StandardStreamsInterceptor = require('@nesk/rialto/src/node-process/NodeInterceptors/StandardStreamsInterceptor');
@@ -28,7 +27,12 @@ class PuppeteerConnectionDelegate extends ConnectionDelegate
      * @inheritdoc
      */
     async handleInstruction(instruction, responseHandler, errorHandler) {
-        instruction.setDefaultResource(puppeteer);
+        if (this.options.js_extra) {
+            eval(this.options.js_extra);
+        } else {
+            const puppeteer = require('puppeteer');
+            instruction.setDefaultResource(puppeteer);
+        }
 
         let value = null;