npmpackage.info

Gathering detailed insights and metrics for @rpai/webdriver

Other packages similar to @rpai/webdriver

@rpai/webdriverio

1.0.5

Next-gen browser and mobile automation test framework for Node.js

@rpai/wdio-logger

1.0.3

A helper utility for logging of WebdriverIO packages

@rpai/wdio-utils

1.0.3

A WDIO helper utility to provide several utility functions used across the project.

@rpai/wdio-types

1.0.1

Utility package providing type information for a variety of WebdriverIO interfaces

Gathering detailed insights and metrics for @rpai/webdriver

@rpai/webdriver - 1.0.3 | npmpackage.info

@rpai/webdriver

Next-gen browser and mobile automation test framework for Node.js

1.0.3

9,540

MIT

TypeScript

347.11 kB

Installations

npm install @rpai/webdriver

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Min. Node Version

^16.13 || >=18

Node Version

20.15.0

NPM Version

10.7.0 Pull Requests

Open

13

Total

8,140

Closed

1,467

Merged

6,660

Issues

Open

222

Total

5,766

Closed

5,544

Releases

568

v9.17.1

Updated on Jul 09, 2025

v9.17.0

Updated on Jul 09, 2025

v9.16.2

Updated on Jun 23, 2025

v9.16.1

Updated on Jun 23, 2025

v9.16.0

Updated on Jun 23, 2025

v8.45.0

Updated on Jun 12, 2025

View All 568 releases

Languages

TypeScript

JavaScript

EJS

CSS

Gherkin

Dockerfile

Vue

Svelte

HTML

TypeScript (94.25%)

JavaScript (3.6%)

EJS (1.37%)

CSS (0.67%)

Gherkin (0.07%)

Dockerfile (0.03%)

Vue (0.01%)

Developer

webdriverio

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

9,540 Stars

8,054 Commits

2,599 Forks

213 Watchers

32 Branches

652 Contributors

Updated on Jul 13, 2025

Maintainers

View All 652 Contributors

Package Meta Information

Latest Version

1.0.3

Package Id

@rpai/webdriver@1.0.3

Unpacked Size

347.11 kB

Size

65.50 kB

File Count

NPM Version

10.7.0

Node Version

20.15.0

Published on

Sep 27, 2024

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@types/node @types/ws deepmerge-ts got ky ws @rpai/wdio-config @rpai/wdio-logger @rpai/wdio-protocols @rpai/wdio-types @rpai/wdio-utils

WebDriver

A lightweight, non-opinionated implementation of the WebDriver and WebDriver BiDi specification including mobile commands supported by Appium

There are tons of Selenium and WebDriver binding implementations in the Node.js world. Every one of them has an opinionated API and recommended way to use it. This binding is the most non-opinionated you will find as it just represents the WebDriver specification and doesn't come with any extra or higher-level abstraction. It is lightweight and comes with support for the WebDriver specification and Appium's Mobile JSONWire Protocol.

The package supports the following protocols:

WebDriver
WebDriver Bidi
Appium
Chromium (additional Chromedriver specific commands)
Selenium (additional Selenium WebDriver specific commands)
Sauce Labs (Sauce Labs specific WebDriver extensions)
JSONWireProtocol (depcrecated)
Mobile JSONWireProtocol (depcrecated)

Commands are added to the client's protocol based on assumptions of provided capabilities. You can find more details about the commands by checking out the @wdio/protocols package. All commands come with TypeScript support.

Install

To install this package from NPM run:

1npm i webdriver

WebDriver Example

The following example demonstrates a simple Google Search scenario:

1import WebDriver from 'webdriver';
2
3const client = await WebDriver.newSession({
4    path: '/',
5    capabilities: { browserName: 'firefox' }
6})
7
8await client.navigateTo('https://www.google.com/ncr')
9
10const searchInput = await client.findElement('css selector', '#lst-ib')
11await client.elementSendKeys(searchInput['element-6066-11e4-a52e-4f735466cecf'], 'WebDriver')
12
13const searchBtn = await client.findElement('css selector', 'input[value="Google Search"]')
14await client.elementClick(searchBtn['element-6066-11e4-a52e-4f735466cecf'])
15
16console.log(await client.getTitle()) // outputs "WebDriver - Google Search"
17
18await client.deleteSession()

WebDriver Bidi Example

To connect to the WebDriver Bidi protocol you have to send along a webSocketUrl flag to tell the browser driver to opt-in to the protocol:

1import WebDriver from 'webdriver'
2
3const browser = await WebDriver.newSession({
4    capabilities: {
5        webSocketUrl: true,
6        browserName: 'firefox'
7    }
8})
9
10await browser.sessionSubscribe({ events: ['log.entryAdded'] })
11
12/**
13 * returns: {"type":"console","method":"log","realm":null,"args":[{"type":"string","value":"Hello Bidi"}],"level":"info","text":"Hello Bidi","timestamp":1657282076037}
14 */
15browser.on('log.entryAdded', (entryAdded) => console.log('received %s', entryAdded))
16
17await browser.executeScript('console.log("Hello Bidi")', [])
18await browser.deleteSession()

