mirror of
https://github.com/appium/appium.git
synced 2026-11-16 07:34:05 +08:00
Compare commits
10
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a8d646b6cc | ||
|
|
2b232adb2a | ||
|
|
2a6ef950f0 | ||
|
|
96bcc11ff4 | ||
|
|
f7ccf0fb7c | ||
|
|
5e1ec327c4 | ||
|
|
61bfbebe3c | ||
|
|
6447e97999 | ||
|
|
5cf9d9bba6 | ||
|
|
0f5284f1f4 |
+2
-1
@@ -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))
|
||||
|
||||
@@ -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/)
|
||||
|
||||
|
||||
Generated
+511
-1552
File diff suppressed because it is too large
Load Diff
+4
-4
@@ -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
|
||||
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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": {
|
||||
|
||||
@@ -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"
|
||||
|
||||
@@ -54,7 +54,7 @@
|
||||
},
|
||||
"dependencies": {
|
||||
"@appium/support": "~8.0.0",
|
||||
"asyncbox": "^6.6.0"
|
||||
"asyncbox": "^7.0.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@appium/types": "~2.0.0"
|
||||
|
||||
@@ -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);
|
||||
});
|
||||
|
||||
@@ -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/);
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
@@ -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]> = {}) {
|
||||
|
||||
@@ -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",
|
||||
|
||||
@@ -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",
|
||||
|
||||
@@ -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,
|
||||
};
|
||||
|
||||
|
||||
@@ -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"
|
||||
|
||||
@@ -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"
|
||||
},
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -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');
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user