Upgrading appium-chromium-driver from 3.x to 4.x
Comparison of the public API of appium-chromium-driver 3.2.0 and 4.0.0, computed automatically from their TypeScript types. A changed signature is a candidate for a breaking change, not a certainty.
Summary
| Removed import paths | 0 |
|---|---|
| Removed exports | 1 |
| Changed signatures | 0 |
| Removed class or interface members | 0 |
| Changed class or interface members | 2 |
| Newly deprecated | 0 |
| Requirement changes (engines, peer dependencies) | 2 |
| New exports | 0 |
Removed exports
| import | export | kind | Before |
|---|---|---|---|
appium-chromium-driver | default | class | class |
Changed signatures
None detected.
Removed class or interface members
None detected.
Changed class or interface members
| member | Before | After |
|---|---|---|
ChromiumDriver.findElOrEls | (this: ChromiumDriver, strategy: string, selector: string, mult: boolean, context?: string | undefined): Promise<any> | (strategy: string, selector: string, mult: boolean, context?: string | undefined): Promise<any> |
ChromiumDriver.createSession | (jsonwpDesiredCapabilities: W3CDriverCaps<{ readonly chromedriverPort: { readonly isNumber: true; }; readonly useSystemExecutable: { readonly isBoolean: true; }; readonly executable: { readonly isString: true; }; readonly executableDir: { readonly isString: true; }; readonly verbose: { readonly isBo… | (w3cCapabilities: W3CDriverCaps<{ readonly chromedriverPort: { readonly isNumber: true; }; readonly useSystemExecutable: { readonly isBoolean: true; }; readonly executable: { readonly isString: true; }; readonly executableDir: { readonly isString: true; }; readonly verbose: { readonly isBoolean: tru… |
Newly deprecated
None detected.
Requirement changes (engines, peer dependencies)
| Before | After | |
|---|---|---|
engines.node | ^20.19.0 || ^22.12.0 || >=24.0.0 | ^22.22.2 || ^24.15.0 || >=26.0.0 |
peerDependencies.appium | ^3.0.0-rc.2 | ^4.0.0-beta.6 |
Changelog between these versions
Text published by the package authors, shown as-is.
4.0.0
### ⚠ BREAKING CHANGES
* Requires Appium ^4.0.0-beta.6 (peer dependency). No longer compatible with Appium 3.
* Drops Node 20. The minimum is now ^22.22.2 || ^24.15.0 || >=26.0.0, matching Appium 4's engine range.
* Driver API: createSession takes a single w3cCapabilities argument, following the Appium 4 base driver. This only matters to anyone subclassing the driver.
* Default exports removed: the package no longer has a default export. Use the named export instead: import {ChromiumDriver} from 'appium-chromium-driver'.
* Command methods live on the prototype: findElOrEls is attached to ChromiumDriver.prototype (with declare module typings) rather than being an instance field, so subclasses can call super for it.
### Features
* add Appium 4 support ([#481](https://github.com/appium/appium-chromium-driver/issues/481)) ([6dad41b](https://github.com/appium/appium-chromium-driver/commit/6dad41b85ff61db22579157c3357653a2adba810))Give your AI agent these facts
Vigia is a free MCP server: your coding agent checks versions, breaking changes and vulnerabilities before it writes code. No signup, no API key.
claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp
Add to CursorAdd to VS Code★ Star on GitHub
Any other MCP client
{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }Agent skill (SKILL.md): tells the agent when to use Vigia · GitHub Action for pull requests
Frequently asked questions
What are the breaking changes when upgrading appium-chromium-driver from 3 to 4?
Between appium-chromium-driver 3.2.0 and 4.0.0, Vigia found 1 removed exports, 0 changed signatures and 2 removed or changed class or interface members.
What became deprecated in appium-chromium-driver 4?
0 exports or members are newly marked as deprecated in appium-chromium-driver 4.0.0.
For agents
GET https://vigia.coredls.cloud/v1/packages/npm/appium-chromium-driver/upgrade?from=3.2.0&to=4.0.0