@open-xchange/appsuite-codeceptjs 0.1.0

package/.env.defaults

@@ -0,0 +1,47 @@
+# Default environment variables
+#
+# Do not edit this file, instead create a .env file in the root directory!
+
+# CONTEXT_ID only needs to be set for local development
+# CONTEXT_ID=
+
+# Admin credentials for e2e middleware
+# PROVISIONING_USER=
+# PROVISIONING_PASSWORD=
+
+# SMTP and IMAP server for e2e-tests
+SMTP_SERVER=main-asbox-postfix
+IMAP_SERVER=main-asbox-dovecot
+
+# Number of maximum retries of e2e-test runs and minimal successful e2e-test runs
+MIN_SUCCESS=1
+MAX_RERUNS=1
+
+# URL to the App Suite Middleware for e2e-provisioning via SOAP
+PROVISIONING_URL=https://appsuite-main.dev.oxui.de/
+
+# URL to the App Suite UI for e2e-tests
+LAUNCH_URL=https://core-ui-main.dev.oxui.de
+
+# MX domain for e2e-tests
+MX_DOMAIN=box.ox.io
+
+# API used for e2e user provisioning (common/reseller)
+PROVISIONING_API=common
+
+# Default timeout for all wait operations for e2e tests in ms
+WAIT_TIMEOUT=5000
+
+# Run test headless or in chrome (Must be true for CI)
+HEADLESS=true
+
+# Test metrics plugin configuration
+E2E_TEST_METRICS_CLIENT=
+E2E_TEST_METRICS_TOKEN=
+
+# Path to the chrome binary
+CHROME_BIN=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
+
+# See https://peter.sh/experiments/chromium-command-line-switches
+CHROME_ARGS=
+# CHROME_ARGS: '--disable-accelerated-2d-canvas --no-zygote --single-process'

package/README.md

@@ -0,0 +1,40 @@
+# Open-Xchange App Suite: CodeceptJS
+
+This module contains appsuite specific configuration, helpers, page objects and actors for Open-Xchange App Suite.
+
+## Configuration
+
+Basic config
+
+    // inside codecept.conf.js
+
+    module.exports.config = {
+    'helpers': {
+      // other helpers...
+          AppSuite: {
+            require: './node_modules/@open-xchange/appsuite-codeceptjs/src/helper',
+        // AppSuite helpers and actors rely on users array provided via config
+        users: [{
+          username: 'testuser1',
+          password: 'ultimatelySecure',
+          mail: 'testuser1@example.com'
+        }]
+          }
+      },
+      'include': {
+          'I': './node_modules/@open-xchange/appsuite-codeceptjs/src/actor'
+      },
+    };
+
+If you want to have other actor functions bound to the I object, you can extend our actor in another file as follows:
+
+    // inside actor.js
+
+    module.exports = function () {
+    const {actor} = require('@open-xchange/appsuite-codeceptjs');
+    return actor({
+      customFunction: function () {
+        // do custom stuff
+      }
+    });
+  };

package/chai.d.ts

@@ -0,0 +1,5 @@
+declare module Chai {
+  interface Assertion {
+    accessible: void;
+  }
+}

