如何用Postman向WinAppDriver（WebDriver）发请求调试xPath

前置准备 #

• 确保WinAppDriver以服务监听模式启动，默认绑定127.0.0.1:4723端口，启动后控制台可看到明确的监听提示
• 按照原有测试流程，在代码中将执行到被测应用抵达目标状态的节点设置为断点，让程序暂停在该位置，此时测试代码与WinAppDriver建立的WebDriver会话处于活跃状态
• 从当前激活的WebDriver实例中获取会话ID：
  • C# 测试框架下读取driver.SessionId.ToString()
  • Python 测试框架下读取driver.session_id
  • Java 测试框架下读取driver.getSessionId().toString()

可直接复用的Postman请求配置 #

所有请求遵循W3C WebDriver标准协议，无需额外适配即可直接对接WinAppDriver：

获取当前应用完整UI层级结构 #

提前拿到全量UI树是快速写对XPath的核心，可避免无意义的盲目试错

• 请求方法：GET
• 请求URL：http://127.0.0.1:4723/session/[替换为你的会话ID]/source
• 无需配置请求体，发送后会返回当前目标状态下的应用完整UI XML树，可直接对照节点属性编写匹配的XPath表达式

验证指定XPath的定位有效性 #

用来反复测试不同XPath写法的匹配结果

• 请求方法：POST
• 请求URL：http://127.0.0.1:4723/session/[替换为你的会话ID]/element
• 请求头设置：Content-Type: application/json
• 请求体格式：

{
  "using": "xpath",
  "value": "待调试的XPath表达式"
}

• 返回规则：
  • 成功匹配元素时，返回对应元素的唯一标识ID
  • 无匹配结果时，返回标准NoSuchElement错误

校验匹配到的元素是否符合预期 #

避免XPath错配到同层级的其他相似元素

• 拿到上一步返回的元素ID后，发送请求读取元素的文本、属性等信息
• 请求方法：GET
• 请求URL：http://127.0.0.1:4723/session/[替换为你的会话ID]/element/[上一步返回的元素ID]/text

常见问题说明 #

• 请求URL中必须填入正确的会话ID，缺少会话ID的请求会直接返回404，无法关联到当前运行的被测应用
• 请求体中的using参数需严格写为小写的xpath，旧版本WinAppDriver对大写格式的枚举值存在兼容识别问题
• 程序触发断点暂停后，只要不跳过断点、不终止测试进程，WinAppDriver侧的会话不会触发超时回收，可连续发送数十次调试请求，全程不需要重新启动应用、重复执行60-90秒的应用状态加载流程
• 如果调试过程中提示会话失效，可检查WinAppDriver的全局会话超时配置，调试阶段可适当调长超时阈值

内容的提问来源于stack exchange，提问作者BruceK