selenium-webdriver 4.14.0 → 4.15.0

package/CHANGES.md

@@ -1,3 +1,19 @@
+## 4.15.0
+
+#### :bug: Bug fix
+
+* Replace calls to console.log with managed loggers (#12909)
+
+#### :nail_care: Polish
+
+* Add CDP v119 and remove v116
+
+#### :rocket: New Feature
+
+* Add BiDi captureScreenshot command (#12510)
+* Add BiDi browsing context activate command, handle user prompt command and reload command
+* Add BiDi browsing context commands and events (#13078)
+
 ## 4.14.0
 
 #### :nail_care: Polish

package/bidi/browsingContext.js

@@ -15,6 +15,7 @@
 // specific language governing permissions and limitations
 // under the License.
 
+const { InvalidArgumentError, NoSuchFrameError } = require('../lib/error')
 const { BrowsingContextInfo } = require('./browsingContextTypes')
 class BrowsingContext {
   constructor(driver) {
@@ -165,6 +166,149 @@ class BrowsingContext {
     const response = await this.bidi.send(params)
     return new PrintResult(response.result.data)
   }
+
+  async captureScreenshot() {
+    let params = {
+      method: 'browsingContext.captureScreenshot',
+      params: {
+        context: this._id,
+      },
+    }
+
+    const response = await this.bidi.send(params)
+    this.checkErrorInScreenshot(response)
+    return response['result']['data']
+  }
+
+  async captureBoxScreenshot(x, y, width, height) {
+    let params = {
+      method: 'browsingContext.captureScreenshot',
+      params: {
+        context: this._id,
+        clip: {
+          type: 'viewport',
+          x: x,
+          y: y,
+          width: width,
+          height: height,
+        },
+      },
+    }
+
+    const response = await this.bidi.send(params)
+    this.checkErrorInScreenshot(response)
+    return response['result']['data']
+  }
+
+  async captureElementScreenshot(
+    sharedId,
+    handle = undefined,
+    scrollIntoView = undefined
+  ) {
+    let params = {
+      method: 'browsingContext.captureScreenshot',
+      params: {
+        context: this._id,
+        clip: {
+          type: 'element',
+          element: {
+            sharedId: sharedId,
+            handle: handle,
+          },
+          scrollIntoView: scrollIntoView,
+        },
+      },
+    }
+
+    const response = await this.bidi.send(params)
+    this.checkErrorInScreenshot(response)
+    return response['result']['data']
+  }
+
+  checkErrorInScreenshot(response) {
+    if ('error' in response) {
+      const { error, msg } = response
+
+      switch (error) {
+        case 'invalid argument':
+          throw new InvalidArgumentError(msg)
+
+        case 'no such frame':
+          throw new NoSuchFrameError(msg)
+      }
+    }
+  }
+
+  async activate() {
+    const params = {
+      method: 'browsingContext.activate',
+      params: {
+        context: this._id,
+      },
+    }
+
+    let result = await this.bidi.send(params)
+    if ('error' in result) {
+      throw Error(result['error'])
+    }
+  }
+
+  async handleUserPrompt(accept = undefined, userText = undefined) {
+    const params = {
+      method: 'browsingContext.handleUserPrompt',
+      params: {
+        context: this._id,
+        accept: accept,
+        userText: userText,
+      },
+    }
+
+    let result = await this.bidi.send(params)
+    if ('error' in result) {
+      throw Error(result['error'])
+    }
+  }
+
+  async reload(ignoreCache = undefined, readinessState = undefined) {
+    if (
+      readinessState !== undefined &&
+      !['none', 'interactive', 'complete'].includes(readinessState)
+    ) {
+      throw Error(
+        `Valid readiness states are 'none', 'interactive' & 'complete'. Received: ${readinessState}`
+      )
+    }
+
+    const params = {
+      method: 'browsingContext.reload',
+      params: {
+        context: this._id,
+        ignoreCache: ignoreCache,
+        wait: readinessState,
+      },
+    }
+    const navigateResult = (await this.bidi.send(params))['result']
+
+    return new NavigateResult(
+      navigateResult['url'],
+      navigateResult['navigation']
+    )
+  }
+
+  async setViewport(width, height, devicePixelRatio = undefined) {
+    const params = {
+      method: 'browsingContext.setViewport',
+      params: {
+        context: this._id,
+        viewport: { width: width, height: height },
+        devicePixelRatio: devicePixelRatio,
+      },
+    }
+    let result = await this.bidi.send(params)
+    if ('error' in result) {
+      throw Error(result['error'])
+    }
+  }
 }
 
 class NavigateResult {

package/bidi/browsingContextInspector.js

@@ -37,6 +37,34 @@ class BrowsingContextInspector {
     )
   }
 
+  async onNavigationStarted(callback) {
+    await this.subscribeAndHandleEvent(
+      'browsingContext.navigationStarted',
+      callback
+    )
+  }
+
+  async onFragmentNavigated(callback) {
+    await this.subscribeAndHandleEvent(
+      'browsingContext.fragmentNavigated',
+      callback
+    )
+  }
+
+  async onUserPromptClosed(callback) {
+    await this.subscribeAndHandleEvent(
+      'browsingContext.userPromptClosed',
+      callback
+    )
+  }
+
+  async onUserPromptOpened(callback) {
+    await this.subscribeAndHandleEvent(
+      'browsingContext.userPromptOpened',
+      callback
+    )
+  }
+
   async onDomContentLoaded(callback) {
     await this.subscribeAndHandleEvent(
       'browsingContext.domContentLoaded',

package/common/seleniumManager.js

@@ -26,7 +26,9 @@ const path = require('path')
 const fs = require('fs')
 const spawnSync = require('child_process').spawnSync
 const { Capability } = require('../lib/capabilities')
+const logging = require('../lib/logging')
 
+const log_ = logging.getLogger(logging.Type.DRIVER)
 let debugMessagePrinted = false
 
 /**
@@ -53,7 +55,7 @@ function getBinary() {
   }
 
   if (!debugMessagePrinted) {
-    console.debug(`Selenium Manager binary found at ${filePath}`)
+    log_.debug(`Selenium Manager binary found at ${filePath}`)
     debugMessagePrinted = true // Set the flag to true after printing the debug message
   }
 
@@ -140,10 +142,10 @@ function driverLocation(options) {
 function logOutput(output) {
   for (const key in output.logs) {
     if (output.logs[key].level === 'WARN') {
-      console.warn(`${output.logs[key].message}`)
+      log_.warning(`${output.logs[key].message}`)
     }
     if (['DEBUG', 'INFO'].includes(output.logs[key].level)) {
-      console.debug(`${output.logs[key].message}`)
+      log_.debug(`${output.logs[key].message}`)
     }
   }
 }

package/devtools/CDPConnection.js

@@ -15,6 +15,8 @@
 // specific language governing permissions and limitations
 // under the License.
 
+const logging = require('../lib/logging')
+
 const RESPONSE_TIMEOUT = 1000 * 30
 class CDPConnection {
   constructor(wsConnection) {
@@ -65,7 +67,9 @@ class CDPConnection {
             resolve(payload)
           }
         } catch (err) {
-          console.error(`Failed parse message: ${err.message}`)
+          logging
+            .getLogger(logging.Type.BROWSER)
+            .error(`Failed parse message: ${err.message}`)
         }
       }
 

package/example/logging.js

@@ -27,7 +27,7 @@ const edge = require('../edge')
 const { Builder, By, Key, logging, until } = require('..')
 
 logging.installConsoleHandler()
-logging.getLogger('webdriver.http').setLevel(logging.Level.ALL)
+logging.getLogger(`${logging.Type.DRIVER}.http`).setLevel(logging.Level.ALL)
 ;(async function () {
   let driver
   try {

package/index.js

@@ -194,7 +194,7 @@ function createDriver(ctor, ...args) {
 class Builder {
   constructor() {
     /** @private @const */
-    this.log_ = logging.getLogger('webdriver.Builder')
+    this.log_ = logging.getLogger(`${logging.Type.DRIVER}.Builder`)
 
     /** @private {string} */
     this.url_ = ''

package/lib/http.js

@@ -34,6 +34,8 @@ const { Session } = require('./session')
 const webElement = require('./webelement')
 const { isObject } = require('./util')
 
+const log_ = logging.getLogger(`${logging.Type.DRIVER}.http`)
+
 const getAttribute = requireAtom(
   'get-attribute.js',
   '//javascript/node/selenium-webdriver/lib/atoms:get-attribute.js'
@@ -58,10 +60,10 @@ function requireAtom(module, bazelTarget) {
   } catch (ex) {
     try {
       const file = bazelTarget.slice(2).replace(':', '/')
-      console.log(`../../../bazel-bin/${file}`)
+      log_.log(`../../../bazel-bin/${file}`)
       return require(path.resolve(`../../../bazel-bin/${file}`))
     } catch (ex2) {
-      console.log(ex2)
+      log_.error(ex2)
       throw Error(
         `Failed to import atoms module ${module}. If running in dev mode, you` +
           ` need to run \`bazel build ${bazelTarget}\` from the project` +
@@ -153,8 +155,6 @@ const Atom = {
   FIND_ELEMENTS: findElements,
 }
 
-const LOG = logging.getLogger('webdriver.http')
-
 function post(path) {
   return resource('POST', path)
 }
@@ -428,7 +428,7 @@ class Client {
  *     command to execute.
  */
 function buildRequest(customCommands, command) {
-  LOG.finest(() => `Translating command: ${command.getName()}`)
+  log_.finest(() => `Translating command: ${command.getName()}`)
   let spec = customCommands && customCommands.get(command.getName())
   if (spec) {
     return toHttpRequest(spec)
@@ -436,7 +436,7 @@ function buildRequest(customCommands, command) {
 
   spec = W3C_COMMAND_MAP.get(command.getName())
   if (typeof spec === 'function') {
-    LOG.finest(() => `Transforming command for W3C: ${command.getName()}`)
+    log_.finest(() => `Transforming command for W3C: ${command.getName()}`)
     let newCommand = spec(command)
     return buildRequest(customCommands, newCommand)
   } else if (spec) {
@@ -451,7 +451,7 @@ function buildRequest(customCommands, command) {
    * @return {!Request}
    */
   function toHttpRequest(resource) {
-    LOG.finest(() => `Building HTTP request: ${JSON.stringify(resource)}`)
+    log_.finest(() => `Building HTTP request: ${JSON.stringify(resource)}`)
     let parameters = command.getParameters()
     let path = buildPath(resource.path, parameters)
     return new Request(resource.method, path, parameters)
@@ -487,7 +487,7 @@ class Executor {
     this.customCommands_ = null
 
     /** @private {!logging.Logger} */
-    this.log_ = logging.getLogger('webdriver.http.Executor')
+    this.log_ = logging.getLogger(`${logging.Type.DRIVER}.http.Executor`)
   }
 
   /**

package/lib/webdriver.js

@@ -2158,6 +2158,8 @@ class Window {
   constructor(driver) {
     /** @private {!WebDriver} */
     this.driver_ = driver
+    /** @private {!Logger} */
+    this.log_ = logging.getLogger(logging.Type.DRIVER)
   }
 
   /**
@@ -2252,7 +2254,7 @@ class Window {
    */
   async getSize(windowHandle = 'current') {
     if (windowHandle !== 'current') {
-      console.warn(
+      this.log_.warning(
         `Only 'current' window is supported for W3C compatible browsers.`
       )
     }
@@ -2275,7 +2277,7 @@ class Window {
     windowHandle = 'current'
   ) {
     if (windowHandle !== 'current') {
-      console.warn(
+      this.log_.warning(
         `Only 'current' window is supported for W3C compatible browsers.`
       )
     }
@@ -2547,6 +2549,9 @@ class WebElement {
 
     /** @private {!Promise<string>} */
     this.id_ = Promise.resolve(id)
+
+    /** @private {!Logger} */
+    this.log_ = logging.getLogger(logging.Type.DRIVER)
   }
 
   /**
@@ -2794,7 +2799,7 @@ class WebElement {
         keys.join('')
       )
     } catch (ex) {
-      console.log(
+      this.log_.error(
         'Error trying parse string as a file with file detector; sending keys instead' +
           ex
       )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.14.0",
+  "version": "4.15.0",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [

package/remote/index.js

@@ -120,7 +120,7 @@ class DriverService {
    */
   constructor(executable, options) {
     /** @private @const */
-    this.log_ = logging.getLogger('webdriver.DriverService')
+    this.log_ = logging.getLogger(`${logging.Type.DRIVER}.DriverService`)
     /** @private {string} */
     this.executable_ = executable
 

package/remote/util.js

@@ -19,6 +19,7 @@
 
 const path = require('path')
 const cp = require('child_process')
+const logging = require('../lib/logging')
 
 /**
  * returns path to java or 'java' string if JAVA_HOME does not exist in env obj
@@ -54,9 +55,11 @@ function isSelenium3x(seleniumStandalonePath) {
  */
 function formatSpawnArgs(seleniumStandalonePath, args) {
   if (isSelenium3x(seleniumStandalonePath)) {
-    console.warn(
-      'Deprecation: Support for Standalone Server 3.x will be removed soon. Please update to version 4.x'
-    )
+    logging
+      .getLogger(logging.Type.SERVER)
+      .warning(
+        'Deprecation: Support for Standalone Server 3.x will be removed soon. Please update to version 4.x',
+      )
     return args
   }