webdriver-js-extender

What is webdriver-js-extender?

The webdriver-js-extender package is a utility that extends the capabilities of the WebDriverJS (Selenium WebDriver for JavaScript) by allowing users to execute custom commands and interact with the browser in ways that are not directly supported by the standard WebDriver API.

What are webdriver-js-extender's main functionalities?

Executing Custom Commands

This feature allows users to execute custom commands that are not part of the standard WebDriver API. In this example, a custom GET command is executed to retrieve the current URL of the browser session.

const { WebDriverExtender } = require('webdriver-js-extender');
const { Builder } = require('selenium-webdriver');

(async function example() {
  let driver = new Builder().forBrowser('chrome').build();
  driver = WebDriverExtender.extend(driver);
  await driver.get('http://www.example.com');
  const result = await driver.executeCustomCommand({
    cmd: 'GET',
    path: '/session/:sessionId/url',
    data: {}
  });
  console.log(result);
  await driver.quit();
})();

Interacting with Browser Extensions

This feature allows users to interact with browser extensions. In this example, the code retrieves and logs the list of installed browser extensions.

const { WebDriverExtender } = require('webdriver-js-extender');
const { Builder } = require('selenium-webdriver');

(async function example() {
  let driver = new Builder().forBrowser('chrome').build();
  driver = WebDriverExtender.extend(driver);
  await driver.get('http://www.example.com');
  const extensions = await driver.getInstalledExtensions();
  console.log(extensions);
  await driver.quit();
})();

Other packages similar to webdriver-js-extender

selenium-webdriver

The selenium-webdriver package is the official JavaScript implementation of the WebDriver API. It provides a comprehensive set of functions to control web browsers. While it does not support custom commands out of the box, it is widely used and well-documented.

webdriverio

WebdriverIO is a popular WebDriver binding for Node.js. It provides a rich set of features and plugins, including support for custom commands, making it a powerful alternative to webdriver-js-extender. WebdriverIO also has an active community and extensive documentation.

nightwatch

Nightwatch.js is an end-to-end testing framework that uses the WebDriver API. It includes built-in support for custom commands and assertions, making it a versatile tool for browser automation and testing. Nightwatch.js is known for its simplicity and ease of use.

README

WebDriver JS Extender

This tools extends Selenium's javascript implementation of the WebDriver API to include additional commands (e.g. commands required for appium).

You can view the full list of commands in lib/index.ts.

Usage

Use WebDriver JS Extender's extend function on your webdriver instance:

  var extendedWebdriver = require('webdriver-js-extender').extend(webdriver);

  extendedWebdriver.setNetworkConnection(5);