新增uitest事件监听4个接口 · Pull Request !1108 · OpenHarmony/testfwk_arkxtest

1. 新增uitest事件监听4个接口
[新需求]: 新增uitest事件监听4个接口
https://gitee.com/openharmony/testfwk_arkxtest/issues/ICPFT1
---
### 修改描述
新增接口：
WindowChangeType
ComponentEventType
WindowChangeOptions
ComponentEventOptions
UIElementInfo 扩展部分可选属性
UIEventObserver新增4个once方法：
once(type: 'windowChange', windowChangeType: WindowChangeType, options: WindowChangeOptions, callback: Callback<UIElementInfo>): void;
once(type: 'windowChange', windowChangeType: WindowChangeType, callback: Callback<UIElementInfo>): void;
once(type: 'componentEventOccur', componentEventType: ComponentEventType, options: ComponentEventOptions, callback: Callback<UIElementInfo>): void;
once(type: 'componentEventOccur', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void;

### 自测试报告截图（XTS/TDD）

# UiTest接口测试

| Name | Description | Result | Reason | Api |
| ------------------------------------------- | :----------------------------------------------------------- | ------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| uiDriverTestFindComponent | 测试原有接口findComponent是否被影响 | pass | / | findComponent(on: On): Promise<Component>; |
| uiDriverTestToastShow | 测试原有接口toasShow监听是否被影响 | pass | / | once(type: '**toastShow**', callback: Callback<UIElementInfo>): void; |
| uiDriverTestDialogShow | 测试原有接口dialogShow监听是否被影响 | pass | / | once(type: '**dialogShow**', callback: Callback<UIElementInfo>): void; |
| uiDriverTestWindowAdd | WindowChangeType：WINDOW_ADDED | pass | / | once(type: '**windowChange**', windowChangeType: WindowChangeType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestWindowRemove | WindowChangeType: WINDOW_REMOVED | pass | / | once(type: '**windowChange**', windowChangeType: WindowChangeType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestWindowUpdate | WindowChangeType: WINDOW_BOUNDS_CHANGED | nopass | 调用窗口resize(), moveWindowTo()接口没有触发监听 | once(type: '**windowChange**', windowChangeType: WindowChangeType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestWindowAddWithOptions | WindowChangeType：WINDOW_ADDED WindowChangeOptions：{ bundleName: 应用包名, timeout:3000} | nopass | 2025.8.18master代码编译验证：AccessibilityEventInfo &eventInfo获取的窗口所属bundleName为空 | once(type: '**windowChange**', windowChangeType: WindowChangeType, options: WindowChangeOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestWindowRemoveWithOptions | WindowChangeType：WINDOW_REMOVED WindowChangeOptions：{ bundleName: 应用包名, timeout:3000} | nopass | 2025.8.18master代码编译验证：AccessibilityEventInfo &eventInfo获取的窗口所属bundleName为空 | once(type: '**windowChange**', windowChangeType: WindowChangeType, options: WindowChangeOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestWindowUpdateWithOptions | WindowChangeType：WINDOW_BOUNDS_CHANGED WindowChangeOptions：{ bundleName: 应用包名, timeout:3000} | nopass | 调用窗口resize(), moveWindowTo()接口没有触发监听 | once(type: '**windowChange**', windowChangeType: WindowChangeType, options: WindowChangeOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentClicked | ComponentEventType：COMPONENT_CLICKED | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentClickedWithOptions | ComponentEventType：COMPONENT_CLICKED ComponentEventOptions = { timeout: 3000, on: ON.type('Button').id('componentClick').text('testButton', MatchPattern.STARTS_WITH) } | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, options: ComponentEventOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentLongClicked | ComponentEventType：COMPONENT_LONG_CLICKED | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentLongClickedWithOptions | ComponentEventType：COMPONENT_LONG_CLICKED ComponentEventOptions = { timeout: 3000, on: ON.type('Button').id('longClick').inWindow('com.example.myapplication') } | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, options: ComponentEventOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentScrollStart | ComponentEventType：COMPONENT_SCROLL_START | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentScrollStartWithOptions | ComponentEventType：COMPONENT_SCROLL_START ComponentEventOptions = { timeout: 5000, on: ON.id('scrollTest').scrollable(true) } | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, options: ComponentEventOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentScrollEnd | ComponentEventType：COMPONENT_SCROLL_END | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentScrollEndWithOptions | ComponentEventType：COMPONENT_SCROLL_END ComponentEventOptions = { timeout: 3000, on: ON.id('scrollTest').type('Scroll').scrollable(true) } | pass | / | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, options: ComponentEventOptions, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentTextChanged | ComponentEventType：COMPONENT_TEXT_CHANGED | nopass | 使用InputText修改组件text没有触发回调；使用Text组件修改组件信息也没有触发回调 | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentTextChangedWithOptions | ComponentEventType：COMPONENT_TEXT_CHANGED ComponentEventOptions = { timeout: 5000, on: ON.id('textInput')} | nopass | 使用InputText修改组件text没有触发回调；使用Text组件修改组件信息也没有触发回调 | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentHoverEnter | ComponentEventType：COMPONENT_HOVER_ENTER | nopass | 使用Column设置.hoverEffect(HoverEffect.Scale) .onHover((isHover?: boolean) => { console.info('Scale isHover: ' + isHover as string) })打印出onHover中的数据但是没有触发回调 | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentHoverEnterWithOptions | ComponentEventType：COMPONENT_HOVER_ENTER ComponentEventOptions = { timeout: 5000, on: ON.id('testHoverText') } | nopass | 使用Column设置.hoverEffect(HoverEffect.Scale) .onHover((isHover?: boolean) => { console.info('Scale isHover: ' + isHover as string) })打印出onHover中的数据但是没有触发回调 | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentHoverExit | ComponentEventType：COMPONENT_HOVER_EXIT | nopass | 使用Column设置.hoverEffect(HoverEffect.Scale) .onHover((isHover?: boolean) => { console.info('Scale isHover: ' + isHover as string) })打印出onHover中的数据但是没有触发回调 | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |
| uiDriverTestComponentHoverExitWithOptions | ComponentEventType：COMPONENT_HOVER_EXIT ComponentEventOptions = { timeout: 5000, on: ON.id('testHoverText')} | nopass | 使用Column设置.hoverEffect(HoverEffect.Scale) .onHover((isHover?: boolean) => { console.info('Scale isHover: ' + isHover as string) })打印出onHover中的数据但是没有触发回调 | once(type: '**componentEventOccur**', componentEventType: ComponentEventType, callback: Callback<UIElementInfo>): void; |

类型	指派人员	状态
审查	@ry 由 CODEOWNERS 文件第 13 行指派为审查者	进行中 (0/1人)
审查	雷丹	进行中 (0/1人)
测试	openharmony_ci	进行中 (0/1人)

OpenHarmony/testfwk_arkxtest关闭 .gitee-modal { width: 500px !important; }

搜索帮助

OpenHarmony/testfwk_arkxtest
关闭