Class Browser

javascript/selenium-webdriver/bidi/browser.js:24–102

* Represents the commands and events under Browser Module. * Described in https://w3c.github.io/webdriver-bidi/#module-browser

 * Described in https://w3c.github.io/webdriver-bidi/#module-browser
 */
class Browser {
  constructor(driver) {
    this._driver = driver
  }

  async init() {
    if (!(await this._driver.getCapabilities()).get('webSocketUrl')) {
      throw Error('WebDriver instance must support BiDi protocol')
    }

    this.bidi = await this._driver.getBidi()
  }

  /**
   * Creates a new user context.
   * @returns {Promise<string>} A promise that resolves to the user context id.
   */
  async createUserContext() {
    const command = {
      method: 'browser.createUserContext',
      params: {},
    }

    let response = await this.bidi.send(command)

    return response.result.userContext
  }

  /**
   * Gets the list of all user contexts.
   * @returns {Promise<string[]>} A promise that resolves to an array of user context ids.
   */
  async getUserContexts() {
    const command = {
      method: 'browser.getUserContexts',
      params: {},
    }

    let response = await this.bidi.send(command)

    let userContexts = []

    let userContextsArray = response.result.userContexts

    for (let userContextJson of userContextsArray) {
      userContexts.push(userContextJson.userContext)
    }

    return userContexts
  }

  /**
   * Removes a user context.
   * @param {string} userContext The user context id to be removed.
   * @returns {Promise<void>}
   */
  async removeUserContext(userContext) {
    const command = {