package/customRerun.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { event, container, output, Codecept } = require('codeceptjs')
+// @ts-ignore
+const { getConfig, printError } = require('codeceptjs/lib/command/utils')
+const fsPath = require('node:path')
+class CodeceptRerunner extends Codecept {
+  constructor (config, options) {
+    super(config, options)
+    // @ts-ignore
+    this.configRerun = this.config.rerun || {}
+    this.minSuccess = this.configRerun.minSuccess || 1
+    this.maxReruns = this.configRerun.maxReruns || 1
+    this.successCounter = 0
+    this.rerunsCounter = 0
+    this.testSuccessCounter = {}
+  }
+
+  async runOnce (test) {
+    // @ts-ignore
+    container.createMocha()
+    const mocha = container.mocha()
+    // @ts-ignore
+    this.testFiles.forEach((file) => {
+      delete require.cache[file]
+    })
+    // @ts-ignore
+    mocha.files = this.testFiles
+    if (test) {
+      if (!fsPath.isAbsolute(test)) {
+        // @ts-ignore
+        test = fsPath.join(codecept_dir, test)
+      }
+      mocha.files = mocha.files.filter(t => fsPath.basename(t, '.js') === test || t === test)
+    }
+    await new Promise(resolve => mocha.loadFiles(resolve))
+    mocha.suite.suites.forEach(suite => {
+      suite.tests = suite.tests.filter(test => {
+        return !this.lastRun ||
+                this.lastRun[test.fullTitle()] === 'failed' ||
+                (this.lastRun[test.fullTitle()] === 'passed' && this.testSuccessCounter[test.fullTitle()] < this.minSuccess)
+      })
+    })
+    const failures = await new Promise(resolve => mocha.run(resolve))
+    this.lastRun = {}
+    mocha.suite.suites.forEach((suite) => {
+      suite.tests.forEach(test => {
+        this.lastRun[test.fullTitle()] = (test?.state === 'passed' && 'passed') || 'failed'
+        if (test.state === 'passed') {
+          this.testSuccessCounter[test.fullTitle()] = this.testSuccessCounter[test.fullTitle()] ? this.testSuccessCounter[test.fullTitle()] + 1 : 1
+        }
+      })
+    })
+    if (failures > 0) {
+      throw new Error(`${failures} tests fail`)
+    }
+  }
+
+  async runTests (test) {
+    if (this.minSuccess > this.maxReruns) throw new Error('minSuccess must be less than maxReruns')
+    if (this.maxReruns === 1) {
+      await this.runOnce(test)
+      return
+    }
+    while (this.rerunsCounter < this.maxReruns && this.successCounter < this.minSuccess) {
+      this.rerunsCounter++
+      try {
+        await this.runOnce(test)
+        this.successCounter++
+        output.success(`\nProcess run ${this.rerunsCounter} of max ${this.maxReruns}, success runs ${this.successCounter}/${this.minSuccess}\n`)
+      } catch (e) {
+        output.error(`\nFail run ${this.rerunsCounter} of max ${this.maxReruns}, success runs ${this.successCounter}/${this.minSuccess} \n`)
+      }
+    }
+    if (this.successCounter < this.minSuccess) {
+      throw new Error(`Flaky tests detected! ${this.successCounter} success runs achieved instead of ${this.minSuccess} success runs expected`)
+    }
+  }
+
+  async run (test) {
+    event.emit(event.all.before, this)
+    try {
+      await this.runTests(test)
+    } finally {
+      event.emit(event.all.result, this)
+      event.emit(event.all.after, this)
+    }
+    try {
+      await this.teardown()
+    } catch (err) {
+      // silently ignore errors
+    }
+  }
+}
+
+;(async () => {
+  const codeceptDir = process.cwd()
+  const conf = getConfig(codeceptDir)
+  const [test] = process.argv.slice(2)
+  // parse --grep option in all variations
+  const fgrep = test === '--grep' ? process.argv[3] : (test || '').replace(/^--grep=?\s?/, '')
+  const customRunner = new CodeceptRerunner(conf, { fgrep, colors: true, reporter: 'mocha-multi' })
+  customRunner.init(codeceptDir)
+
+  try {
+    await customRunner.bootstrap()
+    customRunner.loadTests()
+    // run tests
+    await customRunner.run()
+    process.exitCode = 0
+  } catch (err) {
+    printError(err)
+    process.exitCode = 1
+  }
+})()

package/global.d.ts

@@ -0,0 +1,5 @@
+// IMPORTANT: This solution only works by declaring variables with var (do not use let or const)
+var expect: Chai.ExpectStatic;
+var assert: Chai.AssertStatic;
+const codecept_dir: string;
+const output_dir: string;

package/index.js

