@eyeo/get-browser-binary 0.12.0 → 0.14.0

package/src/firefox.js

@@ -0,0 +1,216 @@
+/*
+ * Copyright (c) 2006-present eyeo GmbH
+ *
+ * This module is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+import path from "path";
+import {exec} from "child_process";
+import {promisify} from "util";
+import fs from "fs";
+
+import got from "got";
+import webdriver from "selenium-webdriver";
+import firefox from "selenium-webdriver/firefox.js";
+
+import {Browser} from "./browser.js";
+import {download, extractTar, extractDmg, killDriverProcess, wait,
+        getMajorVersion, checkVersion, checkPlatform, errMsg, snapshotsBaseDir,
+        platformArch} from "./utils.js";
+
+let {until, By} = webdriver;
+
+/**
+ * Browser and webdriver functionality for Firefox.
+ * @hideconstructor
+ * @extends Browser
+ */
+export class Firefox extends Browser {
+  static #CHANNELS = ["latest", "beta"];
+
+  static async #getVersionForChannel(channel) {
+    if (!Firefox.#CHANNELS.includes(channel))
+      return channel;
+
+    let url = "https://product-details.mozilla.org/1.0/firefox_versions.json";
+    let data;
+    try {
+      data = await got(url).json();
+    }
+    catch (err) {
+      throw new Error(`${errMsg.browserVersionCheck}: ${url}\n${err}`);
+    }
+    return channel == "beta" ?
+      data.LATEST_FIREFOX_DEVEL_VERSION : data.LATEST_FIREFOX_VERSION;
+  }
+
+  static #getBinaryPath(dir) {
+    checkPlatform();
+    return {
+      win32: path.join(dir, "core", "firefox.exe"),
+      linux: path.join(dir, "firefox", "firefox"),
+      darwin: path.join(dir, "Firefox.app", "Contents", "MacOS", "firefox")
+    }[process.platform];
+  }
+
+  static #extractFirefoxArchive(archive, dir) {
+    switch (process.platform) {
+      case "win32":
+        return promisify(exec)(`"${archive}" /extractdir=${dir}`);
+      case "linux":
+        return extractTar(archive, dir);
+      case "darwin":
+        return extractDmg(archive, dir);
+      default:
+        checkPlatform();
+    }
+  }
+
+  static async #getInstalledBrowserInfo(binary) {
+    let installedVersion = await Firefox.getInstalledVersion(binary);
+    // Linux example: "Mozilla Firefox 102.15.0esr"
+    let versionNumber = installedVersion.split(" ")[2] || installedVersion;
+    return {binary, versionNumber};
+  }
+
+  /**
+   * Installs the browser. The Firefox executable gets extracted in the
+   *   {@link snapshotsBaseDir} folder, ready to go.
+   * @param {string} [version=latest] Either "latest", "beta" or a full version
+   *   number (i.e. "68.0").
+   * @param {number} [downloadTimeout=0] Allowed time in ms for the download of
+   *   install files to complete. When set to 0 there is no time limit.
+   * @return {BrowserBinary}
+   * @throws {Error} Unsupported browser version, Unsupported platform, Browser
+   *   download failed.
+   */
+  static async installBrowser(version = "latest", downloadTimeout = 0) {
+    const MIN_VERSION = 68;
+
+    // https://gitlab.com/eyeo/developer-experience/get-browser-binary/-/issues/46
+    if (platformArch == "linux-arm64")
+      return await Firefox.#getInstalledBrowserInfo("/usr/bin/firefox");
+
+    checkVersion(version, MIN_VERSION, Firefox.#CHANNELS);
+    let versionNumber = await Firefox.#getVersionForChannel(version);
+
+    let [buildPlatform, fileName] = {
+      "win32-ia32": ["win32", `Firefox Setup ${versionNumber}.exe`],
+      "win32-x64": ["win64", `Firefox Setup ${versionNumber}.exe`],
+      "linux-x64": ["linux-x86_64", `firefox-${versionNumber}.tar.bz2`],
+      "darwin-x64": ["mac", `Firefox ${versionNumber}.dmg`],
+      "darwin-arm64": ["mac", `Firefox ${versionNumber}.dmg`]
+    }[platformArch];
+
+    let snapshotsDir = path.join(snapshotsBaseDir, "firefox");
+    let browserDir = path.join(snapshotsDir,
+                               `firefox-${platformArch}-${versionNumber}`);
+    let binary = Firefox.#getBinaryPath(browserDir);
+    try {
+      await fs.promises.access(browserDir);
+      return {binary, versionNumber};
+    }
+    catch (e) {}
+
+    let archive = path.join(snapshotsDir, "cache", fileName);
+    await fs.promises.mkdir(path.dirname(browserDir), {recursive: true});
+    try {
+      await fs.promises.access(archive);
+    }
+    catch (e) {
+      let url = `https://archive.mozilla.org/pub/firefox/releases/${versionNumber}/${buildPlatform}/en-US/${fileName}`;
+      try {
+        await download(url, archive, downloadTimeout);
+      }
+      catch (err) {
+        throw new Error(`${errMsg.browserDownload}: ${url}\n${err}`);
+      }
+    }
+    await Firefox.#extractFirefoxArchive(archive, browserDir);
+
+    return {binary, versionNumber};
+  }
+
+  /** @see Browser.getDriver */
+  static async getDriver(version = "latest", {
+    headless = true, extensionPaths = [], incognito = false, insecure = false,
+    extraArgs = [], customBrowserBinary
+  } = {}, downloadTimeout = 0) {
+    let binary;
+    let versionNumber;
+    if (!customBrowserBinary) {
+      ({binary, versionNumber} =
+        await Firefox.installBrowser(version, downloadTimeout));
+    }
+
+    let options = new firefox.Options();
+    if (headless)
+      options.headless();
+    if (incognito)
+      options.addArguments("--private");
+    if (insecure)
+      options.set("acceptInsecureCerts", true);
+    if (extraArgs.length > 0)
+      options.addArguments(...extraArgs);
+    // Enabled by default on Firefox > 68
+    if (versionNumber && getMajorVersion(versionNumber) == 68)
+      options.setPreference("dom.promise_rejection_events.enabled", true);
+
+    options.setBinary(customBrowserBinary || binary);
+
+    let driver;
+    // The OS may be low on resources, that's why building the driver is retried
+    // https://github.com/mozilla/geckodriver/issues/1560
+    await wait(async() => {
+      try {
+        driver = await new webdriver.Builder()
+          .forBrowser("firefox")
+          .setFirefoxOptions(options)
+          .build();
+        return true;
+      }
+      catch (err) {
+        if (err.message != "Failed to decode response from marionette")
+          throw err;
+        await killDriverProcess("geckodriver");
+      }
+    }, 30000, `${errMsg.driverStart}: geckodriver`, 1000);
+
+    for (let extensionPath of extensionPaths) {
+      let temporary = true; // Parameter not documented on the webdriver docs
+      await driver.installAddon(extensionPath, temporary);
+    }
+    return driver;
+  }
+
+  /** @see Browser.enableExtensionInIncognito */
+  static async enableExtensionInIncognito(driver, extensionTitle) {
+    let version = (await driver.getCapabilities()).getBrowserVersion();
+    // The UI workaround assumes web elements only present on Firefox >= 87
+    checkVersion(version, 87);
+
+    await driver.navigate().to("about:addons");
+    await driver.wait(until.elementLocated(By.name("extension")), 1000).click();
+
+    for (let elem of await driver.findElements(By.className("card addon"))) {
+      let text = await elem.getAttribute("innerHTML");
+      if (!text.includes(extensionTitle))
+        continue;
+
+      await elem.click();
+      return await driver.findElement(By.name("private-browsing")).click();
+    }
+    throw new Error(`${errMsg.extensionNotFound}: ${extensionTitle}`);
+  }
+}

