@eyeo/get-browser-binary 0.4.0 → 0.5.0

package/.eslintrc.json

@@ -5,7 +5,8 @@
   "root": true,
   "env": {
     "es2022": true,
-    "node": true
+    "node": true,
+    "browser": true
   },
   "rules": {
     "brace-style": ["error", "stroustrup"],

package/.gitlab-ci.yml

@@ -1,5 +1,5 @@
 default:
-  image: node:16-bullseye-slim
+  image: registry.gitlab.com/eyeo/docker/get-browser-binary:node16
   interruptible: true
 
 stages:
@@ -37,7 +37,7 @@ test:browsers:linux:
   before_script:
     - docker build -f test/docker/Dockerfile -t browsers .
   script:
-    - docker run browsers
+    - docker run --shm-size=256m browsers
 
 test:browsers:windows:
   stage: test
@@ -51,7 +51,6 @@ test:browsers:windows:
     - Start-Process msiexec
         -ArgumentList "/i MicrosoftEdgeEnterpriseX64.msi /norestart /qn" -Wait
     - choco upgrade -y nodejs --version 16.10.0
-    - npm install -g npm
     - npm install
   script:
     # Running only a subset of Firefox and Opera tests to avoid low OS resources error

package/README.md

@@ -3,11 +3,6 @@
 Download specific browser versions for Chromium, Firefox, Edge and Opera, and
 their matching [selenium webdriver](https://www.selenium.dev/selenium/docs/api/javascript/index.html).
 
-Note: Edge download is only supported on Linux. On other platforms it is assumed
-to be already installed.
-
-Note: Using the `operadriver` on Windows is not supported.
-
 ## Getting started
 
 The sample below shows how to download the latest Chromium and run it using
@@ -17,12 +12,10 @@ selenium webdriver:
 import {BROWSERS} from "@eyeo/get-browser-binary";
 
 (async function example() {
-  let {chromium} = BROWSERS;
-
-  let {binary} = await chromium.downloadBinary();
+  let {binary} = await BROWSERS.chromium.downloadBinary("latest");
   console.log(`Chromium binary downloaded to ${binary}`);
 
-  let driver = await chromium.getDriver();
+  let driver = await BROWSERS.chromium.getDriver("latest");
   await driver.navigate().to("https://example.com/");
   await driver.quit();
 })();
@@ -35,6 +28,18 @@ For more information, please refer to the [API documention](https://gitlab.com/e
 If you are already on the documentation page, you may find the API contents on
 the right side.
 
+### Supported browser versions
+
+- Chromium >= 75
+- Firefox >= 60
+- Edge >= 95
+- Opera >= 62
+
+Note: Edge download is not supported on Windows. It is assumed to be installed
+because it is the default browser on that platform.
+
+Note: Using the `operadriver` on Windows is not supported.
+
 ## Development
 
 ### Prerequisites
@@ -79,13 +84,13 @@ Useful to reproduce the CI environment of the `test:browsers:linux` job:
 
 ```shell
 docker build -f test/docker/Dockerfile -t browsers .
-docker run -it browsers
+docker run --shm-size=256m -it browsers
 ```
 
 The `grep` option can also be used on Docker via the `TEST_ARGS` parameter:
 
 ```shell
-docker run -e TEST_ARGS="--grep chromium.*latest" -it browsers
+docker run --shm-size=256m -e TEST_ARGS="--grep chromium.*latest" -it browsers
 ```
 
 Note: For a full automated run, `opera` tests should not use the interactive

package/RELEASE_NOTES.md

@@ -1,3 +1,11 @@
+# 0.5.0
+
+- Enables Edge binary downloads on MacOS (!25)
+- Sets unsupported browser versions (#16)
+- Fixes the Edge repo url (!27)
+- Fixes an issue when downloading Opera (#21)
+- Fixes redundant Opera installations on Linux (!24)
+
 # 0.4.0
 
 - Adds Opera as a supported browser (#7)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eyeo/get-browser-binary",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Download browser binaries and matching webdrivers",
   "repository": {
     "type": "git",
@@ -21,7 +21,6 @@
     "fs-extra": "^10.0.0",
     "geckodriver": "^3.0.2",
     "got": "^11.8.2",
-    "msedgedriver": "^91.0.0",
     "selenium-webdriver": "^4.2.0"
   },
   "devDependencies": {

package/src/browsers.js

@@ -25,6 +25,7 @@ import got from "got";
 import webdriver from "selenium-webdriver";
 import chrome from "selenium-webdriver/chrome.js";
 import firefox from "selenium-webdriver/firefox.js";
+import edge from "selenium-webdriver/edge.js";
 import command from "selenium-webdriver/lib/command.js";
 import extractZip from "extract-zip";
 
@@ -38,10 +39,17 @@ import {download, extractTar, extractDmg, getBrowserVersion, killDriverProcess,
 export let snapshotsBaseDir = path.join(process.cwd(), "browser-snapshots");
 
 let {until, By} = webdriver;
-const ERROR_DOWNLOAD_NOT_SUPPORTED =
-  "Downloading this browser is not supported";
 let platform = `${process.platform}-${process.arch}`;
 
+function checkVersion(version, minVersion, channels) {
+  if (channels.includes(version))
+    return;
+
+  let mainVersion = parseInt(version && version.split(".")[0], 10);
+  if (mainVersion < minVersion)
+    throw new Error(`Unsupported browser version: ${version}`);
+}
+
 /**
  * Base class for browser download functionality. Please see subclasses for
  * browser specific details.
@@ -60,9 +68,10 @@ class Browser {
    * @param {string} version - Either full version number or channel/release.
    *   Please find examples on the subclasses.
    * @return {BrowserBinary}
+   * @throws {Error} Unsupported browser version.
    */
   static async downloadBinary(version) {
-    throw new Error(ERROR_DOWNLOAD_NOT_SUPPORTED);
+    // to be implemented by the subclass
   }
 
   /**
@@ -81,7 +90,7 @@ class Browser {
     else {
       ({stdout} = await promisify(execFile)(binary, ["--version"]));
     }
-    return stdout;
+    return stdout.trim();
   }
 
   /**
@@ -107,11 +116,10 @@ class Browser {
    * Installs the webdriver matching the browser version and runs the
    * browser. If needed, the browser binary is also installed.
    * @param {string} version - Either full version number or channel/release.
-   *   Please find examples on the subclasses. On Edge this parameter has
-   *   no effect.
+   *   Please find examples on the subclasses.
    * @param {driverOptions?} options - Options to start the browser with.
    * @return {webdriver}
-   * @throws {Error} Unsupported webdriver version.
+   * @throws {Error} Unsupported browser version.
    */
   static async getDriver(version, options = {}) {
     // to be implemented by the subclass
@@ -123,6 +131,7 @@ class Browser {
    * @param {webdriver} driver - The driver controlling the browser.
    * @param {string} extensionTitle - Title of the extebsion to be enabled.
    * @return {webdriver}
+   * @throws {Error} Unsupported browser version.
    */
   static async enableExtensionInIncognito(driver, extensionTitle) {
     // Allowing the extension in incognito mode can't happen programmatically:
@@ -145,28 +154,30 @@ class Chromium extends Browser {
     return data.chromium_base_position;
   }
 
-  static async #getLatestVersion(channel = "stable") {
-    let os = process.platform;
-    if (os == "win32")
-      os = process.arch == "x64" ? "win64" : "win";
-    else if (os == "darwin")
-      os = process.arch == "arm64" ? "mac_arm64" : "mac";
+  static async #getVersionForChannel(channel) {
+    if (channel == "latest")
+      channel = "stable";
 
+    let os = {
+      "win32-ia32": "win",
+      "win32-x64": "win64",
+      "linux-x64": "linux",
+      "darwin-x64": "mac",
+      "dawrin-arm64": "mac_arm64"
+    }[platform];
     let data = await got(`https://omahaproxy.appspot.com/all.json?os=${os}`).json();
     let release = data[0].versions.find(ver => ver.channel == channel);
-    let {current_version: version, branch_base_position: base} = release;
+    let {current_version: version} = release;
 
-    if (release.true_branch && release.true_branch.includes("_")) {
+    if (release.true_branch && release.true_branch.includes("_"))
       // A wrong base may be caused by a mini-branch (patched) release
       // In that case, the base is taken from the unpatched version
       version = [...version.split(".").slice(0, 3), "0"].join(".");
-      base = await Chromium.#getBranchBasePosition(version);
-    }
 
-    return {version, base};
+    return version;
   }
 
-  static #getChromiumBinary(dir) {
+  static #getBinaryPath(dir) {
     switch (process.platform) {
       case "win32":
         return path.join(dir, "chrome-win", "chrome.exe");
@@ -201,7 +212,7 @@ class Chromium extends Browser {
 
       try {
         await fs.promises.access(browserDir);
-        return {binary: Chromium.#getChromiumBinary(browserDir), revision};
+        return {binary: Chromium.#getBinaryPath(browserDir), revision};
       }
       catch (e) {}
 
@@ -230,7 +241,7 @@ class Chromium extends Browser {
     }
 
     await extractZip(archive, {dir: browserDir});
-    return {binary: Chromium.#getChromiumBinary(browserDir), revision};
+    return {binary: Chromium.#getBinaryPath(browserDir), revision};
   }
 
   /**
@@ -239,15 +250,19 @@ class Chromium extends Browser {
    *   number (i.e. "77.0.3865.0"). Defaults to "latest".
    * @return {BrowserBinary}
    */
-  static async downloadBinary(version) {
-    let base;
-    if (version && !(version == "beta" || version == "dev"))
-      base = await Chromium.#getBranchBasePosition(version);
-    else
-      ({version, base} = await Chromium.#getLatestVersion(version));
+  static async downloadBinary(version = "latest") {
+    const MIN_VERSION = 75;
+    const CHANNELS = ["latest", "beta", "dev"];
+
+    checkVersion(version, MIN_VERSION, CHANNELS);
+
+    let versionNumber = CHANNELS.includes(version) ?
+      await Chromium.#getVersionForChannel(version) : version;
+
+    let base = await Chromium.#getBranchBasePosition(versionNumber);
 
     let {binary, revision} = await Chromium.#downloadChromium(base);
-    return {binary, versionNumber: version, revision};
+    return {binary, versionNumber, revision};
   }
 
   static async #installDriver(revision, version) {
@@ -274,9 +289,10 @@ class Chromium extends Browser {
   }
 
   /** @see Browser.getDriver */
-  static async getDriver(version, {headless = true, extensionPaths = [],
-                                   incognito = false, insecure = false,
-                                   extraArgs = []} = {}) {
+  static async getDriver(version = "latest", {
+    headless = true, extensionPaths = [], incognito = false, insecure = false,
+    extraArgs = []
+  } = {}) {
     let {binary, revision, versionNumber} =
       await Chromium.downloadBinary(version);
     await Chromium.#installDriver(revision, versionNumber);
@@ -301,14 +317,8 @@ class Chromium extends Browser {
 
   /** @see Browser.enableExtensionInIncognito */
   static async enableExtensionInIncognito(driver, extensionTitle) {
-    let version = await getBrowserVersion(driver);
-    // Webdriver capabilities don't include a browser version for Opera
-    if (version && version < 75)
-      // The UI workaround needs a chromedriver >= 75
-      throw new Error(`Only supported on Chromium >= 75. Current version: ${version}`);
-
     await driver.navigate().to("chrome://extensions");
-    await driver.executeScript(`
+    await driver.executeScript((...args) => {
       let enable = () => document.querySelector("extensions-manager").shadowRoot
         .querySelector("extensions-detail-view").shadowRoot
         .getElementById("allow-incognito").shadowRoot
@@ -321,7 +331,7 @@ class Chromium extends Browser {
       return new Promise((resolve, reject) => {
         let extensionDetails;
         for (let {shadowRoot} of extensions) {
-          if (shadowRoot.getElementById("name").innerHTML != arguments[0])
+          if (shadowRoot.getElementById("name").innerHTML != args[0])
             continue;
 
           extensionDetails = shadowRoot.getElementById("detailsButton");
@@ -332,7 +342,8 @@ class Chromium extends Browser {
 
         extensionDetails.click();
         setTimeout(() => resolve(enable()), 100);
-      });`, extensionTitle);
+      });
+    }, extensionTitle);
   }
 }
 
@@ -342,13 +353,13 @@ class Chromium extends Browser {
  * @extends Browser
  */
 class Firefox extends Browser {
-  static async #getLatestVersion(branch) {
+  static async #getVersionForChannel(branch) {
     let data = await got("https://product-details.mozilla.org/1.0/firefox_versions.json").json();
     return branch == "beta" ?
       data.LATEST_FIREFOX_DEVEL_VERSION : data.LATEST_FIREFOX_VERSION;
   }
 
-  static #getFirefoxBinary(dir) {
+  static #getBinaryPath(dir) {
     switch (process.platform) {
       case "win32":
         return path.join(dir, "core", "firefox.exe");
@@ -391,7 +402,7 @@ class Firefox extends Browser {
 
     try {
       await fs.promises.access(browserDir);
-      return Firefox.#getFirefoxBinary(browserDir);
+      return Firefox.#getBinaryPath(browserDir);
     }
     catch (e) {}
 
@@ -405,7 +416,7 @@ class Firefox extends Browser {
     }
 
     await Firefox.#extractFirefoxArchive(archive, browserDir);
-    return Firefox.#getFirefoxBinary(browserDir);
+    return Firefox.#getBinaryPath(browserDir);
   }
 
   /**
@@ -414,18 +425,24 @@ class Firefox extends Browser {
    *   number (i.e. "68.0"). Defaults to "latest".
    * @return {BrowserBinary}
    */
-  static async downloadBinary(version) {
-    if (!version || version == "beta")
-      version = await Firefox.#getLatestVersion(version);
+  static async downloadBinary(version = "latest") {
+    const MIN_VERSION = 60;
+    const CHANNELS = ["latest", "beta"];
+
+    checkVersion(version, MIN_VERSION, CHANNELS);
 
-    let binary = await Firefox.#downloadFirefox(version);
-    return {binary, versionNumber: version};
+    let versionNumber = CHANNELS.includes(version) ?
+      await Firefox.#getVersionForChannel(version) : version;
+
+    let binary = await Firefox.#downloadFirefox(versionNumber);
+    return {binary, versionNumber};
   }
 
   /** @see Browser.getDriver */
-  static async getDriver(version, {headless = true, extensionPaths = [],
-                                   incognito = false, insecure = false,
-                                   extraArgs = []} = {}) {
+  static async getDriver(version = "latest", {
+    headless = true, extensionPaths = [], incognito = false, insecure = false,
+    extraArgs = []
+  } = {}) {
     let {binary} = await Firefox.downloadBinary(version);
 
     let options = new firefox.Options();
@@ -502,7 +519,7 @@ class Edge extends Browser {
       return {versionNumber: version, channel: "stable"};
 
     let channel = version == "latest" ? "stable" : version;
-    let {body} = await got(`https://packages.microsoft.com/repos/edge/pool/main/m/microsoft-edge-${channel}`);
+    let {body} = await got(`https://packages.microsoft.com/repos/edge/pool/main/m/microsoft-edge-${channel}/`);
     let regex = /href="microsoft-edge-(stable|beta|dev)_(.*?)-1_/gm;
     let matches;
     let versionNumbers = [];
@@ -516,6 +533,28 @@ class Edge extends Browser {
     return {versionNumber, channel};
   }
 
+  static #getDarwinAppName(channel) {
+    let extra = channel == "stable" ?
+      "" : " " + channel.charAt(0).toUpperCase() + channel.slice(1);
+    return `Microsoft Edge${extra}`;
+  }
+
+  static #getBinaryPath(channel = "stable") {
+    switch (process.platform) {
+      case "win32":
+        return "${Env:ProgramFiles(x86)}\\Microsoft\\Edge\\Application\\" +
+          "msedge.exe";
+      case "linux":
+        return channel == "stable" ?
+          "microsoft-edge" : `microsoft-edge-${channel}`;
+      case "darwin":
+        let appName = Edge.#getDarwinAppName(channel);
+        return `${process.env.HOME}/Applications/${appName}.app/Contents/MacOS/${appName}`;
+      default:
+        throw new Error(`Unexpected platform: ${process.platform}`);
+    }
+  }
+
   /**
    * Downloads the browser binary file.
    * @param {string} version - Either "latest", "beta", "dev" or a full version
@@ -524,20 +563,36 @@ class Edge extends Browser {
    * @return {BrowserBinary}
    */
   static async downloadBinary(version = "latest") {
-    if (process.platform != "linux")
-      throw new Error("Edge download is only supported on Linux");
-
+    if (process.platform == "win32")
+      // Edge is mandatory on Windows, can't be uninstalled or downgraded
+      // https://support.microsoft.com/en-us/microsoft-edge/why-can-t-i-uninstall-microsoft-edge-ee150b3b-7d7a-9984-6d83-eb36683d526d
+      throw new Error("Edge download is not supported in Windows");
+
+    const MIN_VERSION = 95;
+    const CHANNELS = ["latest", "beta", "dev"];
+    checkVersion(version, MIN_VERSION, CHANNELS);
     let {versionNumber, channel} = await Edge.#getVersionForChannel(version);
 
-    let snapshotsDir = path.join(snapshotsBaseDir, "edge");
-    let filename = `microsoft-edge-${channel}_${versionNumber}-1_amd64.deb`;
-    let archive = path.join(snapshotsDir, "cache", filename);
-    let binary = {
-      stable: "microsoft-edge",
-      beta: "microsoft-edge-beta",
-      dev: "microsoft-edge-dev"
+    let darwinName = {
+      stable: "MicrosoftEdge",
+      beta: "MicrosoftEdgeBeta",
+      dev: "MicrosoftEdgeDev"
     }[channel];
+    let filename = {
+      linux: `microsoft-edge-${channel}_${versionNumber}-1_amd64.deb`,
+      darwin: `${darwinName}-${versionNumber}.pkg`
+    }[process.platform];
+    let darwinArch = process.arch == "arm64" ?
+      "03adf619-38c6-4249-95ff-4a01c0ffc962" :
+      "C1297A47-86C4-4C1F-97FA-950631F94777";
+    let downloadUrl = {
+      linux: `https://packages.microsoft.com/repos/edge/pool/main/m/microsoft-edge-${channel}/${filename}`,
+      darwin: `https://officecdnmac.microsoft.com/pr/${darwinArch}/MacAutoupdate/${filename}`
+    }[process.platform];
 
+    let snapshotsDir = path.join(snapshotsBaseDir, "edge");
+    let archive = path.join(snapshotsDir, "cache", filename);
+    let binary = Edge.#getBinaryPath(channel);
     try {
       if (await Edge.#getInstalledVersionNumber(binary) == versionNumber)
         return {binary, versionNumber};
@@ -545,34 +600,38 @@ class Edge extends Browser {
     catch (e) {}
 
     try {
-      await download(
-        `https://packages.microsoft.com/repos/edge/pool/main/m/microsoft-edge-${channel}/${filename}`,
-        archive
-      );
+      await download(downloadUrl, archive);
     }
     catch (err) {
       throw new Error(`Edge download failed: ${err}`);
     }
-    await promisify(exec)(`dpkg -i ${archive}`);
+
+    if (process.platform == "linux") {
+      await promisify(exec)(`dpkg -i ${archive}`);
+    }
+    else if (process.platform == "darwin") {
+      let appName = Edge.#getDarwinAppName(channel);
+      try {
+        await fs.promises.rm(`${process.env.HOME}/Applications/${appName}.app`, {recursive: true});
+      }
+      catch (e) {}
+      await promisify(exec)(`installer -pkg ${archive} -target CurrentUserHomeDirectory`);
+    }
 
     return {binary, versionNumber};
   }
 
   static async #getInstalledVersionNumber(binary) {
     let installedVersion = await Edge.getInstalledVersion(binary);
-    return installedVersion.replace("beta", "").replace("dev", "")
-      .trim().replace(/.*\s/, "");
+    for (let word of ["beta", "dev", "Beta", "Dev"])
+      installedVersion = installedVersion.replace(word, "");
+    return installedVersion.trim().replace(/.*\s/, "");
   }
 
   static async #installDriver() {
-    let binary = {
-      win32:
-        "${Env:ProgramFiles(x86)}\\Microsoft\\Edge\\Application\\msedge.exe",
-      darwin: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
-      linux: "microsoft-edge"
-    }[process.platform];
-    let version = await Edge.#getInstalledVersionNumber(binary);
-    if (!version)
+    let binary = Edge.#getBinaryPath();
+    let versionNumber = await Edge.#getInstalledVersionNumber(binary);
+    if (!versionNumber)
       throw new Error("Edge is not installed");
 
     let [zip, driver] = {
@@ -582,14 +641,11 @@ class Edge extends Browser {
       "darwin-x64": ["edgedriver_mac64.zip", "msedgedriver"],
       "darwin-arm64": ["edgedriver_arm64.zip", "msedgedriver"]
     }[platform];
-    let cacheDir = path.join(snapshotsBaseDir, "edge", "cache");
-    let driverBinDir = path.join(process.cwd(), "node_modules", Edge.#DRIVER,
-                                 "bin");
-    let driverLibDir = path.join(process.cwd(), "node_modules", Edge.#DRIVER,
-                                 "lib", Edge.#DRIVER);
-    let archive = path.join(cacheDir, `${version}-${zip}`);
-
-    let vSplit = version.split(".");
+    let cacheDir = path.join(snapshotsBaseDir, "edge", "cache",
+                             `edgedriver-${versionNumber}`);
+    let archive = path.join(cacheDir, `${versionNumber}-${zip}`);
+
+    let vSplit = versionNumber.split(".");
     let lastNum = parseInt(vSplit[3], 10);
     while (lastNum >= 0) {
       try {
@@ -604,53 +660,50 @@ class Edge extends Browser {
     }
 
     if (lastNum < 0)
-      throw new Error(`msedgedriver was not found for Edge ${version}`);
+      throw new Error(`msedgedriver was not found for Edge ${versionNumber}`);
 
-    await extractZip(archive, {dir: cacheDir});
     await killDriverProcess(Edge.#DRIVER);
-    for (let destinationDir of [driverBinDir, driverLibDir]) {
-      await fs.promises.mkdir(destinationDir, {recursive: true});
-      await fs.promises.copyFile(path.join(cacheDir, driver),
-                                 path.join(destinationDir, driver));
+    let driverPath = path.join(cacheDir, driver);
+    try {
+      await fs.promises.rm(driverPath, {recursive: true});
     }
+    catch (e) {} // file does not exist
+    await extractZip(archive, {dir: cacheDir});
+
+    return driverPath;
   }
 
   /** @see Browser.getDriver */
-  static async getDriver(version, {headless = true, extensionPaths = [],
-                                   incognito = false, insecure = false,
-                                   extraArgs = []} = {}) {
-    if (process.platform == "linux")
+  static async getDriver(version = "latest", {
+    headless = true, extensionPaths = [], incognito = false, insecure = false,
+    extraArgs = []
+  } = {}) {
+    if (process.platform == "linux" || process.platform == "darwin")
       await Edge.downloadBinary(version);
 
-    await Edge.#installDriver();
+    let driverPath = await Edge.#installDriver();
+    let serviceBuilder = new edge.ServiceBuilder(driverPath);
 
-    let args = ["no-sandbox", ...extraArgs];
+    let options = new edge.Options().addArguments("no-sandbox", ...extraArgs);
     if (headless)
-      args.push("headless");
+      options.headless();
     if (extensionPaths.length > 0)
-      args.push(`load-extension=${extensionPaths.join(",")}`);
+      options.addArguments(`load-extension=${extensionPaths.join(",")}`);
     if (incognito)
-      args.push("incognito");
+      options.addArguments("incognito");
+    if (insecure)
+      options.addArguments("ignore-certificate-errors");
 
     let builder = new webdriver.Builder();
     builder.forBrowser("MicrosoftEdge");
-    builder.withCapabilities({
-      "browserName": "MicrosoftEdge",
-      "ms:edgeChromium": true,
-      "ms:edgeOptions": {args},
-      "acceptInsecureCerts": insecure
-    });
+    builder.setEdgeOptions(options);
+    builder.setEdgeService(serviceBuilder);
 
     return builder.build();
   }
 
   /** @see Browser.enableExtensionInIncognito */
   static async enableExtensionInIncognito(driver, extensionTitle) {
-    let version = await getBrowserVersion(driver);
-    if (version < 79)
-      // The UI workaround needs a chromium based msedgedriver
-      throw new Error(`Only supported on Edge >= 79. Current version: ${version}`);
-
     await driver.navigate().to("edge://extensions/");
     for (let elem of await driver.findElements(By.css("[role=listitem]"))) {
       let text = await elem.getAttribute("innerHTML");
@@ -677,7 +730,7 @@ class Edge extends Browser {
  * @extends Browser
  */
 class Opera extends Browser {
-  static async #getVersionForChannel(version) {
+  static async #getVersionForChannel(version, platformDir) {
     let channelPath = "opera/desktop";
     let filePrefix = "Opera";
     if (version != "latest")
@@ -686,12 +739,24 @@ class Opera extends Browser {
     let {body} = await got(`https://ftp.opera.com/pub/${channelPath}`);
     let regex = /href="(\d.*)\/"/gm;
     let matches = body.match(regex);
-    let versionNumber = regex.exec(matches[matches.length - 1])[1];
+    let versionNumber;
+    while (matches.length > 0) {
+      let result = regex.exec(matches.pop());
+      if (!result)
+        continue;
+
+      versionNumber = result[1];
+      try {
+        await got(`https://ftp.opera.com/pub/${channelPath}/${versionNumber}/${platformDir}`);
+        break;
+      }
+      catch (e) {}
+    }
 
     return {versionNumber, channelPath, filePrefix};
   }
 
-  static #getOperaBinary(dir) {
+  static #getBinaryPath(dir) {
     switch (process.platform) {
       case "win32":
         return path.join(dir, "launcher.exe");
@@ -708,7 +773,7 @@ class Opera extends Browser {
     let child = spawn("dpkg", ["-i", archive]);
 
     child.stdout.on("data", data => {
-      if (data.toString().startsWith("Do you want to update Opera")) {
+      if (data.toString().includes("Do you want to update Opera")) {
         process.stdin.pipe(child.stdin);
         child.stdin.write("no\r\n");
       }
@@ -761,8 +826,10 @@ class Opera extends Browser {
    * @return {BrowserBinary}
    */
   static async downloadBinary(version = "latest") {
-    let {versionNumber, channelPath, filePrefix} =
-      await Opera.#getVersionForChannel(version);
+    const MIN_VERSION = 62;
+    const CHANNELS = ["latest"];
+
+    checkVersion(version, MIN_VERSION, CHANNELS);
 
     let [platformDir, fileSuffix] = {
       "win32-ia32": ["win", "Autoupdate.exe"],
@@ -772,13 +839,20 @@ class Opera extends Browser {
       "dawrin-arm64": ["mac", "Autoupdate_arm64.tar.xz"]
     }[platform];
 
+    let {versionNumber, channelPath, filePrefix} =
+      await Opera.#getVersionForChannel(version, platformDir);
+
     let snapshotsDir = path.join(snapshotsBaseDir, "opera");
     let browserDir = path.join(snapshotsDir, `opera-${platform}-${versionNumber}`);
     let filename = `${filePrefix}_${versionNumber}_${fileSuffix}`;
     let archive = path.join(snapshotsDir, "cache", filename);
 
-    let binary = Opera.#getOperaBinary(browserDir);
+    let binary = Opera.#getBinaryPath(browserDir);
     try {
+      if (process.platform == "linux" &&
+          await Opera.getInstalledVersion("opera") == versionNumber)
+        return {binary, versionNumber};
+
       await fs.promises.access(browserDir);
       return {binary, versionNumber};
     }
@@ -789,10 +863,13 @@ class Opera extends Browser {
       await fs.promises.access(archive);
     }
     catch (e) {
-      await download(
-        `https://ftp.opera.com/pub/${channelPath}/${versionNumber}/${platformDir}/${filename}`,
-        archive
-      );
+      let url = `https://ftp.opera.com/pub/${channelPath}/${versionNumber}/${platformDir}/${filename}`;
+      try {
+        await download(url, archive);
+      }
+      catch (err) {
+        throw new Error(`Browser download unavailable at ${url}\n${err}`);
+      }
     }
 
     await Opera.#extractOperaArchive(archive, browserDir, filename);
@@ -812,7 +889,7 @@ class Opera extends Browser {
     versionNumber = versionNumber.split(".")[0];
 
     let cacheDir = path.join(snapshotsBaseDir, "opera", "cache",
-                             `driver-for-opera-${versionNumber}`);
+                             `operadriver-${versionNumber}`);
     let archive = path.join(cacheDir, zip);
 
     let {body} = await got(`https://github.com/operasoftware/operachromiumdriver/releases?q=Opera+${versionNumber}&expanded=true`);

package/test/.eslintrc.json

@@ -1,5 +1,6 @@
 {
   "env": {
-    "mocha": true
+    "mocha": true,
+    "browser": true
   }
 }

package/test/browsers.js

@@ -25,13 +25,12 @@ import {killDriverProcess} from "../src/utils.js";
 // Required to set the driver path on Windows
 import "chromedriver";
 import "geckodriver";
-import "msedgedriver";
 
 const VERSIONS = {
-  chromium: [void 0, "77.0.3865.0", "beta", "dev"],
-  firefox: [void 0, "68.0", "beta"],
-  edge: [void 0, "95.0.1020.53", "beta", "dev"],
-  opera: [void 0, "64.0.3417.92"]
+  chromium: ["latest", "75.0.3770.0", "beta", "dev"],
+  firefox: ["latest", "60.0", "beta"],
+  edge: ["latest", "95.0.1020.53", "beta", "dev"],
+  opera: ["latest", "62.0.3331.66"]
 };
 const TEST_URL = "https://gitlab.com/eyeo/developer-experience/get-browser-binary";
 let extensionPaths = [path.resolve(process.cwd(), "test", "extension")];
@@ -74,9 +73,27 @@ function normalize(version) {
   return normalized.split("b")[0];
 }
 
+function getWindowSize(driver) {
+  return driver.executeScript(() => {
+    return {height: window.innerHeight, width: window.innerWidth};
+  });
+}
+
+expect.extend({
+  toMeasureLessThan(small, big) {
+    let pass = small.width < big.width || small.height < big.height;
+    let message = () =>
+      `expected small sizes (w: ${small.width}, h: ${small.height}) ` +
+      `to be smaller than big sizes (w: ${big.width}, h: ${big.height})`;
+    if (pass)
+      return {message, pass: true};
+    return {message, pass: false};
+  }
+});
+
 for (let browser of Object.keys(BROWSERS)) {
   describe(`Browser: ${browser}`, function() {
-    this.timeout(40000);
+    this.timeout(150000);
 
     before(async() => {
       try {
@@ -86,9 +103,10 @@ for (let browser of Object.keys(BROWSERS)) {
     });
 
     for (let version of VERSIONS[browser]) {
-      describe(`Version: ${version || "latest"}`, () => {
+      describe(`Version: ${version}`, () => {
         let driver = null;
-        afterEach(async() => {
+
+        async function quitDriver() {
           if (!driver)
             return;
 
@@ -99,16 +117,21 @@ for (let browser of Object.keys(BROWSERS)) {
             await killDriverProcess("chromedriver");
           else if (browser == "firefox")
             await killDriverProcess("geckodriver");
-        });
+        }
+
+        afterEach(quitDriver);
 
         it("downloads", async function() {
-          if (browser == "edge" && process.platform != "linux")
+          if (browser == "edge" && process.platform == "win32")
             this.skip();
 
           let {binary, versionNumber} =
             await BROWSERS[browser].downloadBinary(version);
-          let browserDir = browser == "opera" ? /(opera|Opera)/ : browser;
-          expect(binary).toEqual(expect.stringMatching(browserDir));
+          let browserName =
+            browser == "opera" ? /(opera|Opera)/ :
+            browser == "edge" ? /(edge|Edge)/ :
+            browser;
+          expect(binary).toEqual(expect.stringMatching(browserName));
 
           let installedVersion =
             await BROWSERS[browser].getInstalledVersion(binary);
@@ -132,10 +155,21 @@ for (let browser of Object.keys(BROWSERS)) {
         });
 
         it("supports extra args", async() => {
+          let headless = false;
           let extraArgs = browser == "firefox" ?
             ["--devtools"] : ["auto-open-devtools-for-tabs"];
-          driver = await BROWSERS[browser].getDriver(version, {extraArgs});
+
+          driver = await BROWSERS[browser].getDriver(
+            version, {headless, extraArgs});
+          await driver.navigate().to(TEST_URL);
+          let sizeDevToolsOpen = await getWindowSize(driver);
+          await quitDriver();
+
+          driver = await BROWSERS[browser].getDriver(version, {headless});
           await driver.navigate().to(TEST_URL);
+          let sizeDevToolsClosed = await getWindowSize(driver);
+
+          expect(sizeDevToolsOpen).toMeasureLessThan(sizeDevToolsClosed);
         });
 
         it("loads an extension", async() => {
@@ -147,7 +181,7 @@ for (let browser of Object.keys(BROWSERS)) {
         });
 
         it("loads an extension in incognito mode", async function() {
-          if (browser == "firefox" && version == "68.0")
+          if (browser == "firefox" && version == "60.0")
             this.skip();
 
           driver = await BROWSERS[browser].getDriver(
@@ -159,5 +193,15 @@ for (let browser of Object.keys(BROWSERS)) {
         });
       });
     }
+
+    it("does not download unsupported versions", async function() {
+      if (browser == "edge" && process.platform == "win32")
+        this.skip();
+
+      const UNSUPPORTED = "0.0";
+
+      await expect(BROWSERS[browser].downloadBinary(UNSUPPORTED))
+        .rejects.toThrow(`Unsupported browser version: ${UNSUPPORTED}`);
+    });
   });
 }

package/test/docker/Dockerfile

@@ -1,15 +1,4 @@
-FROM node:16-bullseye-slim
-
-# General packages
-RUN apt-get update && apt-get install -y git procps wget unzip bzip2 gnupg
-# xvfb (headful browser run)
-RUN apt-get install -y libgtk-3-0 libxt6 xvfb libnss3 libxss1
-# General browser dependencies
-RUN apt-get install -y libgconf-2-4 libasound2 libgbm1
-# Edge dependencies
-RUN apt-get install -y fonts-liberation libatomic1 xdg-utils
-# Opera dependencies
-RUN apt-get install -y libcurl4 libgdk-pixbuf2.0-0
+FROM registry.gitlab.com/eyeo/docker/get-browser-binary:node16
 
 COPY package*.json get-browser-binary/
 RUN cd get-browser-binary && npm install