@@ -0,0 +1,187 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+require('@open-xchange/appsuite-codeceptjs/src/chai')
+const dotenv = require('dotenv')
+dotenv.config({ path: '.env' })
+dotenv.config({ path: '.env.defaults' })
+
+const requiredEnvVars = ['LAUNCH_URL', 'PROVISIONING_URL', 'CONTEXT_ID']
+
+requiredEnvVars.forEach(function notdefined (key) {
+  if (process.env[key]) return
+  console.error('\x1b[31m', `ERROR: Missing value for environment variable '${key}'. Please specify a '.env' file analog to '.env-example'.`)
+  process.exit()
+})
+
+module.exports = {
+  util: require('./src/util'),
+  event: require('./src/event'),
+  config: {
+    tests: './tests/**/*_test.js',
+    timeout: Number(process.env.TEST_TIMEOUT) || 120,
+    output: './output/',
+    helpers: {
+      Playwright: {
+        timeout: 10000,
+        waitForTimeout: 10000,
+        browser: 'chromium',
+        chromium: {
+          args: [
+            '--disable-print-preview',
+            '--disable-crash-reporter',
+            '--disable-dev-shm-usage',
+            '--disable-features=IsolateOrigins',
+            '--disable-gpu',
+            '--disable-notifications', // to disable native notification window on Mac OS,
+            '--disable-print-preview',
+            '--disable-setuid-sandbox',
+            '--disable-site-isolation-trials',
+            '--disable-web-security',
+            '--no-first-run',
+            '--no-sandbox',
+            '--no-zygote'
+          ]
+        },
+        url: process.env.LAUNCH_URL,
+        show: process.env.HEADLESS === 'false',
+        trace: process.env.TRACE === 'true',
+        restart: true // this is needed to be able to switch browsers in tests
+      },
+      AppSuite: {
+        require: '@open-xchange/appsuite-codeceptjs/src/helper',
+        mxDomain: process.env.MX_DOMAIN,
+        serverURL: process.env.PROVISIONING_URL,
+        contextId: process.env.CONTEXT_ID,
+        filestoreId: process.env.FILESTORE_ID,
+        smtpServer: process.env.SMTP_SERVER,
+        imapServer: process.env.IMAP_SERVER,
+        loginTimeout: 30,
+        admin: {
+          login: process.env.E2E_ADMIN_USER,
+          password: process.env.E2E_ADMIN_PW
+        }
+      }
+    },
+    include: {
+      I: '@open-xchange/appsuite-codeceptjs/src/actor',
+      users: '@open-xchange/appsuite-codeceptjs/src/users',
+      contexts: '@open-xchange/appsuite-codeceptjs/src/contexts',
+      // pageobjects
+      contacts: '@open-xchange/appsuite-codeceptjs/src/pageobjects/contacts',
+      calendar: '@open-xchange/appsuite-codeceptjs/src/pageobjects/calendar',
+      mail: '@open-xchange/appsuite-codeceptjs/src/pageobjects/mail',
+      drive: '@open-xchange/appsuite-codeceptjs/src/pageobjects/drive',
+      tasks: '@open-xchange/appsuite-codeceptjs/src/pageobjects/tasks',
+      // fragments
+      dialogs: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/dialogs',
+      autocomplete: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/contact-autocomplete',
+      contactpicker: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/contact-picker',
+      mailfilter: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/settings-mailfilter',
+      search: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/search',
+      tinymce: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/tinymce',
+      topbar: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/topbar',
+      settings: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/settings',
+      viewer: '@open-xchange/appsuite-codeceptjs/src/pageobjects/fragments/viewer',
+      mobileCalendar: '@open-xchange/appsuite-codeceptjs/src/pageobjects/mobile/mobileCalendar',
+      mobileMail: '@open-xchange/appsuite-codeceptjs/src/pageobjects/mobile/mobileMail',
+      mobileContacts: '@open-xchange/appsuite-codeceptjs/src/pageobjects/mobile/mobileContacts'
+    },
+    async bootstrap () {
+      // set moment defaults
+      // note: no need to require moment-timezone later on. requiring moment is enough
+      const moment = require('moment')
+      require('moment-timezone')
+      moment.tz.setDefault('Europe/Berlin')
+
+      const codecept = require('codeceptjs')
+
+      const config = codecept.config.get()
+      const helperConfig = config.helpers.AppSuite
+
+      const contexts = codecept.container.support('contexts')
+
+      const testRunContext = await contexts.create()
+      if (typeof testRunContext.id !== 'undefined') helperConfig.contextId = testRunContext.id
+    },
+    async teardown () {
+      const { contexts } = global.inject()
+      // we need to run this sequentially, less stress on the MW
+      for (const ctx of contexts.filter(ctx => ctx.id > 100)) {
+        if (ctx.id !== 10) await ctx.remove().catch(e => console.error(e.message))
+      }
+    },
+    reporter: 'mocha-multi',
+    mocha: {
+      reporterOptions: {
+        'codeceptjs-cli-reporter': {
+          stdout: '-'
+        },
+        'mocha-junit-reporter': {
+          stdout: '-',
+          options: {
+            jenkinsMode: true,
+            mochaFile: './output/junit.xml',
+            attachments: false // add screenshot for a failed test
+          }
+        }
+      }
+    },
+    plugins: {
+      allure: {
+        enabled: true,
+        require: 'allure-codeceptjs',
+        outputDir: './output'
+      },
+      testMetrics: {
+        require: '@open-xchange/appsuite-codeceptjs/src/plugins/testmetrics',
+        url: 'https://e2e-metrics.dev.oxui.de',
+        org: 'e2e',
+        defaultTags: {
+          client: process.env.E2E_TEST_METRICS_CLIENT || (process.env.CI && 'CI'),
+          pipelineId: process.env.CI_PIPELINE_ID,
+          branch: process.env.CI_COMMIT_REF_NAME,
+          project: process.env.CI_PROJECT_PATH
+        },
+        token: process.env.E2E_TEST_METRICS_TOKEN,
+        enabled: true
+      },
+      settingsInit: {
+        require: '@open-xchange/appsuite-codeceptjs/src/plugins/settingsInit',
+        enabled: true
+      },
+      customizePlugin: {
+        require: process.env.CUSTOMIZE_PLUGIN || '@open-xchange/appsuite-codeceptjs/src/plugins/emptyModule',
+        enabled: true
+      },
+      filterSuite: {
+        enabled: !process.env.E2E_GREP && process.env.CI && (process.env.SUITE_SERVICE_URL || process.env.FILTER_SUITE),
+        require: '@open-xchange/codecept-horizontal-scaler',
+        suiteFilePath: process.env.FILTER_SUITE,
+        filterFn: process.env.runOnly === 'true' ? () => false : undefined,
+        nodePrefix: 'core-ui'
+      }
+    },
+    rerun: {
+      minSuccess: Number(process.env.MIN_SUCCESS),
+      maxReruns: Number(process.env.MAX_RERUNS)
+    }
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@open-xchange/appsuite-codeceptjs",
+  "version": "0.1.0",
+  "description": "OX App Suite CodeceptJS Configuration and Helpers",
+  "main": "index.js",
+  "bin": {
+    "e2e-rerun": "./customRerun.js"
+  },
+  "repository": "https://gitlab.open-xchange.com/frontend/codecept-helpers.git",
+  "license": "AGPL-3.0-or-later",
+  "private": false,
+  "dependencies": {
+    "@axe-core/playwright": "^4.8.5",
+    "@codeceptjs/helper": "^2.0.3",
+    "@influxdata/influxdb-client": "^1.33.2",
+    "@open-xchange/codecept-horizontal-scaler": "^0.1.7",
+    "@playwright/test": "^1.40.1",
+    "@types/node": "^20.11.19",
+    "allure-codeceptjs": "^2.12.2",
+    "chai": "^5.1.0",
+    "chai-subset": "^1.6.0",
+    "chalk": "^4.1.0",
+    "chalk-table": "^1.0.2",
+    "codeceptjs": "^3.5.14",
+    "dotenv": "^16.4.4",
+    "mocha": "^10.3.0",
+    "mocha-junit-reporter": "^2.2.1",
+    "mocha-multi": "^1.1.7",
+    "moment": "^2.30.1",
+    "moment-timezone": "^0.5.43",
+    "p-retry": "^6.2.0",
+    "playwright-core": "^1.40.1",
+    "playwright": "^1.40.1",
+    "short-uuid": "^4.2.2",
+    "soap": "^1.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}

package/src/actor.js

@@ -0,0 +1,174 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { platform } = require('node:process')
+const { expect } = require('@playwright/test')
+const util = require('./util')
+const codecept = require('codeceptjs')
+
+const baseURL = util.getURLRoot()
+
+module.exports = function () {
+  return actor({
+
+    amOnLoginPage () {
+      this.amOnPage(baseURL)
+    },
+
+    openApp (appName) {
+      this.click('~Navigate to:')
+      this.click(appName, '.apps')
+    },
+
+    /**
+     * This simplifies the input of mail addresses into input fields.
+     * There must be an array of users defined in the AppSuite helper configuration.
+     * If you want to fill in a mailaddress of such a user you can simply use this function.
+     *
+     * @param selector {string} the selector of an editable field
+     * @param userIndex {number} the users position in the users array provided via helper config
+     */
+    insertMailaddress (selector, userIndex) {
+      const config = codecept.config.get()
+      const users = config.helpers.AppSuite.users
+      if (userIndex < 0 || userIndex >= users.length) userIndex = 0
+      const user = users[userIndex]
+      this.fillField(selector, user.mail)
+    },
+
+    /**
+     * Logs in the user with the specified URL parameters and options.
+     * If the URL parameters are an object, it will be converted to an empty array.
+     * The options parameter is an object that can contain a 'user' property.
+     * If the 'user' property is not provided, the first user from the 'users' container will be used.
+     * The login process includes making an API request to the login endpoint with the user's credentials.
+     * After successful login, the page will be navigated to the specified URL with the URL parameters.
+     * If the 'isDeepLink' option is true, the URL will be constructed with a '#' prefix.
+     * The login process also includes waiting for the page to load and checking for the presence of the app.
+     * @param {string[]|object} urlParams - The URL parameters as an array or object.
+     * @param {object} options - The login options.
+     * @returns {Promise<void>} - A promise that resolves when the login process is complete.
+     */
+    async login (urlParams, options) {
+      if (urlParams && !urlParams.length) {
+        // looks like an object, not string or array
+        options = urlParams
+        urlParams = []
+      }
+      urlParams = [].concat(urlParams || [])
+      options = Object.assign({ wait: true }, options)
+      let user = options.user || require('codeceptjs').container.support('users')[0]
+
+      if (typeof user === 'undefined') user = {}
+      if (user.toJSON) user = user.toJSON()
+      const loginName = process.env.PROVISIONING_API === 'reseller' ? user.name : `${user.name}${user.context.id ? '@' + user.context.id : ''}`
+      await this.makeApiRequest('POST', `${baseURL}/api/login`, {
+        params: { action: 'login', client: 'open-xchange-appsuite' },
+        form: {
+          name: loginName,
+          password: user.password
+        }
+      })
+      this.wait(0.5)
+      this.amOnPage(`${baseURL}/` + (options.isDeepLink ? '#' : '#!!') + (urlParams.length === 0 ? '' : '&' + urlParams.join('&')))
+      this.waitForInvisible('#background-loader.busy', util.getLoginTimeout())
+      if (options.wait) await this.waitForApp()
+    },
+
+    async logout () {
+      await this.makeApiRequest('POST', `${baseURL}/api/login`, { params: { action: 'logout' } })
+      this.amOnPage('about:blank')
+    },
+
+    waitForNetworkTraffic () {
+      this.waitForDetached({ css: '[aria-label="Currently refreshing"]' }, 15)
+    },
+
+    // Wait for focus in playwright
+    /**
+     * Waits for the specified element to receive focus.
+     *
+     * @param {string} locator - The locator of the element. Only accepts css selectors.
+     */
+    waitForFocus (locator) {
+      this.waitForElement(locator)
+      this.waitForVisible(locator)
+      return this.usePlaywrightTo('wait for focus', async ({ page }) => {
+        await expect(page.locator(locator)).toBeFocused()
+        this.wait(0.5)
+      })
+    },
+
+    triggerRefresh () {
+      this.waitForVisible('~Refresh')
+      this.click('~Refresh')
+      this.waitForInvisible('~Currently refreshing', 10)
+      this.waitForVisible('~Refresh')
+    },
+
+    grabBackgroundImageFrom (selector) {
+      return this.grabCssPropertyFrom(selector, 'background-image').then(backgroundImage => {
+        backgroundImage = Array.isArray(backgroundImage) ? backgroundImage[0] : backgroundImage
+        return backgroundImage || 'none'
+      })
+    },
+
+    clickDropdown (text) {
+      this.waitForVisible('.dropdown.open .dropdown-menu, .primary-action > .open .dropdown-menu')
+      this.waitForText(text, 10, '.dropdown.open .dropdown-menu, .primary-action > .open .dropdown-menu')
+      return this.click(text, '.dropdown.open .dropdown-menu, .primary-action > .open .dropdown-menu')
+    },
+
+    clickToolbar (selector, timeout = 5) {
+      this.waitForElement(`.classic-toolbar [aria-label^="${selector}"]`, timeout)
+      this.click(`~${selector}`, '.classic-toolbar')
+    },
+
+    clickPrimary (text) {
+      const button = locate('.primary-action .btn-primary').withText(text).as(`Primary Button: ${text}`)
+      this.waitForVisible(button)
+      this.click(button)
+    },
+
+    openFolderMenu (folderName) {
+      const item = `.folder-tree [title*="${folderName}"]`
+      this.waitForVisible(item)
+      this.rightClick(item)
+    },
+
+    changeTheme ({ theme }) {
+      // "White" "Blue" "Steel gray" "Dark" "Mountains" "Beach" "City" "Blue Sunset"
+      this.click('[aria-label="Settings"]')
+      this.waitForVisible('#topbar-settings-dropdown')
+      this.click(`div[aria-label="Themes"] a[title="${theme}"]`)
+      this.waitForNetworkTraffic()
+      this.pressKey('Escape')
+      this.wait(0.5)
+    },
+
+    /**
+     * Selects the text in a text field or contenteditable element from cursor position to beginning of line.
+     */
+    selectLine () {
+      const shortcut = platform === 'darwin' ? ['Shift', 'CommandOrControl', 'ArrowLeft'] : ['Shift', 'Home']
+      this.pressKey(shortcut)
+    }
+  })
+}