npmpackage.info

Gathering detailed insights and metrics for appium-chromedriver

Other packages similar to appium-chromedriver

appium-chromium-driver

1.5.1

Appium 2.x driver for Chromium-based browsers that work with Chromedriver

@rpai/appium-chromium-driver

1.0.5

Appium 2.x driver for Chromium-based browsers that work with Chromedriver

Gathering detailed insights and metrics for appium-chromedriver

appium-chromedriver - 7.0.30 | npmpackage.info

appium-chromedriver

Node.js wrapper around Chromedriver

7.0.30

Apache-2.0

JavaScript

295.59 kB

5.8

Installations

npm install appium-chromedriver

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=14

Node Version

22.17.0

NPM Version

10.9.3 Score

68.3

Supply Chain

Quality

95.7

Maintenance

Vulnerability

90.1

License

Pull Requests

Open

1

Total

445

Closed

58

Merged

386

Issues

Open

2

Total

32

Closed

30

Releases

180

v7.0.30

Updated on Jul 09, 2025

v7.0.29

Updated on Jul 01, 2025

v7.0.28

Updated on Jun 26, 2025

v7.0.27

Updated on Jun 13, 2025

v7.0.26

Updated on Jun 11, 2025

v7.0.25

Updated on Jun 10, 2025

View All 180 releases

Languages

JavaScript

TypeScript

JavaScript (97.25%)

TypeScript (2.75%)

Developer

appium

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

Apache-2.0 License

76 Stars

868 Commits

58 Forks

21 Watchers

3 Branches

43 Contributors

Updated on Jul 09, 2025

Maintainers

View All 43 Contributors

Package Meta Information

Latest Version

7.0.30

Package Id

appium-chromedriver@7.0.30

Unpacked Size

295.59 kB

Size

64.53 kB

File Count

NPM Version

10.9.3

Node Version

22.17.0

Published on

Jul 09, 2025

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

appium-chromedriver

Node.js wrapper around Chromedriver and Microsoft Edge WebDriver. The Microsoft Edge WebDriver support is since v5.4.0. This wrapper is not used directly in Appium, but rather by various Android drivers to automate Chrome/Chromium-based browsers and web views using Hybrid Mode approach. Check the corresponding driver tutorials to get more details on it.

Note

This package is intended to be used as a helper module for Appium drivers such as UiAutomator2 and appium-chromium-driver. It was not created for standalone usage. Please ensure you know what you are doing before using this package directly.

Note

This package can work with Microsoft Edge WebDriver as well, but the support is limited. For example, automatic downloads do not work for Microsoft Edge WebDriver.

Automatic Chromedriver download on module install

Since version 6.0.0 of this module automatic download of the latest known chromedriver does not happen anymore. The below information is only relevant for older module versions:

Skipping binary installation

By default, upon installation the package downloads the most recent known Chromedriver version from Chromedriver CDN server: http://chromedriver.storage.googleapis.com. If, for some reason, you want to install the package without downloading the Chromedriver binary set the APPIUM_SKIP_CHROMEDRIVER_INSTALL environment variable:

1APPIUM_SKIP_CHROMEDRIVER_INSTALL=1 npm install appium-chromedriver

Custom Chromedriver version

By default, the package uses the most recent known Chromedriver version. The full list of known Chromedriver versions and their corresponding supported Chrome version could be found in mapping.json

To download a custom version of Chromedriver, please set CHROMEDRIVER_VERSION environment variable:

1CHROMEDRIVER_VERSION=107.0.5304.62 npm install appium-chromedriver

Custom binaries url

If you want Chromedriver to be downloaded from another CDN, which differs from the default one https://chromedriver.storage.googleapis.com, then set the new URL to the CHROMEDRIVER_CDNURL environment variable:

1CHROMEDRIVER_CDNURL=http://npm.taobao.org/mirrors/chromedriver npm install appium-chromedriver

If you want automatic chromedrivers download feature to work with a custom CDN URL then make sure the server returns a proper list of stored drivers in response to requests having Accept: application/xml header. An example XML could be retrieved from the original URL using curl -H 'Accept: application/xml' https://chromedriver.storage.googleapis.com command.

