Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
927a643b
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
927a643b
编写于
10月 14, 2022
作者:
Z
zhouke
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
modify.Signed-off-by: <zhouke35@huawei.com>.
Signed-off-by:
N
zhouke
<
zhouke35@huawei.com
>
上级
eb4becde
变更
3
显示空白变更内容
内联
并排
Showing
3 changed file
with
84 addition
and
69 deletion
+84
-69
zh-cn/application-dev/reference/apis/js-apis-uitest.md
zh-cn/application-dev/reference/apis/js-apis-uitest.md
+30
-30
zh-cn/application-dev/reference/errorcodes/errorcode-uitest.md
.../application-dev/reference/errorcodes/errorcode-uitest.md
+54
-20
zh-cn/application-dev/reference/errorcodes/errorcodes-zlib.md
...n/application-dev/reference/errorcodes/errorcodes-zlib.md
+0
-19
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-uitest.md
浏览文件 @
927a643b
...
...
@@ -8,9 +8,9 @@ UiTest提供模拟UI操作的能力,供开发者在测试场景使用,主要
-
[
Component<sup>9+</sup>
](
#component9
)
:代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。
-
[
Driver<sup>9+</sup>
](
#driver9
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。
-
[
UiWindow<sup>9+</sup>
](
#uiwindow9
)
:入口类,提供窗口属性获取,窗口拖动、调整窗口大小等能能力。
-
[
By
](
#by
)
:提供控件特征描述能力,用于控件筛选匹配查找。从API version9开始不再维护,建议使用
[
[On<sup>9+</sup>
](
#on9
)
](#
D
river9)。
-
[
By
](
#by
)
:提供控件特征描述能力,用于控件筛选匹配查找。从API version9开始不再维护,建议使用
[
[On<sup>9+</sup>
](
#on9
)
](#
d
river9)。
-
[
UiComponent
](
#uicomponent
)
:代表UI界面上的指定控件,提供控件属性获取,控件点击,滑动查找,文本注入等能力。从API version9开始不再维护,建议使用
[
Component<sup>9+</sup>
](
#component9
)
。
-
[
UiDriver
](
#uidriver
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。从API version9开始不再维护,建议使用
[
Driver<sup>9+</sup>
](
#
D
river9
)
。
-
[
UiDriver
](
#uidriver
)
:入口类,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等能能力。从API version9开始不再维护,建议使用
[
Driver<sup>9+</sup>
](
#
d
river9
)
。
>**说明:**
>
...
...
@@ -1279,7 +1279,7 @@ findComponent(on: On): Promise\<Component>
| 类型 | 说明 |
| ---------------------------------- | --------------------------------- |
| Promise
\<
[
Component
](
#
C
omponent9
)
> | 以Promise形式返回找到的控件对象。 |
| Promise
\<
[
Component
](
#
c
omponent9
)
> | 以Promise形式返回找到的控件对象。 |
**错误码:**
...
...
@@ -1316,7 +1316,7 @@ findComponents(on: On): Promise\<Array\<Component>>
| 类型 | 说明 |
| ------------------------------------------ | --------------------------------------- |
| Promise
\<
Array
\<
[
Component
](
#
C
omponent9
)
>> | 以Promise形式返回找到的控件对象的列表。 |
| Promise
\<
Array
\<
[
Component
](
#
c
omponent9
)
>> | 以Promise形式返回找到的控件对象的列表。 |
**错误码:**
...
...
@@ -1391,7 +1391,7 @@ waitForComponent(on: On, time: number): Promise\<Component>
| 类型 | 说明 |
| --------------------------------- | --------------------------------- |
| Promise
\<
[
Component
](
#
C
omponent
)
> | 以Promise形式返回找到的控件对象。 |
| Promise
\<
[
Component
](
#
c
omponent
)
> | 以Promise形式返回找到的控件对象。 |
**错误码:**
...
...
@@ -2658,7 +2658,7 @@ async function demo() {
UiTest框架通过By类提供了丰富的控件特征描述API,用于进行控件筛选来匹配/查找出目标控件。
<br>
By提供的API能力具有以下几个特点:
<br>
1、支持单属性匹配和多属性组合匹配,例如同时指定目标控件text和id。
<br>
2、控件属性支持多种匹配模式。
<br>
3、支持控件绝对定位,相对定位,可通过
[
By.isBefore
](
#isbefore
)
和
[
By.isAfter
](
#isafter
)
等API限定邻近控件特征进行辅助定位。
<br>
By类提供的所有API均为同步接口,建议使用者通过静态构造器BY来链式创建By对象。
从API version9开始不再维护,建议使用
[
On<sup>9+</sup>
](
#
O
n9
)
。
从API version9开始不再维护,建议使用
[
On<sup>9+</sup>
](
#
o
n9
)
。
```
js
BY
.
text
(
'
123
'
).
type
(
'
button
'
)
...
...
@@ -2928,7 +2928,7 @@ isBefore(by: By): By
指定目标控件位于给出的特征属性控件之前,返回By对象自身。
从API version9开始不再维护,建议使用
[
isBefore<sup>9+</sup>
](
#is
B
efore9
)
。
从API version9开始不再维护,建议使用
[
isBefore<sup>9+</sup>
](
#is
b
efore9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -2956,7 +2956,7 @@ isAfter(by: By): By
指定目标控件位于给出的特征属性控件之后,返回By对象自身。
从API version9开始不再维护,建议使用
[
isAfter<sup>9+</sup>
](
#is
A
fter9
)
。
从API version9开始不再维护,建议使用
[
isAfter<sup>9+</sup>
](
#is
a
fter9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3011,7 +3011,7 @@ doubleClick(): Promise\<void>
控件对象进行双击操作。
从API version9开始不再维护,建议使用
[
doubleClick<sup>9+</sup>
](
#double
C
lick9
)
。
从API version9开始不再维护,建议使用
[
doubleClick<sup>9+</sup>
](
#double
c
lick9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3031,7 +3031,7 @@ longClick(): Promise\<void>
控件对象进行长按操作。
从API version9开始不再维护,建议使用
[
longClick<sup>9+</sup>
](
#long
C
lick9
)
。
从API version9开始不再维护,建议使用
[
longClick<sup>9+</sup>
](
#long
c
lick9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3051,7 +3051,7 @@ getId(): Promise\<number>
获取控件对象的id值。
从API version9开始不再维护,建议使用
[
getId<sup>9+</sup>
](
#get
I
d9
)
。
从API version9开始不再维护,建议使用
[
getId<sup>9+</sup>
](
#get
i
d9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3103,7 +3103,7 @@ getText(): Promise\<string>
获取控件对象的文本信息。
从API version9开始不再维护,建议使用
[
getText<sup>9+</sup>
](
#get
T
ext9
)
。
从API version9开始不再维护,建议使用
[
getText<sup>9+</sup>
](
#get
t
ext9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3129,7 +3129,7 @@ getType(): Promise\<string>
获取控件对象的控件类型。
从API version9开始不再维护,建议使用
[
getType<sup>9+</sup>
](
#get
T
ype9
)
。
从API version9开始不再维护,建议使用
[
getType<sup>9+</sup>
](
#get
t
ype9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3155,7 +3155,7 @@ isClickable(): Promise\<boolean>
获取控件对象可点击状态。
从API version9开始不再维护,建议使用
[
isClickable<sup>9+</sup>
](
#is
C
lickable9
)
。
从API version9开始不再维护,建议使用
[
isClickable<sup>9+</sup>
](
#is
c
lickable9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3186,7 +3186,7 @@ isScrollable(): Promise\<boolean>
获取控件对象可滑动状态。
从API version9开始不再维护,建议使用
[
isScrollable<sup>9+</sup>
](
#is
S
crollable9
)
。
从API version9开始不再维护,建议使用
[
isScrollable<sup>9+</sup>
](
#is
s
crollable9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3218,7 +3218,7 @@ isEnabled(): Promise\<boolean>
获取控件使能状态。
从API version9开始不再维护,建议使用
[
isEnabled<sup>9+</sup>
](
#is
E
nabled9
)
。
从API version9开始不再维护,建议使用
[
isEnabled<sup>9+</sup>
](
#is
e
nabled9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3250,7 +3250,7 @@ isFocused(): Promise\<boolean>
判断控件对象是否获焦。
从API version9开始不再维护,建议使用
[
isFocused<sup>9+</sup>
](
#is
F
ocused9
)
。
从API version9开始不再维护,建议使用
[
isFocused<sup>9+</sup>
](
#is
f
ocused9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3281,7 +3281,7 @@ isSelected(): Promise\<boolean>
获取控件对象被选中状态。
从API version9开始不再维护,建议使用
[
isSelected<sup>9+</sup>
](
#is
S
elected9
)
。
从API version9开始不再维护,建议使用
[
isSelected<sup>9+</sup>
](
#is
s
elected9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3312,7 +3312,7 @@ inputText(text: string): Promise\<void>
向控件中输入文本(适用于文本框控件)。
从API version9开始不再维护,建议使用
[
inputText<sup>9+</sup>
](
#input
T
ext9
)
。
从API version9开始不再维护,建议使用
[
inputText<sup>9+</sup>
](
#input
t
ext9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3338,7 +3338,7 @@ scrollSearch(by: By): Promise\<UiComponent>
在控件上滑动查找目标控件(适用于List等支持滑动的控件)。
从API version9开始不再维护,建议使用
[
scrollSearch<sup>9+</sup>
](
#scroll
S
earch9
)
。
从API version9开始不再维护,建议使用
[
scrollSearch<sup>9+</sup>
](
#scroll
s
earch9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3369,7 +3369,7 @@ async function demo() {
UiDriver类为uitest测试框架的总入口,提供控件匹配/查找,按键注入,坐标点击/滑动,截图等API。
该类提供的方法除UiDriver.create()以外的所有方法都使用Promise方式作为异步方法,需使用await调用。
从API version9开始不再维护,建议使用
[
Driver<sup>9+</sup>
](
#
D
river9
)
。
从API version9开始不再维护,建议使用
[
Driver<sup>9+</sup>
](
#
d
river9
)
。
### create<sup>(deprecated)</sup>
...
...
@@ -3401,7 +3401,7 @@ delayMs(duration: number): Promise\<void>
UiDriver对象在给定的时间内延时。
从API version9开始不再维护,建议使用
[
delayMs<sup>9+</sup>
](
#delay
M
s9
)
。
从API version9开始不再维护,建议使用
[
delayMs<sup>9+</sup>
](
#delay
m
s9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3426,7 +3426,7 @@ findComponent(by: By): Promise\<UiComponent>
在UiDriver对象中,根据给出的目标控件属性要求查找目标控件。
从API version9开始不再维护,建议使用
[
findComponent<sup>9+</sup>
](
#find
C
omponent9
)
。
从API version9开始不再维护,建议使用
[
findComponent<sup>9+</sup>
](
#find
c
omponent9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3457,7 +3457,7 @@ findComponents(by: By): Promise\<Array\<UiComponent>>
在UiDriver对象中,根据给出的目标控件属性要求查找出所有匹配控件,以列表保存。
从API version9开始不再维护,建议使用
[
findComponents<sup>9+</sup>
](
#find
C
omponents9
)
。
从API version9开始不再维护,建议使用
[
findComponents<sup>9+</sup>
](
#find
c
omponents9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3488,7 +3488,7 @@ assertComponentExist(by: By): Promise\<void>
断言API,用于断言当前界面存在满足给出的目标控件属性的控件; 如果控件不存在,该API将抛出JS异常,使当前测试用例失败。
从API version9开始不再维护,建议使用
[
assertComponentExist<sup>9+</sup>
](
#assert
ComponentE
xist9
)
。
从API version9开始不再维护,建议使用
[
assertComponentExist<sup>9+</sup>
](
#assert
componente
xist9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3513,7 +3513,7 @@ pressBack(): Promise\<void>
UiDriver对象进行点击BACK键的操作。
从API version9开始不再维护,建议使用
[
pressBack<sup>9+</sup>
](
#press
B
ack9
)
。
从API version9开始不再维护,建议使用
[
pressBack<sup>9+</sup>
](
#press
b
ack9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3532,7 +3532,7 @@ triggerKey(keyCode: number): Promise\<void>
UiDriver对象采取如下操作:通过key值找到对应键并点击。
从API version9开始不再维护,建议使用
[
triggerKey<sup>9+</sup>
](
#trigger
K
ey9
)
。
从API version9开始不再维护,建议使用
[
triggerKey<sup>9+</sup>
](
#trigger
k
ey9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3584,7 +3584,7 @@ doubleClick(x: number, y: number): Promise\<void>
UiDriver对象采取如下操作:在目标坐标点双击。
从API version9开始不再维护,建议使用
[
doubleClick<sup>9+</sup>
](
#double
C
lick9
)
。
从API version9开始不再维护,建议使用
[
doubleClick<sup>9+</sup>
](
#double
c
lick9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3610,7 +3610,7 @@ longClick(x: number, y: number): Promise\<void>
UiDriver对象采取如下操作:在目标坐标点长按下鼠标左键。
从API version9开始不再维护,建议使用
[
longClick<sup>9+</sup>
](
#long
C
lick9
)
。
从API version9开始不再维护,建议使用
[
longClick<sup>9+</sup>
](
#long
c
lick9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
@@ -3664,7 +3664,7 @@ screenCap(savePath: string): Promise\<boolean>
UiDriver对象采取如下操作:捕获当前屏幕,并保存为PNG格式的图片至给出的保存路径中。
从API version9开始不再维护,建议使用
[
screenCap<sup>9+</sup>
](
#screen
C
ap9
)
。
从API version9开始不再维护,建议使用
[
screenCap<sup>9+</sup>
](
#screen
c
ap9
)
。
**系统能力**
:SystemCapability.Test.UiTest
...
...
zh-cn/application-dev/reference/errorcodes/errorcode-uitest.md
浏览文件 @
927a643b
...
...
@@ -2,52 +2,86 @@
## 17000001 初始化失败
### 错误信息
**错误信息**
Initialize failed.
### 错误描述
**错误描述**
框架初始化失败。
### 可能原因
**可能原因**
无法连接到无障碍服务。
### 处理步骤
**处理步骤**
执行param set persist.ace.testmode.enabled 1,并重启设备。
## 17000002 当前无法调用
### 错误信息
**错误信息**
API does not allow calling concurrently.
### 错误描述
**错误描述**
当前无法调用API。
### 可能原因
**可能原因**
API没有使用await进行异步调用,造成堵塞。
### 处理步骤
**处理步骤**
检查测试用例,确保异步接口使用await调用。
## 17000003 断言失败
### 错误信息
**错误信息**
Component existence assertion failed.
### 错误描述
**错误描述**
用户断言失败。
### 可能原因
**可能原因**
用户断言存在的控件实际不存在。
### 处理步骤
**处理步骤**
检查用户断言存在的控件实际是否存在。
## 17000004 目标控件/窗口丢失
### 错误信息
**错误信息**
Component lost/UiWindow lost.
### 错误描述
**错误描述**
目标控件/窗口丢失,无法进行操作。
### 可能原因
**可能原因**
获取到目标控件/窗口后,页面发生变化导致目标丢失。
### 处理步骤
**处理步骤**
检查获取到目标控件/窗口后,页面是否发生变化导致目标丢失。
## 17000005 操作不支持
### 错误信息
**错误信息**
This operation is not supported.
### 错误描述
**错误描述**
UI对象不支持该操作。
### 可能原因
**可能原因**
当前界面控件/窗口属性不支持该操作。
### 处理步骤
**处理步骤**
检查当前界面控件/窗口属性是否该操作。
zh-cn/application-dev/reference/errorcodes/errorcodes-zlib.md
浏览文件 @
927a643b
# zlib子系统错误码
## 401 参数检查错误
**错误信息**
The parameter invalid.
**错误描述**
当调用zlib的compress及decompress接口时,若传入参数的类型或者范围不匹配,会报此错误码。
**可能原因**
1.
入参类型错误不匹配,如传入的文件路径类型不是strinf。
2.
入参范围不匹配,如传入的options中包含的枚举不存在。
**处理步骤**
检查入参类型和范围是否匹配。
## 900001 传入的源文件错误
**错误信息**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录