Merge pull request #853 from udarrr/main

resolved onCancel bug and polish docs

Author: udarrr

HISTORY.md

@@ -1,3 +1,12 @@
+# 9.2.3 (2023-10-21)
+* fixed onCancel bug with got
+
+# 9.2.2 (2023-08-26)
+* fixed splitting opts.javaArgs
+
+# 9.2.1 (2023-08-26)
+* added checking downloaded files 
+
 # 9.1.0 (2023-08-26)
 * added new feature processKiller
 

docs/API.md

@@ -23,25 +23,20 @@ Here you can find an up-to-date example of the configuration object:
 const selenium = require('selenium-standalone');
 
 async function myFn() {
-  await selenium.install({
+  //result is obj with paths to binary and some info like urls to installed files { fsPaths, urls, opts }
+  const details = await selenium.install({
     // check for more recent versions of selenium here:
     // https://selenium-release.storage.googleapis.com/index.html
     version: process.env.SELENIUM_VERSION || '4.9.0',
     baseURL: 'https://selenium-release.storage.googleapis.com',
     drivers: {
       chrome: {
         // check for more recent versions of chrome driver here:
-        // https://chromedriver.storage.googleapis.com/index.html
+        // https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing
         version: 'latest',
         arch: process.arch,
-        baseURL: 'https://chromedriver.storage.googleapis.com'
-      },
-      ie: {
-        // check for more recent versions of internet explorer driver here:
-        // https://selenium-release.storage.googleapis.com/index.html
-        version: '3.150.1',
-        arch: process.arch,
-        baseURL: 'https://selenium-release.storage.googleapis.com'
+        baseURL: 'https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing'
+        channel: 'stable', //option
       }
     }
   });
@@ -54,6 +49,18 @@ async function myFn() {
     }
   });
 
+  //or
+  //staring drivers 'chrome' | 'firefox' | 'chromiumedge' without selenium-server
+  const chromeDriverChildProcess = await selenium.start({
+    onlyDriver: 'chrome'
+    drivers: {
+      chrome: {
+        version: 'latest',
+        onlyDriverArgs: [],//option
+      },
+    }
+  });
+
   // run tests
 
   // finally kill selenium process!
@@ -86,7 +93,7 @@ arch [sometimes](https://code.google.com/p/selenium/issues/detail?id=5116#c9).
 
 `opts.requestOpts` can be any valid [`got` options object](https://www.npmjs.com/package/got#proxies). You can use this for example to set a timeout.
 
-`opts.onlyDriver` can be any valid 'chrome' | 'firefox' | 'chromiumedge' it allow to install any driver without selenium server 
+`opts.onlyDriver` can be any valid 'chrome' | 'firefox' | 'chromiumedge' it allow to install any driver without selenium server, driver also can be parametrized with onlyDriverArgs, it's []
 
 returns `Promise<void>`
 
@@ -127,6 +134,8 @@ If you're getting this error, it means that you didn't shut down the server succ
 pkill -f selenium-standalone
 ```
 
+since 9.1.0 it's been checked and killed automatically
+
 ## Set `selenium-standalone` Version as NodeJS environment parameter
 
 You can set any version by `process.env.SELENIUM_VERSION=3.141.59` before starting selenium-standalone. Default values are here: [lib/default-config.js](../lib/default-config.js)

package-lock.json

@@ -46,7 +46,7 @@
     "execa": "^5.1.1",
     "find-process": "^1.4.7",
     "fkill": "^7.2.1",
-    "got": "^11.8.2",
+    "got": "^11.8.6",
     "is-port-reachable": "^3.0.0",
     "lodash.mapvalues": "^4.6.0",
     "lodash.merge": "^4.6.2",