UIDevTools:新增节点屏幕边界和设备缩放因子查询API

提交: e280b837 | 2025-07-11 09:58:52+00:00

← 返回列表

UIDevTools:新增节点屏幕边界和设备缩放因子查询API

Moderate
提交哈希: e280b83706655d98da37c7dd30a8a412a514a77c
提交时间: 2025-07-11 09:58:52+00:00
影响等级: Moderate
生成工具: webview2-upstream-sentry
上游审核链接: 查看上游审核 🔗

📋 摘要

本次提交为UIDevTools的DOM协议添加了两个新的查询命令:getNodeBoundsInScreen(获取指定节点在屏幕坐标系中的边界)和getDeviceScaleFactor(获取窗口的设备缩放因子)。这些API主要用于自动化UI测试和调试场景,帮助开发者观察视图元素在屏幕上的位置和缩放信息。变更涉及protocol.json协议定义、DOM代理实现、以及UIElement基类和各种具体元素类(WindowElement、ViewElement、WidgetElement等)的新方法实现。所有变更均为查询性质,不会影响现有API或UI行为。

🎯 影响分析

对终端用户:此次变更对终端用户无任何直接影响,因为这些API仅用于开发工具和自动化测试目的,不会改变Chrome浏览器的任何用户界面或功能。对开发者:此次变更为Web开发者和Chrome扩展开发者提供了重要的调试和测试能力增强。getNodeBoundsInScreen API使开发者能够准确获取UI元素在屏幕上的实际位置,这对于验证布局行为、编写自动化测试脚本以及调试跨设备显示问题非常有价值。getDeviceScaleFactor API则帮助开发者理解不同显示配置下的缩放情况,对于处理高DPI显示器或多显示器环境下的UI一致性问题特别重要。这些功能特别适用于使用UIDevTools进行Chrome内部UI组件测试的场景。

受影响的类:

DOMAgent UIElement WindowElement ViewElement WidgetElement RootElement FakeUIElement