将 @appium/base-driver 从 10.x 升级到 11.x

根据 TypeScript 类型自动比较 @appium/base-driver 10.8.3 与 11.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	11
已修改的签名	4
已删除的类或接口成员	13
已修改的类或接口成员	11
新增弃用	0
要求变化（engines、peer 依赖）	1
新增导出	15

已删除的导出

import	export	kind	之前
`@appium/base-driver`	`server`	function	`(opts: ServerOpts): Promise<AppiumServer>`
`@appium/base-driver`	`JWProxy`	class	`class`
`@appium/base-driver`	`default`	class	`class`
`@appium/base-driver`	`STATIC_DIR`	variable	`string`
`@appium/base-driver`	`ServerOpts`	interface	`interface`
`@appium/base-driver`	`statusCodes`	variable	{ readonly Success: { readonly code: 0; readonly summary: "The command executed successfully."; }; readonly NoSuchDriver: { readonly code: 6; readonly summary: "A session is either terminated or not started"; }; readonly NoSuchElement: { readonly code: 7; readonly summary: "An element could not be located on the page using the given search parameters."; }; readonly NoSuchFrame: { readonly code: 8; readonly summary: "A request to switch to a frame could not be satisfied because the frame could not be found."; }; readonly UnknownCommand: { readonly code: 9; readonly summary: "The requested resou…
`@appium/base-driver`	`errorFromCode`	function	`(code: number, value?: string \| { message: string; } \| undefined): ProtocolError`
`@appium/base-driver`	`getSummaryByCode`	function	`(code: string \| number): string`
`@appium/base-driver`	`determineProtocol`	function	`(createSessionArgs: any[]): "W3C" \| "MJSONWP"`
`@appium/base-driver`	`normalizeBasePath`	function	`(basePath: string): string`
`@appium/base-driver`	`errorFromMJSONWPStatusCode`	function	`(code: number, value?: string \| { message: string; } \| undefined): ProtocolError`

已修改的签名

export	之前	之后
`@appium/base-driver · checkParams`	`(paramSpec: PayloadParams, args: Record<string, any>, protocol?: "W3C" \| "MJSONWP" \| undefined): Record<string, any>`	`(paramSpec: PayloadParams, args: Record<string, any>, options?: CheckParamsOptions \| undefined): Record<string, any>`
`@appium/base-driver · BIDI_COMMANDS`	{ readonly session: { readonly subscribe: { readonly command: "bidiSubscribe"; readonly params: { readonly required: readonly ["events"]; readonly optional: readonly ["contexts"]; }; }; readonly unsubscribe: { readonly command: "bidiUnsubscribe"; readonly params: { readonly optional: readonly ["events", "contexts", "subscriptions"]; }; }; readonly status: { readonly command: "bidiStatus"; readonly params: {}; }; }; readonly browsingContext: { readonly navigate: { readonly command: "bidiNavigate"; readonly params: { readonly required: readonly ["context", "url"]; readonly optional: readonly ["w…	{ readonly session: { readonly status: { readonly command: "bidiStatus"; readonly params: {}; }; readonly new: { readonly command: "bidiSessionNew"; readonly params: { readonly required: readonly ["capabilities"]; }; }; readonly end: { readonly command: "bidiSessionEnd"; readonly params: {}; }; readonly subscribe: { readonly command: "bidiSubscribe"; readonly params: { readonly required: readonly ["events"]; readonly optional: readonly ["contexts", "userContexts"]; }; }; readonly unsubscribe: { readonly command: "bidiUnsubscribe"; readonly params: { readonly required: readonly [readonly ["subs…
`@appium/base-driver · errorFromW3CJsonCode`	`(signature: string, message: string, stacktrace?: string \| undefined): ProtocolError`	`(signature: string, message: string, stacktrace?: string \| undefined, data?: Record<string, unknown> \| undefined): ProtocolError`
`@appium/base-driver · generateDriverLogPrefix`	`(obj: object \| null, _sessionId?: string \| null \| undefined): string`	`(obj: object \| null): string`

已删除的类或接口成员

member	import	之前
`BaseDriver.reset`	`@appium/base-driver`	`(): Promise<void>`
`BaseDriver.driverData`	`@appium/base-driver`	`{}`
`BaseDriver.getSession`	`@appium/base-driver`	`(): Promise<SingularSessionData<C, SessionData>>`
`BaseDriver.isMjsonwpProtocol`	`@appium/base-driver`	`(): boolean`
`BaseDriver.setProtocolMJSONWP`	`@appium/base-driver`	`(): void`
`DriverCore.driverData`	`@appium/base-driver`	`{}`
`DriverCore.isMjsonwpProtocol`	`@appium/base-driver`	`(): boolean`
`DriverCore.setProtocolMJSONWP`	`@appium/base-driver`	`(): void`
`WebDriverProxy.protocolConverter`	`@appium/base-driver`	`ProtocolConverter`
`WebDriverProxy.downstreamProtocol`	`@appium/base-driver`	`Protocol \| null \| undefined`
`WebDriverProxy._downstreamProtocol`	`@appium/base-driver`	`any`
`WebDriverProxy.getSessionIdFromUrl`	`@appium/base-driver`	`(url: string): string \| null`
`WebDriverProxy.getProtocolFromResBody`	`@appium/base-driver`	`(resObj: Record<string, unknown>): Protocol \| undefined`

已修改的类或接口成员

member	之前	之后
`BaseDriver.helpers`	`typeof import("/pkg/build/lib/basedriver/helpers")`	`typeof import("/pkg/build/lib/basedriver/helpers/index")`
`BaseDriver.getStatus`	`(): Promise<{}>`	`(): Promise<any>`
`BaseDriver.constructor`	`<const C extends Constraints, CArgs extends StringRecord = StringRecord, Settings extends StringRecord = StringRecord, CreateResult = DefaultCreateSessionResult<C>, DeleteResult = DefaultDeleteSessionResult, SessionData extends StringRecord = StringRecord>(opts: InitialOpts, shouldValidateCaps?: boo…`	`<const C extends Constraints, CArgs extends StringRecord = StringRecord, Settings extends StringRecord = StringRecord, CreateResult = DefaultCreateSessionResult<C>, DeleteResult = DefaultDeleteSessionResult>(opts?: any, shouldValidateCaps?: boolean \| undefined): BaseDriver<C, CArgs, Settings, Create…`
`BaseDriver.createSession`	`(w3cCapabilities: W3CDriverCaps<C>): Promise<CreateResult> \| (...legacyArgs: LegacyCreateSessionArgs<C>): Promise<CreateResult>`	`(w3cCapabilities: W3CDriverCaps<C>): Promise<CreateResult>`
`BaseDriver.implicitWaitMs`	`number`	`TimeoutValue`
`BaseDriver.getManagedDrivers`	`(): Driver<Constraints, StringRecord, StringRecord, any, void, StringRecord>[]`	`(): Driver[]`
`DriverCore.helpers`	`typeof import("/pkg/build/lib/basedriver/helpers")`	`typeof import("/pkg/build/lib/basedriver/helpers/index")`
`DriverCore.getStatus`	`(): Promise<{}>`	`(): Promise<any>`
`DriverCore.implicitWaitMs`	`number`	`TimeoutValue`
`DriverCore.getManagedDrivers`	`(): Driver<Constraints, StringRecord, StringRecord, any, void, StringRecord>[]`	`(): Driver[]`
`WebDriverProxy.constructor`	`(opts?: any): JWProxy`	`(opts?: any): WebDriverProxy`

新增弃用

未发现。

要求变化（engines、peer 依赖）

	之前	之后
`engines.node`	`^20.19.0 \|\| ^22.12.0 \|\| >=24.0.0`	`^22.22.2 \|\| ^24.15.0 \|\| >=26.0.0`

新增导出 (15)

import	export	kind
`@appium/base-driver`	`getProxyReq`	function
`@appium/base-driver`	`calcSignature`	function
`@appium/base-driver`	`JsonParseErrors`	class
`@appium/base-driver`	`W3C_TIMEOUTS_MS`	variable
`@appium/base-driver`	`jsonParseErrors`	variable
`@appium/base-driver`	`runWithProxyReq`	function
`@appium/base-driver`	`withoutProxyReq`	function
`@appium/base-driver`	`handleIdempotency`	function
`@appium/base-driver`	`CheckParamsOptions`	interface
`@appium/base-driver`	`markResponseEnvelope`	function
`@appium/base-driver`	`runWithCommandTimeout`	function
`@appium/base-driver`	`NEW_COMMAND_TIMEOUT_MS`	variable
`@appium/base-driver`	`RouteConfiguringFunction`	type
`@appium/base-driver`	`isProtocolResponseEnvelope`	function
`@appium/base-driver`	`RouteConfiguringFunctionOpts`	interface

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 @appium/base-driver 从 10 升级到 11 有哪些不兼容变更？

在 @appium/base-driver 10.8.3 与 11.0.0 之间，Vigia 发现 11 个已删除的导出、4 个已修改的签名，以及 24 个已删除或修改的类或接口成员。

@appium/base-driver 11 中弃用了哪些内容？

@appium/base-driver 11.0.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/@appium/base-driver/upgrade?from=10.8.3&to=11.0.0