Configuration

To create a WebDriver session call the newSession method on the WebDriver class and pass in your configurations:

1import WebDriver from 'webdriver'
2const client = await WebDriver.newSession(options)

The following options are available:

capabilities

Defines the capabilities you want to run in your Selenium session.

Type: Object
Required: true

logLevel

Level of logging verbosity.

protocol

Protocol to use when communicating with the Selenium standalone server (or driver).

Type: String
Default: http Options: http | https

hostname

Host of your WebDriver server.

Type: String
Default: 0.0.0.0

port

Port your WebDriver server is on.

Type: Number
Default: undefined

path

Path to WebDriver endpoint or grid server.

Type: String
Default: /

queryParams

Query parameters that are propagated to the driver server.

Type: Object Default: undefined

connectionRetryTimeout

Timeout for any WebDriver request to a driver or grid.

Type: Number
Default: 120000

connectionRetryCount

Count of request retries to the Selenium server.

Type: Number
Default: 3

agent

Allows you to use a custom http/https/http2 agent to make requests.

Type: Object
Default:

1{
2    http: new http.Agent({ keepAlive: true }),
3    https: new https.Agent({ keepAlive: true })
4}

transformRequest

Function intercepting HTTP request options before a WebDriver request is made

Type: (RequestOptions) => RequestOptions
Default: none

transformResponse

Function intercepting HTTP response objects after a WebDriver response has arrived

Type: (Response, RequestOptions) => Response
Default: none

No vulnerabilities found.

10

Maintained

Determines if the project is "actively maintained".

10

Security-Policy

Determines if the project has published a security policy.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

9

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

6

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

5

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

4

SAST

Determines if the project uses static code analysis.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

Reason

detected GitHub workflow tokens with excessive permissions

Details

Info: found token with 'none' permissions: .github/workflows/authorize.yml:1
Info: jobLevel 'contents' permission set to 'read': .github/workflows/build.yml:11
Info: jobLevel 'packages' permission set to 'read': .github/workflows/build.yml:12
Warn: jobLevel 'contents' permission set to 'write': .github/workflows/cr.yml:12
Info: jobLevel 'packages' permission set to 'read': .github/workflows/cr.yml:14
Warn: jobLevel 'contents' permission set to 'write': .github/workflows/expense.yml:45
Warn: jobLevel 'contents' permission set to 'write': .github/workflows/publish.yml:36
Info: jobLevel 'packages' permission set to 'read': .github/workflows/publish.yml:38
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-cloud.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-component.yml:12
Warn: jobLevel 'actions' permission set to 'write': .github/workflows/test-component.yml:13
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-interop.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-launch.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-multiremote.yml:12
Warn: jobLevel 'actions' permission set to 'write': .github/workflows/test-smoke.yml:13
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-smoke.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-standalone.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-static.yml:13
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-testrunner.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-typings.yml:12
Info: jobLevel 'contents' permission set to 'read': .github/workflows/test-unit.yml:12
Warn: jobLevel 'actions' permission set to 'write': .github/workflows/test-unit.yml:13
Warn: no topLevel permission defined: .github/workflows/authorize.yml:1
Warn: no topLevel permission defined: .github/workflows/build.yml:1
Warn: no topLevel permission defined: .github/workflows/cr.yml:1
Info: topLevel 'contents' permission set to 'read': .github/workflows/deploy.yml:8
Info: topLevel 'packages' permission set to 'read': .github/workflows/deploy.yml:9
Warn: no topLevel permission defined: .github/workflows/expense.yml:1
Warn: no topLevel permission defined: .github/workflows/labeler.yml:1
Warn: no topLevel permission defined: .github/workflows/publish.yml:1
Warn: no topLevel permission defined: .github/workflows/test-cloud.yml:1
Warn: no topLevel permission defined: .github/workflows/test-component.yml:1
Warn: no topLevel permission defined: .github/workflows/test-interop.yml:1
Warn: no topLevel permission defined: .github/workflows/test-launch.yml:1
Warn: no topLevel permission defined: .github/workflows/test-multiremote.yml:1
Warn: no topLevel permission defined: .github/workflows/test-smoke.yml:1
Warn: no topLevel permission defined: .github/workflows/test-standalone.yml:1
Warn: no topLevel permission defined: .github/workflows/test-static.yml:1
Warn: no topLevel permission defined: .github/workflows/test-testrunner.yml:1
Warn: no topLevel permission defined: .github/workflows/test-typings.yml:1
Warn: no topLevel permission defined: .github/workflows/test-unit.yml:1
Warn: no topLevel permission defined: .github/workflows/test.yml:1
Warn: topLevel 'contents' permission set to 'write': .github/workflows/update.yaml:11

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Fuzzing

Determines if the project uses fuzzing.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

5

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More