Since version 5.6 the second environment variable has been added: CHROMELABS_URL. By default, it points to https://googlechromelabs.github.io, and is expected to contain the actual prefix of Chrome for Testing availability JSON API. This API allows retrieval of chromedrivers whose major versions are greater than 114.

Similarly to the above it could be also defined in the .npmrc file:

1chromelabs_url=https://googlechromelabs.github.io

You may also want to skip checking for older Chromedriver versions by providing an empty value to the CHROMEDRIVER_CDNURL variable.

Usage

1import Chromedriver from 'appium-chromedriver';
2
3// 'sync'-like await/Promise usage
4async function runSession() {
5    let driver = new Chromedriver();
6    const desiredCaps = {browserName: 'chrome'};
7    await driver.start(desiredCaps);
8    let status = await driver.sendCommand('/status', 'GET');
9    await driver.stop();
10}
11
12// EventEmitter usage
13function runSession2() {
14    let driver = new Chromedriver();
15    const desiredCaps = {browserName: 'chrome'};
16    driver.start(desiredCaps);
17    driver.on(Chromedriver.EVENT_CHANGED, function (msg) {
18        if (msg.state === Chromedriver.STATE_ONLINE) {
19            driver.sendCommand('/status', 'GET').then(function (status) {
20                driver.stop();
21            });
22        }
23    });
24    driver.on(Chromedriver.EVENT_ERROR, function (err) {
25        // :-(
26    });
27}

States

Here's what the Chromedriver state machine looks like:

Chromedriver States

Here are the events you can listen for:

Chromedriver.EVENT_ERROR: gives you an error object
Chromedriver.EVENT_CHANGED: gives you a state change object, with a state property that can be one of:
- Chromedriver.STATE_STOPPED
- Chromedriver.STATE_STARTING
- Chromedriver.STATE_ONLINE
- Chromedriver.STATE_STOPPING
- Chromedriver.STATE_RESTARTING

Development

Build & Lint

1npm run build
2npm run lint

Run Tests

1npm run test
2npm run e2e-test

High

8.1/10

Summary

appium-chromedriver downloads Resources over HTTP

Affected Versions

< 2.9.4

Patched Versions

2.9.4

10

Binary-Artifacts

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

10

Maintained

Determines if the project is "actively maintained".

10

Dangerous-Workflow

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

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

10

Packaging

Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.

9

Security-Policy

Determines if the project has published a security policy.

1

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.

0

Pinned-Dependencies

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

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/cd_bump.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/cd_bump.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/cd_bump.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/cd_bump.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/cd_bump.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/cd_bump.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/functional-test.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/functional-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/functional-test.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/functional-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/functional-test.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/functional-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/functional-test.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/functional-test.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/pr-title.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/pr-title.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.js.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/publish.js.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.js.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/publish.js.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/unit-test.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/unit-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/unit-test.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/unit-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/unit-test.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/appium/appium-chromedriver/unit-test.yml/master?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/cd_bump.yml:23
Warn: npmCommand not pinned by hash: .github/workflows/functional-test.yml:19
Warn: npmCommand not pinned by hash: .github/workflows/publish.js.yml:19
Warn: npmCommand not pinned by hash: .github/workflows/unit-test.yml:32
Info: 0 out of 10 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 3 third-party GitHubAction dependencies pinned
Info: 0 out of 4 npmCommand dependencies pinned

0

CII-Best-Practices

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

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

5.8

/10

Last Scanned on 2025-07-07

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

Other packages similar to appium-chromedriver

Other packages similar to appium-chromedriver

appium-chromedriver

Installations

Developer Guide

Yes

CommonJS

>=14

22.17.0

10.9.3

Score

Pull Requests

1

445

58

386

Issues

2

32

30

Releases

Languages

Developer

appium

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

appium-chromedriver

Automatic Chromedriver download on module install

Skipping binary installation

Custom Chromedriver version

Custom binaries url

Usage

States

Development

Build & Lint

Run Tests

10

10

10

10

10

10

9

1

0

0

0

0

0

5.8

/10