.devcontainer/Dockerfile

@@ -5,6 +5,6 @@ ENV DEBIAN_FRONTEND=noninteractive
 RUN apt-get update && \
   apt-get install -y git curl build-essential procps
 RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
-RUN [ "/bin/bash", "-c", "source $HOME/.nvm/nvm.sh && nvm i --no-progress 6 && nvm i 8 --no-progress && nvm i 10 --no-progress && nvm i --no-progress 12.2.0" ]
-RUN [ "/bin/bash", "-c", "source $HOME/.nvm/nvm.sh && nvm alias default 12" ]
+RUN [ "/bin/bash", "-c", "source $HOME/.nvm/nvm.sh && nvm i 10.19.0 --no-progress && nvm i --no-progress 12.12.0 && nvm i --no-progress 13.8.0" ]
+RUN [ "/bin/bash", "-c", "source $HOME/.nvm/nvm.sh && nvm alias default 13" ]
 ENV DEBIAN_FRONTEND=dialog

.eslintrc.json

@@ -11,7 +11,7 @@
             "jsx": false
         },
         "sourceType": "module",
-        "ecmaVersion": 5
+        "ecmaVersion": 2017
     },
     "rules": {
         "no-const-assign": "warn",
@@ -26,4 +26,4 @@
         "no-var": "error",
         "prefer-const": "error"
     }
-}
+}

.npmignore

@@ -5,9 +5,11 @@ tmp
 Dockerfile
 test-driver.sh
 testInstall.js
+update.js
 *.tgz
 .vscode
 .editorconfig
 shippable.yml
 .devcontainer/**/*
-azure-pipelines.yml
+azure-pipelines.yml
+.github

.vscode/launch.json

@@ -6,7 +6,7 @@
             "type": "node",
             "request": "launch",
             "program": "${workspaceRoot}/install.js",
-            "runtimeVersion": "12.2.0",
+            "runtimeVersion": "13.8.0",
             "cwd": "${workspaceRoot}",
             "runtimeArgs": [
                 "--nolazy"
@@ -20,7 +20,7 @@
             "type": "node",
             "request": "launch",
             "program": "${workspaceRoot}/install.js",
-            "runtimeVersion": "12.2.0",
+            "runtimeVersion": "13.8.0",
             "cwd": "${workspaceRoot}",
             "runtimeArgs": [
                 "--nolazy"
@@ -30,6 +30,22 @@
                 "CHROMEDRIVER_VERSION": "LATEST"
             }
         },
+        {
+            "name": "Launch (with proxy)",
+            "type": "node",
+            "request": "launch",
+            "program": "${workspaceRoot}/install.js",
+            "runtimeVersion": "13.8.0",
+            "cwd": "${workspaceRoot}",
+            "runtimeArgs": [
+                "--nolazy"
+            ],
+            "env": {
+                "NODE_ENV": "development",
+                "https_proxy": "https://localhost:3128"
+                // "npm_config_https_proxy": "https://localhost:3128"
+            }
+        },
         {
             "name": "Attach",
             "type": "node",
@@ -50,4 +66,4 @@
             "port": 5858,
         }
     ]
-}
+}

.vscode/settings.json

@@ -1,5 +1,8 @@
 {
     "vsicons.presets.angular": false,
     "editor.formatOnSave": true,
-    "eslint.autoFixOnSave": true
+    "eslint.autoFixOnSave": true,
+    "editor.codeActionsOnSave": {
+        "source.fixAll.eslint": true
+    }
 }

README.md

@@ -105,6 +105,7 @@ npm config set https-proxy http://[user:pwd]@domain.tld:port
 ```
 
 Use different User-Agent.
+
 ```shell
 npm config set user-agent "Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0"
 ```
@@ -183,7 +184,7 @@ You can also use the start and stop methods:
 var chromedriver = require('chromedriver');
 
 args = [
-	// optional arguments
+ // optional arguments
 ];
 chromedriver.start(args);
 // run your tests
@@ -210,7 +211,7 @@ executed as a callback at the end of your tests
 The NPM package version tracks the version of chromedriver that will be installed,
 with an additional build number that is used for revisions to the installer.
 You can use the package version number to install a specific version, or use the
-setting to a specific version. To always install the latest version of Chromedriver,
+setting to a specific version. If there is a new Chromedriver version available which is not yet available as a version of `node-chromedriver`, the npm command `npm run update-chromedriver` in this repository can be used to make the required updates to this module, please submit the change as a PR. To always install the latest version of Chromedriver,
 use `LATEST` as the version number:
 
 ```shell
@@ -229,6 +230,43 @@ Another option is to use env variable `CHROMEDRIVER_VERSION`.
 CHROMEDRIVER_VERSION=LATEST npm install chromedriver
 ```
 
+You can force the latest release for a specific major version by specifying `LATEST_{VERSION_NUMBER}`:
+
+```shell
+CHROMEDRIVER_VERSION=LATEST_80 npm install chromedriver
+```
+
+You can also force a different version of chromedriver by replacing `LATEST` with a version number:
+
+```shell
+CHROMEDRIVER_VERSION=75.0.3770.140 npm install chromedriver
+```
+
+## Detect ChromeDriver Version
+
+The NPM package version may not be always compatible to your Chrome version.
+To get the chromedriver that corresponds to the version of Chrome installed,
+you can use the npm config property `detect_chromedriver_version`.
+
+```shell
+npm install chromedriver --detect_chromedriver_version
+```
+
+Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+
+```
+detect_chromedriver_version=true
+```
+
+Another option is to use environment variable `DETECT_CHROMEDRIVER_VERSION`.
+
+```shell
+DETECT_CHROMEDRIVER_VERSION=true npm install chromedriver
+```
+
+**Note:** When the property `detect_chromedriver_version` is provided,
+`chromedriver_version` and `chromedriver_filepath` properties are ignored.
+
 ## A Note on chromedriver
 
 Chromedriver is not a library for NodeJS.

azure-pipelines.yml

@@ -7,12 +7,12 @@ jobs:
     vmImage: 'ubuntu-16.04'
   strategy:
     matrix:
-      node_8:
-        nodeversion: '8.x'
       node_10:
         nodeversion: '10.x'
       node_12:
         nodeversion: '12.x'
+      node_13:
+        nodeversion: '13.x'
   steps:
   - task: NodeTool@0
     inputs:
@@ -28,12 +28,12 @@ jobs:
     vmImage: 'macOS-10.14'
   strategy:
     matrix:
-      node_8:
-        nodeversion: '8.x'
       node_10:
         nodeversion: '10.x'
       node_12:
         nodeversion: '12.x'
+      node_13:
+        nodeversion: '13.x'
   steps:
   - task: NodeTool@0
     inputs:
@@ -48,12 +48,12 @@ jobs:
     vmImage: 'windows-2019'
   strategy:
     matrix:
-      node_8:
-        nodeversion: '8.x'
       node_10:
         nodeversion: '10.x'
       node_12:
         nodeversion: '12.x'
+      node_13:
+        nodeversion: '13.x'
   steps:
   - task: NodeTool@0
     inputs: