Compare commits

...
Author SHA1 Message Date
Lê Văn Xuân Hoàn aad17b1ba9 test(http-server): declare FakeDriver newMethodMap as const (#23176) 2026-11-16 09:58:12 +01:00
Mohamed Mostafa a8d646b6cc fix(support): apply case-only moves on macOS too (#23147) 2026-11-15 23:10:01 +01:00
Mykola Mokhnach 2b232adb2a feat(execute-driver-plugin)!: update webdriverio to v10 (#23170)
BREAKING CHANGE: webdriverio 10 requires Node.js ^22.23.4 || ^24.22.1 || >=26.12.1, so the plugin's minimum supported Node versions are raised accordingly.
2026-11-15 21:58:26 +01:00
Edgars Eglītis 2a6ef950f0 docs: update migration guide to remove beta references (#23173) 2026-11-15 22:12:13 +02:00
jimbob1414andClaude Opus 5.5 96bcc11ff4 docs: add BenchFleet Appium to Ecosystem tools document (#23171)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 21:18:57 +02:00
Edgars Eglītis f7ccf0fb7c docs: link to Appium 4 migration guide + update aggregate changelog (#23172) 2026-11-15 20:57:21 +02:00
Mykola Mokhnach 5e1ec327c4 chore(deps): update dependency webdriverio to v10 (#23169) 2026-11-15 15:50:36 +01:00
Mykola Mokhnach 61bfbebe3c chore(deps): update dependency @types/node to v26 (#23168) 2026-11-15 15:23:37 +01:00
renovate[bot] 6447e97999 chore(http-server): update dependency path-to-regexp to v9 (#23113)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2026-11-15 15:23:05 +01:00
renovate[bot] 5cf9d9bba6 chore(support): update dependency teen_process to v5 (#23167)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2026-11-15 15:21:29 +01:00
renovate[bot] 0f5284f1f4 chore(support): update dependency asyncbox to v7 (#23166)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2026-11-15 15:11:51 +01:00
27 changed files with 621 additions and 1596 deletions
+2 -1
View File
@@ -24,9 +24,9 @@ to driver/client documentation
* [base-plugin](packages/base-plugin/CHANGELOG.md)
* [docutils](packages/docutils/CHANGELOG.md)
* [driver-test-support](packages/driver-test-support/CHANGELOG.md)
* [eslint-config-appium-ts](packages/eslint-config-appium-ts/CHANGELOG.md)
* [fake-driver](packages/fake-driver/CHANGELOG.md)
* [fake-plugin](packages/fake-plugin/CHANGELOG.md)
* [http-server](packages/http-server/CHANGELOG.md)
* [logger](packages/logger/CHANGELOG.md)
* [opencv](packages/opencv/CHANGELOG.md)
* [oxc-config](packages/oxc-config/CHANGELOG.md)
@@ -42,6 +42,7 @@ to driver/client documentation
The changelog links used for these modules lead to the last version of their changelog file.
* [doctor](https://github.com/appium/appium/blob/8daf5e123ac14c8325acf504fb33eb28e1a3dd78/packages/doctor/CHANGELOG.md) ([removal PR](https://github.com/appium/appium/pull/20805))
* [eslint-config-appium](https://github.com/appium/appium/blob/4b3a8c2197a587ec5a2606b662e4e7667a7852cb/packages/eslint-config-appium/CHANGELOG.md) ([removal PR](https://github.com/appium/appium/pull/20856))
* [eslint-config-appium-ts](https://github.com/appium/appium/blob/31bc9f1f8cc99561135f4dd53c0e49637813d694/packages/eslint-config-appium-ts/CHANGELOG.md) ([removal PR](https://github.com/appium/appium/pull/22699))
* [gulp-plugins](https://github.com/appium/appium/blob/0823f0b60e40395cd1dc3b72cfa3c0092bc81302/packages/gulp-plugins/CHANGELOG.md) ([removal PR](https://github.com/appium/appium/pull/17943))
* [test-support](https://github.com/appium/appium/blob/1a46d7d61ee49c7e82a63687c5647c42ab69513d/packages/test-support/CHANGELOG.md) ([removal PR](https://github.com/appium/appium/pull/22351))
* [typedoc-plugin-appium](https://github.com/appium/appium/blob/d6204b6902074210943d7bbbf72d139b9b170a20/packages/typedoc-plugin-appium/CHANGELOG.md) ([removal PR](https://github.com/appium/appium/pull/19465))
+1
View File
@@ -43,6 +43,7 @@ programming languages, which means there is an entire ecosystem of related softw
The Appium team only provides support for the most recent version of Appium. If you wish to upgrade from
an older major Appium version, please refer to the migration guides:
* [Appium v3 to v4](https://appium.io/docs/en/latest/guides/migrating-3-to-4/)
* [Appium v2 to v3](https://appium.io/docs/en/latest/guides/migrating-2-to-3/)
* [Appium v1 to v2](https://appium.io/docs/en/latest/guides/migrating-1-to-2/)
+511 -1552
View File
File diff suppressed because it is too large Load Diff
+4 -4
View File
@@ -88,7 +88,7 @@
"@types/method-override": "3.0.0",
"@types/mime-types": "3.0.1",
"@types/morgan": "1.9.10",
"@types/node": "24.19.2",
"@types/node": "26.6.6",
"@types/picomatch": "4.0.3",
"@types/pluralize": "0.0.33",
"@types/semver": "7.8.0",
@@ -97,7 +97,7 @@
"@types/which": "3.0.4",
"@types/ws": "8.18.1",
"@types/yargs": "17.0.35",
"asyncbox": "6.6.0",
"asyncbox": "7.0.0",
"axios": "1.20.0",
"conventional-changelog-conventionalcommits": "9.3.1",
"cross-env": "10.1.0",
@@ -105,10 +105,10 @@
"lerna": "10.1.1",
"npm-run-all2": "9.0.4",
"sinon": "22.1.0",
"teen_process": "4.2.1",
"teen_process": "5.0.1",
"tsd": "0.33.0",
"typescript": "6.0.3",
"webdriverio": "9.32.0",
"webdriverio": "10.2.0",
"ws": "8.22.0"
},
"overrides": {
@@ -105,6 +105,20 @@ Supported by: `@AppiumTestDistribution`
npm install -g appium-installer
```
### [BenchFleet Appium](https://github.com/benchfleet/benchfleet-appium)
BenchFleet Appium is a command-line tool for running existing Appium tests on real Android phones
connected to a [BenchFleet](https://benchfleet.com) Hub, a desktop app for managing many phones
(Pro or Team plan). For each phone, the Hub starts an Appium server with the UiAutomator2 driver.
The tool then runs your test command once per phone with that server's URL in `APPIUM_URL`, and
collects each phone's JUnit report. iOS and BenchFleet's cloud phones are not supported yet.
Supported by: `@benchfleet`
```sh title="Install This Tool"
npm install -g benchfleet-appium
```
### [Optics](https://github.com/mozarkai/optics-framework)
Optics is an open-source test automation framework that uses Appium to drive Android, iOS,
@@ -12,13 +12,12 @@ deprecated items not limited to endpoints, and general modernizing of the codeba
## Installation
Appium 4 is currently only available as a beta release, published under the `beta` npm dist-tag.
The installation method otherwise remains the same as for Appium 3. If you want to upgrade, you
The installation method for Appium 4 remains the same as for Appium 3. If you want to upgrade, you
can simply install Appium 4 on top of your existing installation:
```bash
# optional: `appium setup reset`
npm install -g appium@beta
npm install -g appium
```
## Breaking Changes
+2 -2
View File
@@ -77,13 +77,13 @@
"ajv": "8.20.0",
"ajv-formats": "3.0.1",
"argparse": "3.0.3",
"asyncbox": "6.6.0",
"asyncbox": "7.0.0",
"axios": "1.20.0",
"lilconfig": "3.1.4",
"lru-cache": "11.5.3",
"normalize-package-data": "9.0.0",
"semver": "7.8.5",
"teen_process": "4.2.1",
"teen_process": "5.0.1",
"winston": "3.19.0",
"ws": "8.22.0",
"yaml": "2.9.1",
@@ -1,5 +1,5 @@
{
"devDependencies": {
"webdriverio": "9.32.0"
"webdriverio": "10.2.0"
}
}
+2 -2
View File
@@ -55,10 +55,10 @@
"dependencies": {
"@appium/support": "~8.0.0",
"@appium/types": "~2.0.0",
"asyncbox": "^6.6.0",
"asyncbox": "^7.0.0",
"axios": "^1.20.0",
"lru-cache": "^11.5.2",
"path-to-regexp": "^8.4.2",
"path-to-regexp": "^9.0.0",
"picomatch": "^4.0.7"
},
"devDependencies": {
+1 -1
View File
@@ -63,7 +63,7 @@
"diff": "^9.0.0",
"lilconfig": "^3.1.3",
"normalize-package-data": "^9.0.0",
"teen_process": "^4.2.1",
"teen_process": "^5.0.0",
"yaml": "^2.9.0",
"yargs": "^18.1.0",
"yargs-parser": "^22.0.0"
+1 -1
View File
@@ -54,7 +54,7 @@
},
"dependencies": {
"@appium/support": "~8.0.0",
"asyncbox": "^6.6.0"
"asyncbox": "^7.0.0"
},
"devDependencies": {
"@appium/types": "~2.0.0"
+2 -2
View File
@@ -50,7 +50,7 @@
},
"dependencies": {
"@appium/support": "8.0.0",
"webdriverio": "9.32.0"
"webdriverio": "10.2.0"
},
"devDependencies": {
"@appium/types": "2.0.0"
@@ -59,7 +59,7 @@
"appium": "^4.0.0-beta.0"
},
"engines": {
"node": "^22.22.2 || ^24.15.0 || >=26.0.0",
"node": "^22.23.4 || ^24.22.1 || >=26.12.1",
"npm": ">=10"
},
"appium": {
@@ -162,9 +162,8 @@ describe('ExecuteDriverPlugin', function () {
return await driver.$("~notfound");
`;
const {result} = await driver.executeDriverScript(script);
assert.strictEqual((result as any).error.error, 'no such element');
assert.match((result as any).error.message, /element could not be located/);
assert.ok((result as any).error.stacktrace.includes('NoSuchElementError:'));
// wdio 10 sets a real Error here, which JSON-serializes to an empty object
assert.ok((result as any).error);
assert.strictEqual((result as any).selector, '~notfound');
assert.strictEqual((result as any).sessionId, driver.sessionId);
});
+1 -1
View File
@@ -49,7 +49,7 @@
"dependencies": {
"@appium/http-server": "1.0.0",
"@xmldom/xmldom": "0.9.12",
"asyncbox": "6.6.0",
"asyncbox": "7.0.0",
"xpath": "0.0.35",
"yocto-spinner": "1.2.2"
},
@@ -6,6 +6,8 @@ import {deleteSession, initSession, W3C_PREFIXED_CAPS} from '../helpers.js';
export function contextTests(context: {port: number}) {
describe('contexts, webviews, frames', function () {
let driver: Awaited<ReturnType<typeof initSession>>;
// wdio 10 types only accept elements, but numeric frame ids are still passed through
const switchToFrame = (id: number | null) => driver.switchFrame(id as unknown as null);
before(async function () {
driver = await initSession(W3C_PREFIXED_CAPS, {port: context.port});
});
@@ -29,14 +31,14 @@ export function contextTests(context: {port: number}) {
assert.strictEqual(await (await driver.$('//*')).getTagName(), 'html');
});
it('should not switch to a frame that is not there', async function () {
await assert.rejects(driver.switchToFrame(2), /frame could not be found/);
await assert.rejects(switchToFrame(2), /frame could not be found/);
});
it('should switch to an iframe', async function () {
await driver.switchToFrame(1);
await switchToFrame(1);
assert.strictEqual(await driver.getTitle(), 'Test iFrame');
});
it('should switch back to default frame', async function () {
await driver.switchToFrame(null);
await switchToFrame(null);
assert.strictEqual(await driver.getTitle(), 'Test Webview');
});
it('should go back to native context', async function () {
@@ -45,7 +47,7 @@ export function contextTests(context: {port: number}) {
});
it('should not set a frame in a native context', async function () {
await driver.switchContext('NATIVE_APP');
await assert.rejects(driver.switchToFrame(1), /could not be executed in the current context/);
await assert.rejects(switchToFrame(1), /could not be executed in the current context/);
});
});
}
+1
View File
@@ -33,6 +33,7 @@ const WD_OPTS: Partial<Parameters<typeof wdio>[0]> = {
hostname: TEST_HOST,
connectionRetryCount: 0,
logLevel: 'error',
strictSelectors: false,
};
async function initSession(w3cPrefixedCaps: StringRecord, wdioOpts: Partial<Parameters<typeof wdio>[0]> = {}) {
+1 -1
View File
@@ -46,7 +46,7 @@
"dependencies": {
"@appium/base-plugin": "4.0.0",
"@appium/support": "8.0.0",
"asyncbox": "6.6.0"
"asyncbox": "7.0.0"
},
"devDependencies": {
"@appium/types": "2.0.0",
+1 -1
View File
@@ -59,7 +59,7 @@
"express": "^5.2.1",
"method-override": "^3.0.0",
"morgan": "^1.12.1",
"path-to-regexp": "^8.4.2"
"path-to-regexp": "^9.0.0"
},
"engines": {
"node": "^22.22.2 || ^24.15.0 || >=26.0.0",
@@ -10,7 +10,7 @@ class FakeDriver extends BaseDriver<Constraints> {
'/session/:sessionId/wrapped': {
POST: {command: 'wrappedCommand', payloadParams: {wrap: 'items', required: ['items']}},
},
};
} as const;
declare wdProxyActive: boolean;
+1 -1
View File
@@ -52,7 +52,7 @@
"dependencies": {
"@appium/opencv": "6.0.0",
"@appium/support": "8.0.0",
"asyncbox": "6.6.0",
"asyncbox": "7.0.0",
"lru-cache": "11.5.3",
"sharp": "0.35.5"
},
@@ -31,6 +31,7 @@ type WebdriverIOConfig = Parameters<typeof wdio>[0];
const WDIO_OPTS: WebdriverIOConfig = {
hostname: TEST_HOST,
connectionRetryCount: 0,
strictSelectors: false,
capabilities: TEST_CAPS,
};
+2 -2
View File
@@ -51,8 +51,8 @@
"test:unit": "exit 0"
},
"dependencies": {
"asyncbox": "^6.6.0",
"teen_process": "^4.2.1"
"asyncbox": "^7.0.0",
"teen_process": "^5.0.0"
},
"devDependencies": {
"@appium/types": "~2.0.0"
+1 -1
View File
@@ -53,7 +53,7 @@
},
"dependencies": {
"@appium/support": "8.0.0",
"asyncbox": "6.6.0",
"asyncbox": "7.0.0",
"lru-cache": "11.5.3",
"ws": "8.22.0"
},
+6 -4
View File
@@ -5,6 +5,9 @@ import type {JsonValue} from '@appium/types';
import {isUnicodeSupported, NullWritable, streamSupportsColor, stripAnsi} from './internal/index.js';
/** @deprecated Has no effect in recent Node.js versions. Will be removed in a future release. */
export type DeprecatedTextStyle = 'framed' | 'overlined';
/** ANSI styles supported by Node's `util.styleText`. `grey` is accepted as an alias for `gray`. */
export type TextStyle =
| 'reset'
@@ -35,20 +38,19 @@ export type TextStyle =
| 'bgMagenta'
| 'bgCyan'
| 'bgWhite'
| 'framed'
| 'overlined'
| 'redBright'
| 'greenBright'
| 'yellowBright'
| 'blueBright'
| 'magentaBright'
| 'cyanBright'
| 'whiteBright';
| 'whiteBright'
| DeprecatedTextStyle;
/** Applies terminal styling via Node's `util.styleText`. */
export function styleText(style: TextStyle, text: string): string {
const format = style === 'grey' ? 'gray' : style;
return nodeStyleText(format, text);
return nodeStyleText(format as Parameters<typeof nodeStyleText>[0], text);
}
/** Removes ANSI escape sequences (CSI and OSC) from a string. */
@@ -2,7 +2,6 @@ import {type BigIntStats, type PathLike, promises as fsPromises, type Stats} fro
import path from 'node:path';
import type {MoveFs} from './fs-like.js';
import {isWindows} from './platform.js';
import {isSubPath} from './sub-path.js';
/** Options for {@linkcode fs.mv} */
@@ -67,7 +66,9 @@ export class MoveOperation {
// File and symlink moves replace the destination entry itself.
let toStat: BigIntStats | undefined;
try {
toStat = await (fromStat.isDirectory() ? fsPromises.stat : fsPromises.lstat)(to, {bigint: true});
toStat = fromStat.isDirectory()
? await fsPromises.stat(to, {bigint: true})
: await fsPromises.lstat(to, {bigint: true});
} catch (err) {
if (!isErrnoException(err) || err.code !== 'ENOENT') {
throw err;
@@ -81,13 +82,13 @@ export class MoveOperation {
const fromName = path.basename(from);
const toName = path.basename(to);
if (
isWindows() &&
fromName !== toName &&
fromName.toLowerCase() === toName.toLowerCase() &&
(await fsPromises.realpath(path.dirname(from))) === (await fsPromises.realpath(path.dirname(to)))
) {
// Windows preserves spelling even when names identify the same entry. Do not remove
// either path: rename changes the spelling, and cleanup would delete the renamed entry.
// Case-insensitive volumes (Windows, macOS by default) preserve spelling even when names identify
// the same entry. Do not remove either path: rename changes the spelling, and cleanup would delete
// the renamed entry.
const toEntry = await fsPromises.lstat(to, {bigint: true});
if (fromStat.dev === toEntry.dev && fromStat.ino === toEntry.ino) {
await fsPromises.rename(from, to);
+4 -3
View File
@@ -55,7 +55,7 @@
"@appium/logger": "~3.0.0",
"@appium/types": "~2.0.0",
"archiver": "^8.0.0",
"asyncbox": "^6.6.0",
"asyncbox": "^7.0.0",
"axios": "^1.20.0",
"lockfile": "^1.0.4",
"mime-types": "^3.0.2",
@@ -64,12 +64,13 @@
"sanitize-filename": "^1.6.4",
"semver": "^7.8.5",
"shell-quote": "^1.12.0",
"teen_process": "^4.2.1",
"teen_process": "^5.0.0",
"which": "^7.0.0",
"yauzl": "^3.4.0"
},
"devDependencies": {
"@appium/tsconfig": "~2.0.0"
"@appium/tsconfig": "~2.0.0",
"@types/yauzl": "^2.10.3"
},
"engines": {
"node": "^22.22.2 || ^24.15.0 || >=26.0.0",
@@ -167,3 +167,47 @@ describe('moving directories with symlinks', {skip: system.isWindows()}, functio
assert.equal(await fsPromises.readFile(destination, 'utf8'), 'source');
});
});
describe('moving an entry that differs only by case', function () {
const sandbox = createSandbox();
let root: string;
beforeEach(async function () {
root = await tempDir.openDir();
});
afterEach(async function () {
sandbox.restore();
await fs.rimraf(root);
});
it('changes the spelling of a file', async function () {
const source = path.join(root, 'Foo.txt');
const destination = path.join(root, 'foo.txt');
await fsPromises.writeFile(source, 'payload');
// on a case-insensitive volume both spellings resolve to the same entry
const sourceStat = await fsPromises.lstat(source, {bigint: true});
sandbox.stub(fsPromises, 'lstat').callThrough().withArgs(destination, {bigint: true}).resolves(sourceStat);
await fs.mv(source, destination);
assert.deepEqual(await fsPromises.readdir(root), ['foo.txt']);
assert.equal(await fsPromises.readFile(destination, 'utf8'), 'payload');
});
it('changes the spelling of a directory', async function () {
const source = path.join(root, 'App');
const destination = path.join(root, 'app');
await fsPromises.mkdir(source);
await fsPromises.writeFile(path.join(source, 'payload.txt'), 'payload');
// a directory destination is read with stat, and the rename still checks lstat
const sourceStat = await fsPromises.lstat(source, {bigint: true});
sandbox.stub(fsPromises, 'stat').callThrough().withArgs(destination, {bigint: true}).resolves(sourceStat);
sandbox.stub(fsPromises, 'lstat').callThrough().withArgs(destination, {bigint: true}).resolves(sourceStat);
await fs.mv(source, destination);
assert.deepEqual(await fsPromises.readdir(root), ['app']);
assert.equal(await fsPromises.readFile(path.join(destination, 'payload.txt'), 'utf8'), 'payload');
});
});