WebdriverIO MCP Selectors 全指南从 Web CSS 到 iOS/Android 原生定位策略的实战手册【免费下载链接】webdriverioNext-gen browser and mobile automation test framework for Node.js项目地址: https://gitcode.com/GitHub_Trending/we/webdriverioWebdriverIO MCPModel Context Protocol服务器为 AI 助手提供了统一的浏览器与移动端自动化接口而选择器Selectors正是它与页面、应用 UI 交互的触手。本文以 website/docs/mcp/selectors.md 为骨架完整梳理 MCP 场景下 Web、iOS、Android 三端的选择器语法与跨平台取舍策略并结合仓库源码findStrategy.ts、Selectors 主文档、MCP Tools 与 MCP Configuration帮助你掌握如何写选择器为什么这么写底层如何解析三层能力进而在 AI 自动化任务中写出稳定、高效、可维护的定位表达式。Web 端选择器MCP 支持的标准 WebdriverIO 策略对于浏览器自动化platform: browserMCP 服务器支持全部标准 WebdriverIO 选择器。文档总结的常用策略如下选择器示例说明CSS#login-button、.submit-btn标准 CSS 选择器XPath//button[idsubmit]XPath 表达式TextbuttonSubmit、a*ClickWebdriverIO 文本选择器ARIAaria/Submit Button无障碍名称Accessibility Name选择器Test ID[data-testidsubmit]测试专用属性推荐用于测试底层策略识别机制WebdriverIO 在 findStrategy.ts 中定义了一个DIRECT_SELECTOR_REGEXP它直接声明了 MCP 服务器所支持的显式策略前缀包括id | css selector | xpath | link text | partial link text | name | tag name | class name | -android uiautomator | -android datamatcher | -android viewmatcher | -android viewtag | -ios uiautomation | -ios predicate string | -ios class chain | accessibility id当选择器不包含上述显式前缀时defineStrategy 会按规则自动推断策略以/、(、../、./、*/开头 →xpath以开头 →link text以*开头 →partial link text以id开头 →id策略以即 constants.ts 中的DEEP_SELECTOR开头 → shadow DOM 策略以aria/即 constants.ts 中的ARIA_SELECTOR开头 →aria策略以android开头 →-android uiautomator以ios开头 →-ios uiautomation以~开头 →accessibility id形如div/div /→tag name形如[name...]→name策略。ARIA 选择器的实现原理aria/Submit Button之所以能按用户感知的名称定位元素是因为它在底层被展开为一组 XPath 联合表达式findStrategy.ts。根据 Accname 规范aria策略会依次尝试匹配aria-labelledby/aria-describedby引用的元素直接aria-label属性关联label for、父级label包裹的input/textareaplaceholder/aria-placeholder/title属性img alt元素自身的文本内容normalize-space(text()) ...。例如aria/Submit会被转换成类似./*[aria-label Submit] | ./input[id(//label[...]/for)] | ...的 XPath 表达式。这意味着 ARIA 选择器感知用户的同时在大页面上会比普通 CSS 慢——这正是 MCP 文档提醒该选择器可能比其它选择器慢的原因。Web 端最佳实践来自主文档Selectors.md 用同一段button idmain classbtn btn-large>{ total: 42, showing: 20, hasMore: true, elements: [...] }使用get_accessibility仅浏览器get_accessibility工具为浏览器自动化提供页面元素的语义信息内部查询浏览器原生的无障碍 API当get_elements未返回预期元素时尤其有用对应工具为get_accessibility_tree详见 tools.md# 获取所有有命名的无障碍节点 Get accessibility tree # 只过滤按钮和链接 Get accessibility tree filtered to button and link roles # 获取下一页结果 Get accessibility tree with limit 50 and offset 50支持按 ARIAroles如button、link、textbox、checkbox、radio、heading、img、listitem过滤并支持limit/offset分页。这与 WebdriverIO 主框架的[role...]角色选择器findStrategy.ts形成互补一个走浏览器无障碍树一个走 CSS/XPath 角色展开。性能与 Token 优化提示从 configuration.md 的性能考虑一节可知选择器选择直接影响 MCP 会话的响应体量与 Token 消耗移动端 XML 页面源解析仅需 2 次 HTTP 调用传统元素查询需要 600 次Accessibility ID 选择器最快最稳XPath 最慢只能作为最后手段inViewportOnly: true过滤屏幕外元素缩小响应体includeContainers: false排除布局元素如 Android 的ViewGroup、FrameLayout、LinearLayout、RelativeLayout、ConstraintLayout、ScrollView、RecyclerView以及 iOS 的View、StackView、CollectionView、ScrollView、TableViewincludeBounds: false省略坐标数据limitoffset分页分批处理大量元素而非一次全量返回。小结选择器是 MCP 自动化可靠性的根基。Web 端优先data-testid与文本/ARIA 选择器移动端以 Accessibility ID~为跨平台最优解Android 退而求其次用 UiAutomator 与 Resource IDiOS 用谓词字符串与 Class ChainXPath 仅在最后手段使用。理解 findStrategy.ts 底层的策略识别与 ARIA 展开逻辑能帮助你在调试 AI 自动化失败时快速定位问题结合get_elements的分页、过滤参数与get_accessibility的无障碍树可以显著降低 Token 消耗并提升元素定位的稳定性。【免费下载链接】webdriverioNext-gen browser and mobile automation test framework for Node.js项目地址: https://gitcode.com/GitHub_Trending/we/webdriverio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考