chromedriver 114.0.2 → 115.0.0

package/README.md

@@ -36,9 +36,9 @@ force it always download by configuring it:
 npm install chromedriver --chromedriver-force-download
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+Or add property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
 
-```
+```ini
 chromedriver_force_download=true
 ```
 
@@ -50,23 +50,65 @@ CHROMEDRIVER_FORCE_DOWNLOAD=true npm install chromedriver
 
 ## Custom binaries url
 
-To use a mirror of the ChromeDriver binaries use npm config property `chromedriver_cdnurl`.
-Default is `https://chromedriver.storage.googleapis.com`.
+This allows you to use your own endpoints for metadata and binaries. It is useful in air gapped
+scenarios or if you have download restrictions, such as firewalls.
+
+This was changed for version 115 and greater
+([see details](https://groups.google.com/g/chromedriver-users/c/clpipqvOGjE)),
+but implemented in this package starting with version
+`114.0.2`. To see the configuration to prior versions check out this
+[README.md](https://github.com/giggio/node-chromedriver/tree/114.0.1#custom-binaries-url)
+at the latest tag where it was using the legacy urls (`114.0.1`).
+
+### For versions >= 115
+
+There are two urls that need to be configured, one for metadata and one for binaries.
+The one for metadata is the "CDN url", and the one for binaries is the "CDN binaries url".
+See [Chrome for Testing](https://googlechromelabs.github.io/chrome-for-testing/) to understand
+how these urls work.
+
+Npm config:
+For metadata use `chromedriver_cdnurl`. The default is `https://googlechromelabs.github.io`.
+For binaries use `chromedriver_cdnurl`. The default is `https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing`.
+
+```shell
+npm install chromedriver --chromedriver_cdnurl=https://npmmirror.com/metadata --chromedriver_cdnbinariesurl=https://npmmirror.com/binaries
+```
+
+Or add these properties to your [`.npmrc`](https://docs.npmjs.com/cli/configuring-npm/npmrc) file:
+
+```ini
+chromedriver_cdnurl=https://npmmirror.com/metadata
+chromedriver_cdnbinariesurl=https://npmmirror.com/binaries
+```
+
+Another option is to use the environment variables `CHROMEDRIVER_CDNURL` and `CHROMEDRIVER_CDNBINARIESURL`.
 
 ```shell
-npm install chromedriver --chromedriver_cdnurl=https://npmmirror.com/mirrors/chromedriver
+CHROMEDRIVER_CDNURL=https://npmmirror.com/metadata CHROMEDRIVER_CDNBINARIESURL=https://npmmirror.com/binaries npm install chromedriver
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+### For versions < 115
+
+There is one url to both metadata and binaries.
+
+To use a mirror of the ChromeDriver binaries use npm config property `chromedriver_legacy_cdnurl`.
+Default is `https://chromedriver.storage.googleapis.com`.
 
+```shell
+npm install chromedriver --chromedriver_legacy_cdnurl=https://npmmirror.com/mirrors/chromedriver --chromedriver_version=LATEST_114
 ```
-chromedriver_cdnurl=https://npmmirror.com/mirrors/chromedriver
+
+Or add a property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file:
+
+```ini
+chromedriver_legacy_cdnurl=https://npmmirror.com/mirrors/chromedriver
 ```
 
-Another option is to use PATH variable `CHROMEDRIVER_CDNURL`.
+Another option is to use the environment variable `CHROMEDRIVER_LEGACY_CDNURL`.
 
 ```shell
-CHROMEDRIVER_CDNURL=https://npmmirror.com/mirrors/chromedriver npm install chromedriver
+CHROMEDRIVER_LEGACY_CDNURL=https://npmmirror.com/mirrors/chromedriver npm install chromedriver --chromedriver_version=LATEST_114
 ```
 
 ## Custom binaries file
@@ -77,9 +119,9 @@ To get the chromedriver from the filesystem instead of a web request use the npm
 npm install chromedriver --chromedriver_filepath=/path/to/chromedriver_mac64.zip
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+Or add property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
 
-```
+```ini
 chromedriver_filepath=/path/to/chromedriver_mac64.zip
 ```
 
@@ -120,9 +162,9 @@ To achieve this you can use the npm config property `chromedriver_skip_download`
 npm install chromedriver --chromedriver_skip_download=true
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+Or add property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
 
-```
+```ini
 chromedriver_skip_download=true
 ```
 
@@ -218,9 +260,9 @@ use `LATEST` as the version number:
 npm install chromedriver --chromedriver_version=LATEST
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+Or add property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
 
-```
+```ini
 chromedriver_version=LATEST
 ```
 
@@ -252,9 +294,9 @@ you can use the npm config property `detect_chromedriver_version`.
 npm install chromedriver --detect_chromedriver_version
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+Or add property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
 
-```
+```ini
 detect_chromedriver_version=true
 ```
 
@@ -275,9 +317,9 @@ If you don't have Chrome installed, you can check for Chromium version instead b
 npm install chromedriver --include_chromium
 ```
 
-Or add property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
+Or add property to your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file.
 
-```
+```ini
 include_chromium=true
 ```
 

package/install.js

@@ -26,10 +26,8 @@ if (skipDownload) {
 }
 
 (async function install() {
-  let cdnUrl = process.env.npm_config_chromedriver_cdnurl || process.env.CHROMEDRIVER_CDNURL || 'https://googlechromelabs.github.io';
-  const legacyCdnUrl = process.env.npm_config_chromedriver_legacy_cdnurl || process.env.CHROMEDRIVER_LEGACY_CDNURL || 'https://chromedriver.storage.googleapis.com';
-  // adapt http://chromedriver.storage.googleapis.com/
-  cdnUrl = cdnUrl.replace(/\/+$/, '');
+  const cdnUrl = (process.env.npm_config_chromedriver_cdnurl || process.env.CHROMEDRIVER_CDNURL || 'https://googlechromelabs.github.io').replace(/\/+$/, '');
+  const legacyCdnUrl = (process.env.npm_config_chromedriver_legacy_cdnurl || process.env.CHROMEDRIVER_LEGACY_CDNURL || 'https://chromedriver.storage.googleapis.com').replace(/\/+$/, '');
   let chromedriverVersion = process.env.npm_config_chromedriver_version || process.env.CHROMEDRIVER_VERSION || helper.version;
   const detectChromedriverVersion = (process.env.npm_config_detect_chromedriver_version || process.env.DETECT_CHROMEDRIVER_VERSION) === 'true';
   try {
@@ -65,7 +63,8 @@ if (skipDownload) {
     const chromedriverIsAvailable = await verifyIfChromedriverIsAvailableAndHasCorrectVersion(chromedriverVersion, chromedriverBinaryFilePath);
     if (!chromedriverIsAvailable) {
       console.log('Current existing ChromeDriver binary is unavailable, proceeding with download and extraction.');
-      await downloadFile(useLegacyMethod ? legacyCdnUrl : cdnUrl, useLegacyMethod, downloadedFile, chromedriverVersion, platform, detectChromedriverVersion);
+      const cdnBinariesUrl = (process.env.npm_config_chromedriver_cdnbinariesurl || process.env.CHROMEDRIVER_CDNBINARIESURL || 'https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing').replace(/\/+$/, '');
+      await downloadFile(useLegacyMethod ? legacyCdnUrl : cdnBinariesUrl, useLegacyMethod, downloadedFile, chromedriverVersion, platform, detectChromedriverVersion);
       await extractDownload(extractDirectory, chromedriverBinaryFilePath, downloadedFile);
     }
     const libPath = path.join(__dirname, 'lib', 'chromedriver');
@@ -130,8 +129,7 @@ async function downloadFile(cdnUrl, useLegacyDownloadMethod, downloadedFile, chr
       console.log('Downloading from file: ', formattedDownloadUrl);
       await requestBinary(getRequestOptions(formattedDownloadUrl), downloadedFile);
     } else {
-      const dlBaseUrl = 'https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing'; // todo: make this configurable?
-      const formattedDownloadUrl = `${dlBaseUrl}/${chromedriverVersion}/${platform}/${fileName}`;
+      const formattedDownloadUrl = `${cdnUrl}/${chromedriverVersion}/${platform}/${fileName}`;
       console.log('Downloading from file: ', formattedDownloadUrl);
       await requestBinary(getRequestOptions(formattedDownloadUrl), downloadedFile);
     }

package/lib/chromedriver.js

@@ -17,7 +17,7 @@ function getPortFromArgs(args) {
 }
 process.env.PATH = path.join(__dirname, 'chromedriver') + path.delimiter + process.env.PATH;
 exports.path = process.platform === 'win32' ? path.join(__dirname, 'chromedriver', 'chromedriver.exe') : path.join(__dirname, 'chromedriver', 'chromedriver');
-exports.version = '114.0.5735.90';
+exports.version = '115.0.5790.102';
 exports.start = function (args, returnPromise) {
   let command = exports.path;
   if (!fs.existsSync(command)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromedriver",
-  "version": "114.0.2",
+  "version": "115.0.0",
   "keywords": [
     "chromedriver",
     "selenium"
@@ -30,17 +30,17 @@
   "dependencies": {
     "@testim/chrome-version": "^1.1.3",
     "axios": "^1.4.0",
-    "compare-versions": "^5.0.3",
+    "compare-versions": "^6.0.0",
     "extract-zip": "^2.0.1",
     "https-proxy-agent": "^5.0.1",
     "proxy-from-env": "^1.1.0",
     "tcp-port-used": "^1.0.1"
   },
   "devDependencies": {
-    "eslint": "^8.42.0",
-    "typescript": "^5.1.3"
+    "eslint": "^8.45.0",
+    "typescript": "^5.1.6"
   },
   "engines": {
     "node": ">=16"
   }
-}
+}