package/src/utils.js

@@ -25,6 +25,24 @@ import got from "got";
 import dmg from "dmg";
 import Jimp from "jimp";
 
+export const errMsg = {
+  unsupportedVersion: "Unsupported browser version",
+  unsupportedPlatform: "Unsupported platform",
+  driverDownload: "Driver download failed",
+  driverStart: "Unable to start driver",
+  extensionNotFound: "Extension not found",
+  browserDownload: "Browser download failed",
+  browserNotInstalled: "Browser is not installed",
+  browserVersionCheck: "Checking the browser version failed",
+  elemNotFound: "HTML element not found"
+};
+export const platformArch = `${process.platform}-${process.arch}`;
+
+/**
+ * Root folder where browser and webdriver files get downloaded and extracted.
+ * @type {string}
+ */
+export let snapshotsBaseDir = path.join(process.cwd(), "browser-snapshots");
 
 /**
  * Downloads url resources.
@@ -35,6 +53,10 @@ import Jimp from "jimp";
  * @throws {TypeError} Invalid URL, Download timeout.
  */
 export async function download(url, destFile, timeout = 0) {
+  if (process.env.VERBOSE == "true")
+    // eslint-disable-next-line no-console
+    console.log(`Downloading from ${url} ...`);
+
   let cacheDir = path.dirname(destFile);
   await fs.promises.mkdir(cacheDir, {recursive: true});
 
@@ -215,3 +237,24 @@ export async function takeFullPageScreenshot(driver, hideScrollbars = true) {
 
   return fullScreenshot;
 }
+
+export function getMajorVersion(versionNumber) {
+  let majorVersion = parseInt(versionNumber && versionNumber.split(".")[0], 10);
+  if (isNaN(majorVersion))
+    throw new Error(`${errMsg.unsupportedVersion}: ${versionNumber}`);
+
+  return majorVersion;
+}
+
+export function checkVersion(version, minVersion, channels = []) {
+  if (channels.includes(version))
+    return;
+
+  if (getMajorVersion(version) < minVersion)
+    throw new Error(`${errMsg.unsupportedVersion}: ${version}`);
+}
+
+export function checkPlatform() {
+  if (!["win32", "linux", "darwin"].includes(process.platform))
+    throw new Error(`${errMsg.unsupportedPlatform}: ${process.platform}`);
+}

package/test/browsers.js

@@ -18,20 +18,22 @@
 import fs from "fs";
 import {expect} from "expect";
 import path from "path";
+import Jimp from "jimp";
+import {By} from "selenium-webdriver";
 
 import {BROWSERS, snapshotsBaseDir, takeFullPageScreenshot} from "../index.js";
 import {killDriverProcess} from "../src/utils.js";
-import Jimp from "jimp";
+import {TEST_SERVER_URL} from "./test-server.js";
 
 import "geckodriver"; // Required to set the driver path on Windows
 
 const VERSIONS = {
-  chromium: ["latest", "75.0.3770.0", "beta", "dev"],
-  firefox: ["latest", "60.0", "beta"],
-  edge: ["dev", "latest", "beta", "95.0.1020.40"]
+  chromium: ["latest", "77.0.3865.0", "beta", "dev"],
+  firefox: ["latest", "68.0", "beta"],
+  edge: ["latest", "95.0.1020.40", "beta", "dev"]
 };
-const TEST_URL = "https://abptestpages.org/en/exceptions/iframe_subdomains";
-const TEST_URL_LONG_PAGE = "https://abptestpages.org/";
+const TEST_URL_BASIC = `${TEST_SERVER_URL}/basic.html`;
+const TEST_URL_LONG = `${TEST_SERVER_URL}/long.html`;
 
 async function switchToHandle(driver, testFn) {
   for (let handle of await driver.getAllWindowHandles()) {
@@ -105,14 +107,20 @@ function getExtension(browser, version) {
 }
 
 async function getCachedTimes(browser) {
-  let armLinuxChromium = browser == "chromium" &&
-    process.platform == "linux" && process.arch == "arm64";
+  let armLinux = process.platform == "linux" && process.arch == "arm64";
   let cacheDir = path.join(snapshotsBaseDir, browser, "cache");
-  let cacheFiles = await fs.promises.readdir(cacheDir);
+  let cacheFiles;
+  try {
+    cacheFiles = await fs.promises.readdir(cacheDir);
+  }
+  catch (err) {
+    if (!armLinux)
+      throw err;
+  }
 
   let browserCacheTime = null;
-  // Edge gets installed at OS level, that's why it's not tested here
-  if (browser != "edge" && !armLinuxChromium) {
+  // Browsers installed at OS level are not tested
+  if (browser != "edge" && !armLinux) {
     let installTypes = [".zip", ".dmg", ".bz2"];
     let browserZip =
       cacheFiles.find(elem => installTypes.some(type => elem.includes(type)));
@@ -122,7 +130,8 @@ async function getCachedTimes(browser) {
 
   let driverCacheTime = null;
   // geckodriver is installed by npm, that's why Firefox is not tested here
-  if (browser != "firefox" && !armLinuxChromium) {
+  // for chromiumdriver on arm linux, see https://gitlab.com/eyeo/developer-experience/get-browser-binary/-/issues/46
+  if (browser != "firefox" && !armLinux) {
     let driverDir = cacheFiles.find(
       elem => !elem.endsWith(".zip") && !elem.endsWith(".pkg"));
     let driverFiles = await fs.promises.readdir(path.join(cacheDir, driverDir));
@@ -135,6 +144,21 @@ async function getCachedTimes(browser) {
   return {browserCTime: browserCacheTime, driverCTime: driverCacheTime};
 }
 
+const browserNames = {
+  chromium: "chrome",
+  firefox: "firefox",
+  edge: /(MicrosoftEdge|msedge)/
+};
+
+async function basicUrlTest(driver, browser) {
+  await driver.navigate().to(TEST_URL_BASIC);
+  expect((await driver.getCapabilities()).getBrowserName())
+    .toEqual(expect.stringMatching(browserNames[browser]));
+
+  let text = await driver.findElement(By.id("basic")).getText();
+  expect(text).toEqual("Test server basic page");
+}
+
 for (let browser of Object.keys(BROWSERS)) {
   describe(`Browser: ${browser}`, () => {
     before(async() => {
@@ -149,6 +173,7 @@ for (let browser of Object.keys(BROWSERS)) {
         let driver = null;
         let emptyCacheTimes = null;
         let customBrowserBinary = null;
+        let failedInstall = false;
 
         async function quitDriver() {
           if (!driver)
@@ -163,14 +188,27 @@ for (let browser of Object.keys(BROWSERS)) {
             await killDriverProcess("geckodriver");
         }
 
+        beforeEach(function() {
+          if (failedInstall)
+            this.skip();
+        });
+
         afterEach(quitDriver);
 
         it("installs", async function() {
           if (browser == "edge" && process.platform == "win32")
             this.skip();
 
-          let {binary, versionNumber} =
-            await BROWSERS[browser].installBrowser(version, this.timeout());
+          let binary;
+          let versionNumber;
+          try {
+            ({binary, versionNumber} =
+              await BROWSERS[browser].installBrowser(version, this.timeout()));
+          }
+          catch (err) {
+            failedInstall = true;
+            throw err;
+          }
           let browserName = browser == "edge" ? /(edge|Edge)/ : browser;
           expect(binary).toEqual(expect.stringMatching(browserName));
 
@@ -185,17 +223,8 @@ for (let browser of Object.keys(BROWSERS)) {
         });
 
         it("runs", async() => {
-          let names = {
-            chromium: "chrome",
-            firefox: "firefox",
-            edge: /(MicrosoftEdge|msedge)/
-          };
-
           driver = await BROWSERS[browser].getDriver(version);
-          await driver.navigate().to(TEST_URL);
-
-          expect((await driver.getCapabilities()).getBrowserName())
-            .toEqual(expect.stringMatching(names[browser]));
+          await basicUrlTest(driver, browser);
 
           // When running all tests, this saves time on the cache test
           emptyCacheTimes = await getCachedTimes(browser);
@@ -220,41 +249,35 @@ for (let browser of Object.keys(BROWSERS)) {
           if (!customBrowserBinary)
             this.skip();
 
-          let names = {
-            chromium: "chrome",
-            firefox: "firefox",
-            edge: /(MicrosoftEdge|msedge)/
-          };
-
           driver =
             await BROWSERS[browser].getDriver(version, {customBrowserBinary});
-          await driver.navigate().to(TEST_URL);
+          await basicUrlTest(driver, browser);
 
           expect((await driver.getCapabilities()).getBrowserName())
-            .toEqual(expect.stringMatching(names[browser]));
+            .toEqual(expect.stringMatching(browserNames[browser]));
         });
 
         it("supports extra args", async() => {
           let headless = false;
           let extraArgs = browser == "firefox" ?
-            ["--devtools"] : ["auto-open-devtools-for-tabs"];
+            ["-width=600", "-height=400"] : ["window-size=600,400"];
 
           driver = await BROWSERS[browser].getDriver(
             version, {headless, extraArgs});
-          await driver.navigate().to(TEST_URL);
-          let sizeDevToolsOpen = await getWindowSize(driver);
+          await driver.navigate().to(TEST_URL_BASIC);
+          let sizeSmall = await getWindowSize(driver);
           await quitDriver();
 
           driver = await BROWSERS[browser].getDriver(version, {headless});
-          await driver.navigate().to(TEST_URL);
-          let sizeDevToolsClosed = await getWindowSize(driver);
+          await driver.navigate().to(TEST_URL_BASIC);
+          let sizeDefault = await getWindowSize(driver);
 
-          expect(sizeDevToolsOpen).toMeasureLessThan(sizeDevToolsClosed);
+          expect(sizeSmall).toMeasureLessThan(sizeDefault);
         });
 
         it("takes a full page screenshot", async() => {
           driver = await BROWSERS[browser].getDriver(version);
-          await driver.navigate().to(TEST_URL_LONG_PAGE);
+          await driver.navigate().to(TEST_URL_LONG);
 
           let fullImg = await takeFullPageScreenshot(driver);
           // Taking a regular webdriver screenshot, which should be shorter
@@ -277,7 +300,7 @@ for (let browser of Object.keys(BROWSERS)) {
         });
 
         it("loads an extension in incognito mode", async function() {
-          if (browser == "firefox" && version == "60.0")
+          if (browser == "firefox" && version == "68.0")
             this.skip();
 
           let {extensionPaths, manifest} = getExtension(browser, version);
@@ -300,5 +323,11 @@ for (let browser of Object.keys(BROWSERS)) {
           .rejects.toThrow(`Unsupported browser version: ${unsupported}`);
       }
     });
+
+    it("does not run not installed custom browsers", async() => {
+      let customBrowserBinary = "not-installed";
+      await expect(BROWSERS[browser].getDriver("latest", {customBrowserBinary}))
+        .rejects.toThrow(/(Browser is not installed|binary is not a Firefox executable)/);
+    });
   });
 }

package/test/docker/Dockerfile

@@ -1,4 +1,4 @@
-FROM registry.gitlab.com/eyeo/docker/get-browser-binary:node16
+FROM registry.gitlab.com/eyeo/docker/get-browser-binary:node18
 
 COPY package*.json get-browser-binary/
 RUN cd get-browser-binary && npm install

package/test/docker/arm64.Dockerfile

@@ -1,6 +1,6 @@
-# Duplicated from registry.gitlab.com/eyeo/docker/get-browser-binary:node16
+# Duplicated from registry.gitlab.com/eyeo/docker/get-browser-binary:node18
 # https://gitlab.com/eyeo/developer-experience/get-browser-binary/-/issues/46
-FROM node:16-bullseye-slim
+FROM node:18-bullseye-slim
 # General packages
 RUN apt-get update && apt-get install -y git procps wget unzip bzip2 gnupg
 # xvfb (headful browser run)
@@ -12,6 +12,11 @@ RUN apt-get install -y fonts-liberation libatomic1 xdg-utils libu2f-udev
 
 # Chromium ARM
 RUN apt-get install -y chromium
+# https://askubuntu.com/questions/1360864/google-chrome-not-launching
+RUN mkdir -p "/root/.config/chromium/Crash Reports/pending/"
+
+# Firefox ARM
+RUN apt-get install -y firefox-esr
 
 COPY package*.json get-browser-binary/
 RUN cd get-browser-binary && npm install

package/test/extension/mv3/manifest.json

@@ -4,5 +4,6 @@
   "manifest_version": 3,
   "background": {
     "service_worker": "background.js"
-  }
+  },
+  "incognito": "split"
 }

package/test/pages/basic.html

@@ -0,0 +1 @@
+<h1 id="basic">Test server basic page</h1>

package/test/pages/download-test.txt

@@ -0,0 +1 @@
+Download test

package/test/pages/long.html

@@ -0,0 +1,41 @@
+<h1>Test server long page</h1>
+<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum a sollicitudin elit. Vivamus ornare fermentum mi vel laoreet. Nullam eget risus gravida, placerat tellus at, mattis orci. Sed libero sapien, facilisis ac dignissim eget, eleifend et massa. Praesent sit amet pharetra elit. Cras vitae lorem elit. Duis sagittis nec libero commodo eleifend. Pellentesque volutpat elit cursus semper varius. Donec tempor sit amet purus id lacinia. Ut dui enim, tincidunt non ornare non, hendrerit non ante. Phasellus vel varius turpis, vulputate ultrices ex. Maecenas egestas magna eget lobortis sodales. Proin ut ex vulputate, efficitur urna eget, facilisis felis. Aliquam et bibendum lectus.
+</p>
+<p>Etiam vitae laoreet mi, eu pulvinar turpis. Nullam volutpat est quis erat imperdiet auctor. Morbi vulputate risus at eleifend vestibulum. Nulla pharetra bibendum enim, sit amet tempus libero posuere in. Phasellus ac dui nunc. Aliquam vehicula nibh lorem, feugiat pharetra urna varius vitae. Suspendisse potenti. Maecenas non rutrum quam. Phasellus nunc mauris, gravida eu augue eget, consectetur scelerisque arcu. Pellentesque venenatis molestie nisi eget imperdiet. Sed convallis convallis nisl, at malesuada lectus tristique eu. Vestibulum rhoncus in sapien et efficitur.
+</p>
+<p>Quisque ac nunc a felis vestibulum pulvinar. Donec sodales mollis blandit. Ut porta tortor et metus semper bibendum. Morbi dignissim volutpat tempus. Donec venenatis ut ipsum id ullamcorper. Vestibulum urna mauris, ultricies quis dapibus semper, finibus non ex. Suspendisse porttitor, justo et tristique tincidunt, erat turpis sagittis velit, gravida imperdiet metus ex ut nulla. Maecenas semper mi ligula, non pharetra tellus gravida nec. Donec ut nunc vel nulla efficitur consectetur in ut tortor. Ut consectetur sit amet tellus id tempor.
+</p>
+<p>Quisque nec egestas risus. Nam hendrerit ex felis, semper finibus enim bibendum in. Suspendisse sed lobortis metus, at eleifend nisi. Etiam nec gravida felis, ut tincidunt nunc. Proin condimentum laoreet lacus eu facilisis. Aenean ut commodo mauris, sit amet imperdiet enim. In dapibus auctor leo, sit amet facilisis nisl venenatis in. Morbi a magna sit amet metus efficitur bibendum. Nunc sit amet purus id purus malesuada dignissim. Donec metus arcu, tincidunt eget malesuada eget, laoreet a ex. Donec tincidunt pretium ex, eget iaculis nisl semper nec. Ut ac tortor est.
+</p>
+<p>Vivamus sed lorem metus. Maecenas eu ipsum finibus, pretium urna quis, ultrices lectus. Donec sem purus, consectetur non lobortis at, ultrices eget nulla. Duis est ligula, venenatis sit amet tortor id, placerat hendrerit enim. Curabitur in fringilla est. Cras quis arcu ut libero venenatis imperdiet. Donec quis nunc non odio gravida porttitor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Maecenas mauris mi, venenatis quis imperdiet at, fringilla ac quam. Pellentesque tincidunt viverra ex, at pulvinar odio placerat et. Nullam suscipit facilisis lorem ut imperdiet. Aenean dictum, purus ut mollis efficitur, leo diam maximus mauris, et facilisis nibh nisl vitae quam.
+</p>
+<p>Ut euismod ut ligula mollis feugiat. Cras congue eros at urna posuere, id pretium turpis sodales. Suspendisse eu sapien ut felis placerat varius ullamcorper id tellus. Vestibulum facilisis sodales accumsan. Nunc enim metus, volutpat sed consequat sed, tincidunt in dui. Curabitur auctor ac nisl sed eleifend. Suspendisse id ante magna. Aliquam est justo, congue id facilisis ut, suscipit in nunc. Nunc at leo nec purus auctor fringilla. Morbi tincidunt aliquet arcu, eu tempus enim eleifend a. Morbi porttitor metus et ultrices pellentesque. Curabitur pharetra sit amet velit quis dictum.
+</p>
+<p>Nam laoreet semper erat, non pellentesque lacus euismod a. Sed quis massa interdum augue pellentesque blandit. Proin nulla neque, bibendum in nisi nec, sollicitudin aliquam erat. Aliquam bibendum nulla augue, eget dictum lorem suscipit vestibulum. Nulla purus nulla, egestas sed diam ultricies, porta hendrerit lectus. Nunc tristique eu felis a sagittis. Pellentesque vulputate fermentum tellus. Morbi leo arcu, tempor ut mollis in, ultricies id odio. Curabitur vel diam ultrices, porttitor diam eu, gravida velit. Aliquam fringilla iaculis diam, tristique rhoncus odio pulvinar et. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Donec hendrerit molestie velit, eget tempor velit volutpat in. Donec ac felis et nibh vulputate bibendum. Suspendisse pharetra feugiat diam nec rhoncus. Curabitur sodales hendrerit nulla eget venenatis.
+</p>
+<p>Vivamus vel ante ac velit congue tincidunt. Suspendisse potenti. Praesent sed nisl gravida, volutpat enim id, molestie risus. Mauris nec elit rhoncus nunc porttitor sodales. Proin gravida, sem eleifend maximus scelerisque, ipsum turpis elementum diam, eget lacinia quam sem in arcu. Maecenas nec elit vel nisi lacinia iaculis at hendrerit diam. Maecenas lobortis dui vitae dolor gravida ultricies. Integer pretium est lacus, in accumsan tortor convallis sed. Phasellus ornare nisl sit amet risus ultrices, nec vulputate libero vehicula. Mauris iaculis euismod erat vel molestie. Donec molestie tincidunt arcu vel mattis. Cras elementum tempus tellus non fringilla. Curabitur varius erat eget quam blandit porttitor. Nunc tincidunt justo vel turpis interdum, vel congue turpis molestie. In ante felis, gravida vel porta non, ultricies quis est. Suspendisse commodo faucibus felis, at dignissim odio egestas nec.
+</p>
+<p>Aliquam gravida nunc a tristique imperdiet. Donec ac suscipit turpis, in placerat lorem. Cras tellus dui, porttitor vel ultrices quis, euismod quis libero. Phasellus semper nunc turpis, non fermentum ligula tempus eu. Quisque id dui in nisi vestibulum sodales non ac lectus. Etiam augue dui, mattis et placerat rhoncus, pulvinar at magna. Vivamus rhoncus mollis tellus, in auctor lacus consectetur pharetra. Proin feugiat faucibus mi, quis tincidunt lacus lacinia sed. Suspendisse condimentum magna non urna blandit, nec ultricies quam tempor. Aenean eu nunc ac felis eleifend tincidunt eget vitae mi. Sed convallis quis lectus eu hendrerit. Aliquam erat volutpat. Suspendisse efficitur sem quis suscipit egestas.
+</p>
+<p>Nulla egestas quam a volutpat luctus. Donec tincidunt ex ut libero fermentum, quis vulputate nunc fringilla. Nam tempor dignissim lacus, et maximus neque accumsan in. Quisque nec neque porttitor, faucibus mi eget, dapibus nisi. Praesent fringilla, tortor aliquet feugiat euismod, turpis erat eleifend dui, non ultricies lacus mi ut orci. Pellentesque imperdiet vestibulum leo. Ut vitae tristique enim, a finibus ipsum. Nulla commodo metus metus. Curabitur lorem nibh, egestas sed leo quis, finibus rhoncus massa.
+</p>
+<p>Etiam tempor mauris id erat vulputate dignissim. Aliquam erat volutpat. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Integer aliquet in purus a laoreet. Nam tincidunt consectetur nisi, nec lacinia tortor mollis quis. Mauris pretium, nisl id imperdiet dictum, elit sem pellentesque tortor, eu faucibus neque ipsum in turpis. Quisque nibh nisi, facilisis eu dignissim sit amet, scelerisque vel purus. Phasellus ullamcorper eu leo quis maximus. Nullam vitae augue rutrum, pellentesque ex sit amet, bibendum purus. Cras sed leo ipsum. Morbi nibh est, rutrum nec convallis et, ultrices quis lorem. Maecenas maximus nisi non nisi ultrices maximus.
+</p>
+<p>Nunc a accumsan est. Morbi placerat lorem et dui molestie, ut pharetra massa mollis. Aenean molestie urna sed dignissim varius. Aliquam erat volutpat. Integer scelerisque, odio a aliquet tincidunt, ex felis volutpat est, id elementum lectus libero id tellus. Aenean non odio quis est rutrum faucibus eget in lorem. Suspendisse potenti. In pretium elit ac congue tincidunt. Vivamus sed sem at nibh fermentum accumsan.
+</p>
+<p>Etiam lacinia sit amet nisl ornare blandit. Nullam ullamcorper aliquet dictum. Suspendisse mauris quam, maximus eu molestie vitae, dapibus fermentum sapien. Fusce mi lectus, consectetur a nunc eget, porta sagittis diam. Vestibulum ac ex id lectus fermentum dictum et in dui. Nulla faucibus pellentesque mi, sit amet ultricies tortor feugiat eu. Suspendisse gravida pellentesque magna. Donec eu mauris diam.
+</p>
+<p>Cras fringilla nisl a tempor venenatis. Nulla ut magna sed metus pretium convallis. Vivamus volutpat ac lectus vel pulvinar. Aliquam dignissim, tortor non fringilla tincidunt, eros erat sodales orci, consequat elementum elit mi sed elit. Donec pharetra rhoncus purus a iaculis. In quis lacus quis nisl facilisis volutpat at in nulla. Fusce a tincidunt velit. Integer eget urna nibh.
+</p>
+<p>Phasellus ac justo lacus. Vestibulum ut pulvinar nunc, et pellentesque urna. Nam venenatis magna eget tortor aliquam dapibus. Vivamus id arcu vitae tortor egestas semper. Maecenas mollis at augue id bibendum. Mauris lobortis velit id enim efficitur vestibulum. Pellentesque at est a odio blandit pretium. Proin nec ornare sem, vel ornare felis.
+</p>
+<p>Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. In leo leo, tempor a finibus eu, placerat vel sapien. Nullam nisl augue, tempor ultricies dictum eu, ultricies nec nisi. Nam nibh sapien, porta vel dignissim ac, laoreet nec ligula. Praesent luctus, dui a bibendum placerat, ipsum ex venenatis nulla, eu congue erat justo quis nulla. Nulla est nunc, blandit ac purus nec, ullamcorper pharetra tortor. Aenean lobortis enim non orci rhoncus venenatis. Cras vel metus in nulla porta bibendum ut quis urna. Fusce non ex ac nisi facilisis porta. Etiam vel tellus in lorem porttitor maximus at eget erat. Ut interdum, elit a facilisis hendrerit, neque tellus sodales nisl, at ultrices augue ex sit amet urna.
+</p>
+<p>Donec ornare lorem erat, quis mollis nisl dignissim blandit. Nunc scelerisque, turpis a pellentesque laoreet, arcu massa dictum nisl, sit amet egestas lacus dolor et odio. In metus mauris, venenatis ac odio quis, porttitor cursus eros. Fusce pellentesque consequat congue. Nullam iaculis ipsum in ipsum lobortis efficitur. In et mauris augue. Cras eu faucibus justo. Integer hendrerit gravida massa, non auctor purus efficitur ac. Pellentesque non lorem massa. Aliquam vitae tincidunt risus. Fusce et elit eget ex ullamcorper cursus ac nec quam. Vestibulum cursus mauris vitae ipsum sagittis tempor. Ut eleifend ligula in elementum hendrerit. Vivamus malesuada aliquam placerat.
+</p>
+<p>Fusce pharetra ligula id scelerisque tristique. Interdum et malesuada fames ac ante ipsum primis in faucibus. Cras commodo sagittis neque et vulputate. Curabitur erat est, pulvinar ac semper id, euismod vitae elit. Proin ut dolor semper, suscipit ipsum eget, molestie arcu. Sed sodales mauris nulla, ullamcorper cursus nunc malesuada sit amet. Proin sed condimentum orci. Suspendisse aliquam sem ac purus dictum commodo. Nullam ultricies sapien elit, eget mollis elit porta sit amet. Nulla fermentum, mi porta consequat malesuada, metus dui commodo ante, eu vestibulum arcu erat at tortor. Phasellus dolor nunc, cursus ultrices vestibulum vel, rhoncus auctor ante. Quisque consectetur sed ligula non tempus. Pellentesque faucibus est vitae quam sodales tristique. Proin et fringilla quam, sed faucibus enim. Ut convallis, urna eu condimentum scelerisque, magna tellus iaculis sem, sed rhoncus leo purus a nulla.
+</p>
+<p>Morbi tellus lacus, tempus in orci ac, molestie lobortis neque. Fusce pretium ex nec erat faucibus congue ut a lorem. Morbi a pretium justo. Donec interdum elit vitae blandit tincidunt. Proin nisi magna, imperdiet id accumsan id, maximus vel risus. Nunc quis fermentum est. Nam at nibh ac ipsum tincidunt viverra eget tincidunt massa. Nam convallis metus tortor. Aenean at tincidunt lacus.
+</p>
+<p>Cras ultricies iaculis massa et commodo. Suspendisse efficitur magna purus, id egestas tellus consectetur eu. Nullam ante sapien, mollis sit amet purus sed, volutpat consequat tortor. Cras pharetra tincidunt gravida. Suspendisse non ante iaculis, mattis metus id, elementum metus. Nam elementum suscipit lectus, eget laoreet dui aliquet nec. Cras nec enim vel nulla blandit maximus sed ut elit. Fusce malesuada augue efficitur quam sollicitudin ornare in sit amet velit. Maecenas fringilla scelerisque quam non suscipit. Curabitur nisl velit, commodo ut pretium ut, dictum nec orci. Maecenas quis est interdum, pellentesque erat in, porttitor lacus. In quis nisl luctus, luctus mauris at, condimentum quam. Fusce laoreet quam nec massa pulvinar, et ultricies sem semper.
+</p>

package/test/runner.js

@@ -0,0 +1,74 @@
+import path from "path";
+import {spawn, execSync} from "child_process";
+
+let testServerProcess;
+
+export function runTestServer() {
+  if (testServerProcess)
+    return;
+
+  testServerProcess =
+    spawn("node", [path.join(process.cwd(), "test", "start-server.js")]);
+
+  return new Promise((resolve, reject) => {
+    function onData(data) {
+      console.log(data.toString()); // eslint-disable-line no-console
+
+      let testServerStarted = data.includes("listening at");
+      if (testServerStarted)
+        resolve();
+    }
+
+    function onClose(code) {
+      if (code != 0)
+        reject(new Error("Failed to start test server"));
+    }
+
+    testServerProcess.stderr.on("data", onData);
+    testServerProcess.stdout.on("data", onData);
+    testServerProcess.on("close", onClose);
+  });
+}
+
+export async function killTestServer() {
+  if (!testServerProcess)
+    return;
+
+  await new Promise((resolve, reject) => {
+    let timeoutID = setTimeout(() => {
+      reject(new Error("Could not stop test server"));
+    }, 5000);
+
+    function onClose() {
+      testServerProcess.off("close", onClose);
+      resolve();
+      clearTimeout(timeoutID);
+    }
+
+    testServerProcess.on("close", onClose);
+    testServerProcess.kill("SIGKILL");
+  });
+
+  testServerProcess = null;
+}
+
+async function run() {
+  let args = process.argv.join(" ").split("-- ")[1];
+  await runTestServer();
+  try {
+    execSync(`npm run test-suite -- ${args}`, {stdio: "inherit"});
+  }
+  finally {
+    await killTestServer();
+  }
+}
+
+(async() => {
+  try {
+    await run();
+  }
+  catch (err) {
+    console.error(err instanceof Error ? err.stack : `Error: ${err}`);
+    process.exit(1);
+  }
+})();