Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
796a106e
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看板
提交
796a106e
编写于
2月 16, 2022
作者:
Z
zengyawen
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs
Signed-off-by:
N
zengyawen
<
zengyawen1@huawei.com
>
上级
f19488de
变更
38
展开全部
隐藏空白更改
内联
并排
Showing
38 changed file
with
7344 addition
and
6561 deletion
+7344
-6561
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+5
-3
zh-cn/application-dev/reference/apis/js-apis-abilityAccessCtrl.md
...plication-dev/reference/apis/js-apis-abilityAccessCtrl.md
+219
-0
zh-cn/application-dev/reference/apis/js-apis-arraylist.md
zh-cn/application-dev/reference/apis/js-apis-arraylist.md
+468
-411
zh-cn/application-dev/reference/apis/js-apis-bytrace.md
zh-cn/application-dev/reference/apis/js-apis-bytrace.md
+64
-62
zh-cn/application-dev/reference/apis/js-apis-call.md
zh-cn/application-dev/reference/apis/js-apis-call.md
+214
-215
zh-cn/application-dev/reference/apis/js-apis-convertxml.md
zh-cn/application-dev/reference/apis/js-apis-convertxml.md
+4
-0
zh-cn/application-dev/reference/apis/js-apis-deque.md
zh-cn/application-dev/reference/apis/js-apis-deque.md
+193
-173
zh-cn/application-dev/reference/apis/js-apis-device-info.md
zh-cn/application-dev/reference/apis/js-apis-device-info.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-faultLogger.md
zh-cn/application-dev/reference/apis/js-apis-faultLogger.md
+22
-17
zh-cn/application-dev/reference/apis/js-apis-hashmap.md
zh-cn/application-dev/reference/apis/js-apis-hashmap.md
+272
-240
zh-cn/application-dev/reference/apis/js-apis-hashset.md
zh-cn/application-dev/reference/apis/js-apis-hashset.md
+175
-155
zh-cn/application-dev/reference/apis/js-apis-hiappevent.md
zh-cn/application-dev/reference/apis/js-apis-hiappevent.md
+73
-66
zh-cn/application-dev/reference/apis/js-apis-hichecker.md
zh-cn/application-dev/reference/apis/js-apis-hichecker.md
+56
-56
zh-cn/application-dev/reference/apis/js-apis-hitracechain.md
zh-cn/application-dev/reference/apis/js-apis-hitracechain.md
+141
-116
zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md
zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md
+64
-62
zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md
.../application-dev/reference/apis/js-apis-lightweightmap.md
+403
-351
zh-cn/application-dev/reference/apis/js-apis-lightweightset.md
.../application-dev/reference/apis/js-apis-lightweightset.md
+332
-290
zh-cn/application-dev/reference/apis/js-apis-linkedlist.md
zh-cn/application-dev/reference/apis/js-apis-linkedlist.md
+472
-416
zh-cn/application-dev/reference/apis/js-apis-list.md
zh-cn/application-dev/reference/apis/js-apis-list.md
+488
-439
zh-cn/application-dev/reference/apis/js-apis-plainarray.md
zh-cn/application-dev/reference/apis/js-apis-plainarray.md
+303
-262
zh-cn/application-dev/reference/apis/js-apis-power.md
zh-cn/application-dev/reference/apis/js-apis-power.md
+54
-47
zh-cn/application-dev/reference/apis/js-apis-process.md
zh-cn/application-dev/reference/apis/js-apis-process.md
+303
-250
zh-cn/application-dev/reference/apis/js-apis-queue.md
zh-cn/application-dev/reference/apis/js-apis-queue.md
+122
-116
zh-cn/application-dev/reference/apis/js-apis-radio.md
zh-cn/application-dev/reference/apis/js-apis-radio.md
+183
-183
zh-cn/application-dev/reference/apis/js-apis-runninglock.md
zh-cn/application-dev/reference/apis/js-apis-runninglock.md
+132
-118
zh-cn/application-dev/reference/apis/js-apis-security-accessToken.md
...cation-dev/reference/apis/js-apis-security-accessToken.md
+0
-216
zh-cn/application-dev/reference/apis/js-apis-sim.md
zh-cn/application-dev/reference/apis/js-apis-sim.md
+191
-192
zh-cn/application-dev/reference/apis/js-apis-sms.md
zh-cn/application-dev/reference/apis/js-apis-sms.md
+143
-143
zh-cn/application-dev/reference/apis/js-apis-stack.md
zh-cn/application-dev/reference/apis/js-apis-stack.md
+163
-149
zh-cn/application-dev/reference/apis/js-apis-treemap.md
zh-cn/application-dev/reference/apis/js-apis-treemap.md
+341
-298
zh-cn/application-dev/reference/apis/js-apis-treeset.md
zh-cn/application-dev/reference/apis/js-apis-treeset.md
+280
-245
zh-cn/application-dev/reference/apis/js-apis-uri.md
zh-cn/application-dev/reference/apis/js-apis-uri.md
+69
-55
zh-cn/application-dev/reference/apis/js-apis-url.md
zh-cn/application-dev/reference/apis/js-apis-url.md
+237
-211
zh-cn/application-dev/reference/apis/js-apis-useriam-userauth.md
...pplication-dev/reference/apis/js-apis-useriam-userauth.md
+3
-0
zh-cn/application-dev/reference/apis/js-apis-util.md
zh-cn/application-dev/reference/apis/js-apis-util.md
+3
-0
zh-cn/application-dev/reference/apis/js-apis-vector.md
zh-cn/application-dev/reference/apis/js-apis-vector.md
+600
-530
zh-cn/application-dev/reference/apis/js-apis-worker.md
zh-cn/application-dev/reference/apis/js-apis-worker.md
+304
-262
zh-cn/application-dev/reference/apis/js-apis-xml.md
zh-cn/application-dev/reference/apis/js-apis-xml.md
+246
-210
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
796a106e
...
...
@@ -20,7 +20,7 @@
-
[
媒体服务
](
js-apis-media.md
)
-
安全
-
[
用户认证
](
js-apis-useriam-userauth.md
)
-
[
访问控制
](
js-apis-
security-accessToken
.md
)
-
[
访问控制
](
js-apis-
abilityAccessCtrl
.md
)
-
数据管理
-
[
轻量级存储
](
js-apis-data-storage.md
)
-
[
分布式数据管理
](
js-apis-distributed-data.md
)
...
...
@@ -68,13 +68,15 @@
-
[
定时器
](
js-apis-basic-features-timer.md
)
-
[
设置系统时间
](
js-apis-system-time.md
)
-
[
动画
](
js-apis-basic-features-animator.md
)
-
[
WebGL
](
js-apis-webgl.md
)
-
[
WebGL2
](
js-apis-webgl2.md
)
-
DFX
-
[
应用打点
](
js-apis-hiappevent.md
)
-
[
性能打点
](
js-apis-hitracemeter.md
)
-
[
故障日志获取
](
js-apis-faultLogger.md
)
-
[
分布式跟踪
](
js-apis-hitracechain.md
)
-
[
日志打印
](
js-apis-hilog.md
)
-
[
WebGL
](
js-apis-webgl.md
)
-
[
WebGL2
](
js-apis-webgl2.md
)
-
[
检测模式
](
js-apis-hichecker.md
)
-
语言基础类库
-
[
获取进程相关的信息
](
js-apis-process.md
)
-
[
URL字符串解析
](
js-apis-url.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-abilityAccessCtrl.md
0 → 100644
浏览文件 @
796a106e
# 访问控制管理
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import abilityAccessCtrl from '@ohos.abilityAccessCtrl'
```
## 系统能力
SystemCapability.Security.AccessToken
## abilityAccessCtrl.createAtManager
createAtManager(): AtManager
访问控制管理:获取访问控制模块对象。
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
|
[
AtManager
](
#atmanager
)
| 获取访问控制模块的实例。 |
**示例:**
```
var AtManager = abilityAccessCtrl.createAtManager();
```
## AtManager
管理访问控制模块的实例。
### verifyAccessToken
verifyAccessToken(tokenID: number, permissionName: string): Promise
<
GrantStatus
>
校验应用是否授予权限,使用Promise方式异步返回结果。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ------------------------------------------ |
| tokenID | number | 是 | 要校验的目标应用的身份标识。 |
| permissionName | string | 是 | 需要校验的权限名称。 |
**返回值:**
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
GrantStatus
>
| Promise实例,用于获取异步返回的授权状态结果。 |
**示例:**
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.verifyAccessToken(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
### grantUserGrantedPermission
grantUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number): Promise
<
number
>
授予应用user grant权限,使用Promise方式异步返回结果。
需要权限:ohos.permission.GRANT_SENSITIVE_PERMISSIONS。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被授予的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
**返回值:**
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
number
>
| Promise实例,用于获取异步返回的授权操作结果。 |
**示例:**
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.grantUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
### grantUserGrantedPermission
grantUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number, callback: AsyncCallback
<
number
>
): void
授予应用user grant权限,使用callback回调异步返回结果。
需要权限:ohos.permission.GRANT_SENSITIVE_PERMISSIONS。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被授予的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
| callback | AsyncCallback
<
number
>
| 是 | 检查授予应用user grant权限的操作结果同步的回调。 |
**示例:**
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
AtManager.grantUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag, data => {
console.log(`callback: data->${JSON.stringify(data)}`);
});
```
### revokeUserGrantedPermission
revokeUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number): Promise
<
number
>
撤销应用user grant权限,使用Promise方式异步返回结果。
需要权限:ohos.permission.REVOKE_SENSITIVE_PERMISSIONS。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被撤销的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
**返回值:**
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
number
>
| Promise实例,用于获取异步返回的授权操作结果。 |
**示例:**
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
let promise = AtManager.revokeUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS", permissionFlag);
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
### revokeUserGrantedPermission
revokeUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number, callback: AsyncCallback
<
number
>
): void
撤销应用user grant权限,使用callback回调异步返回结果。
需要权限:ohos.permission.REVOKE_SENSITIVE_PERMISSIONS。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被撤销的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
| callback | AsyncCallback
<
number
>
| 是 | 检查撤销应用user grant权限的操作结果同步的回调。 |
**示例:**
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
AtManager.revokeUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag, data => {
console.log(`callback: data->${JSON.stringify(data)}`);
});
```
### getPermissionFlags
getPermissionFlags(tokenID: number, permissionName: string): Promise
<
number
>
获取指定应用的指定权限的flag,使用Promise方式异步返回结果。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 查询的权限名称。 |
**返回值:**
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
number
>
| Promise实例,用于获取异步返回的查询结果。 |
**示例:**
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.getPermissionFlags(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-arraylist.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bytrace.md
浏览文件 @
796a106e
...
...
@@ -23,22 +23,23 @@ startTrace(name: string, taskId: number, expectedTime?: number): void
标记一个预追踪耗时任务的开始,expectedTime是可选参数,标识该任务的期望耗时。
**参数:**
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
| expectedTime | number | 否 | 期望的耗时时间,单位:ms |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
| expectedTime | number | 否 | 期望的耗时时间,单位:ms |
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的任务是串行执行的,则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的任务是串行执行的,则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。
-
示例:
```
bytrace.startTrace("myTestFunc", 1);
bytrace.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
```
**示例:**
```
bytrace.startTrace("myTestFunc", 1);
bytrace.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
```
## bytrace.finishTrace
...
...
@@ -47,42 +48,43 @@ finishTrace(name: string, taskId: number): void
标记一个预追踪耗时任务的结束。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
-
示例:
```
bytrace.finishTrace("myTestFunc", 1);
```
```
//追踪并行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
//业务流程......
bytrace.startTrace("myTestFunc", 2); //第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同。
//业务流程......
bytrace.finishTrace("myTestFunc", 1);
//业务流程......
bytrace.finishTrace("myTestFunc", 2);
```
```
//追踪串行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
//业务流程......
bytrace.finishTrace("myTestFunc", 1); //第一个追踪的任务结束
//业务流程......
bytrace.startTrace("myTestFunc", 1); //第二个追踪的同名任务开始,同名的待追踪任务串行执行。
//业务流程......
bytrace.finishTrace("myTestFunc", 1);
```
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
**示例:**
```
bytrace.finishTrace("myTestFunc", 1);
```
```
//追踪并行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
//业务流程......
bytrace.startTrace("myTestFunc", 2); //第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同。
//业务流程......
bytrace.finishTrace("myTestFunc", 1);
//业务流程......
bytrace.finishTrace("myTestFunc", 2);
```
```
//追踪串行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
//业务流程......
bytrace.finishTrace("myTestFunc", 1); //第一个追踪的任务结束
//业务流程......
bytrace.startTrace("myTestFunc", 1); //第二个追踪的同名任务开始,同名的待追踪任务串行执行。
//业务流程......
bytrace.finishTrace("myTestFunc", 1);
```
## bytrace.traceByValue
...
...
@@ -91,18 +93,18 @@ traceByValue(name: string, value: number): void
用来标记一个预追踪的数值变量,该变量的数值会不断变化。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的数值变量名称 |
| value | number | 是 | 变量的值 |
**示例:**
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的数值变量名称 |
| value | number | 是 | 变量的值 |
-
示例:
```
let traceCount = 3;
bytrace.traceByValue("myTestCount", traceCount);
traceCount = 4;
bytrace.traceByValue("myTestCount", traceCount);
//业务流程......
```
```
let traceCount = 3;
bytrace.traceByValue("myTestCount", traceCount);
traceCount = 4;
bytrace.traceByValue("myTestCount", traceCount);
//业务流程......
```
zh-cn/application-dev/reference/apis/js-apis-call.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-convertxml.md
浏览文件 @
796a106e
...
...
@@ -10,6 +10,10 @@
import convertxml from '@ohos.convertxml';
```
## 系统能力
SystemCapability.Utils.Lang
## ConvertXML
...
...
zh-cn/application-dev/reference/apis/js-apis-deque.md
浏览文件 @
796a106e
...
...
@@ -10,9 +10,9 @@
import Deque from '@ohos.util.Deque'
```
##
权限
##
系统能力
无
SystemCapability.Utils.Lang
## Deque
...
...
@@ -20,232 +20,252 @@ import Deque from '@ohos.util.Deque'
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| length | number | 是 | 否 | Deque的元素个数 |
| length | number | 是 | 否 | Deque的元素个数
。
|
### constructor
constructor()
;
constructor()
Deque的构造函数。
-
示例:
```
let deque = new Deque();
```
**示例:**
```
let deque = new Deque();
```
### insertFront
insertFront(element: T): void
;
insertFront(element: T): void
在deque头部插入元素。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 添加进去的元素 |
-
示例:
```
let deque = new Deque;
deque.insertFront("a");
deque.insertFront(1);
let b = [1, 2, 3];
deque.insertFront(b);
let c = {name : "lala", age : "13"};
deque.insertFront(false);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 插入的元素。 |
**示例:**
```
let deque = new Deque;
deque.insertFront("a");
deque.insertFront(1);
let b = [1, 2, 3];
deque.insertFront(b);
let c = {name : "lala", age : "13"};
deque.insertFront(false);
```
### insertEnd
insertEnd(element: T): void
;
insertEnd(element: T): void
在deque尾部插入元素。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 添加进去的元素 |
-
示例:
```
let deque = new Deque;
deque.insertEnd("a");
deque.insertEnd(1);
let b = [1, 2, 3];
deque.insertEnd(b);
let c = {name : "lala", age : "13"};
deque.insertEnd(false);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 插入的元素。 |
**示例:**
```
let deque = new Deque;
deque.insertEnd("a");
deque.insertEnd(1);
let b = [1, 2, 3];
deque.insertEnd(b);
let c = {name : "lala", age : "13"};
deque.insertEnd(false);
```
### has
has(element: T): boolean
;
has(element: T): boolean
判断此Deque中是否含有该指定元素。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 指定的元素 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 是否包含指定元素 |
-
示例:
```
let deque = new Deque();
deque.has("Ahfbrgrbgnutfodgorrogorg");
deque.insertFront("Ahfbrgrbgnutfodgorrogorg");
deque.has("Ahfbrgrbgnutfodgorrogorg");
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 指定的元素。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| boolean | 如果包含指定元素返回true,否则返回false。 |
**示例:**
```
let deque = new Deque();
deque.has("Ahfbrgrbgnutfodgorrogorg");
deque.insertFront("Ahfbrgrbgnutfodgorrogorg");
deque.has("Ahfbrgrbgnutfodgorrogorg");
```
### popFirst
popFirst(): T
;
popFirst(): T
删除并返回双端队列的首元素。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| T | 返回删除的元素 |
-
示例:
```
let deque = new Deque();
deque.insertFront(2);
deque.insertFront(4);
deque.insertEnd(5);
deque.insertFront(2);
deque.insertFront(4);
deque.popFirst();
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回被删除的元素。 |
**示例:**
```
let deque = new Deque();
deque.insertFront(2);
deque.insertFront(4);
deque.insertEnd(5);
deque.insertFront(2);
deque.insertFront(4);
deque.popFirst();
```
### popLast
popLast(): T
;
popLast(): T
删除并返回双端队列的尾元素。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| T | 返回删除的元素 |
-
示例:
```
let deque = new Deque();
deque.insertFront(2);
deque.insertEnd(4);
deque.insertFront(5);
deque.insertFront(2);
deque.insertFront(4);
deque.popLast();
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回被删除的元素。 |
**示例:**
```
let deque = new Deque();
deque.insertFront(2);
deque.insertEnd(4);
deque.insertFront(5);
deque.insertFront(2);
deque.insertFront(4);
deque.popLast();
```
### forEach
forEach(callbackfn: (value: T, index?: number, deque?: Deque
<
T
>
) => void,
thisArg?: Object): void
;
thisArg?: Object): void
通过回调函数来遍历Deque实例对象上的元素以及元素对应的下标。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数 |
| thisArg | Object | 否 | callbackfn被调用时用作this值 |
-
callbackfn的参数说明
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素 |
| index | number | 否 | 当前遍历到的下标值 |
| deque | Deque
<
T
>
| 否 | 当前调用forEach方法的实例对象 |
-
示例:
```
let deque = new Deque();
deque.insertFront(2);
deque.insertEnd(4);
deque.insertFront(5);
deque.insertEnd(4);
deque.forEach((value, index) => {
console.log(value, index);
});
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值。 |
callbackfn的参数说明:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素。 |
| index | number | 否 | 当前遍历到的下标值。 |
| deque | Deque
<
T
>
| 否 | 当前调用forEach方法的实例对象。 |
**示例:**
```
let deque = new Deque();
deque.insertFront(2);
deque.insertEnd(4);
deque.insertFront(5);
deque.insertEnd(4);
deque.forEach((value, index) => {
console.log(value, index);
});
```
### getFirst
getFirst(): T;
获取Deque实例中的头元素。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| T | 返回T型 |
-
示例:
```
let deque = new Deque();
deque.insertEnd(2);
deque.insertEnd(4);
deque.insertFront(5);
deque.insertFront(4);
deque.getFirst();
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回T型 |
**示例:**
```
let deque = new Deque();
deque.insertEnd(2);
deque.insertEnd(4);
deque.insertFront(5);
deque.insertFront(4);
deque.getFirst();
```
### getLast
getLast(): T
;
getLast(): T
获取Deque实例中的尾元素。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| T | 返回T型 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回T型 |
**示例:**
-
示例:
```
let deque = new Deque();
deque.insertFront(2);
deque.insertFront(4);
deque.insertFront(5);
deque.insertFront(4);
deque.getLast();
```
```
let deque = new Deque();
deque.insertFront(2);
deque.insertFront(4);
deque.insertFront(5);
deque.insertFront(4);
deque.getLast();
```
### [Symbol.iterator]
[Symbol.iterator]
\(
): IterableIterator
<
T
>
;
[Symbol.iterator]
\(
): IterableIterator
<
T
>
返回一个迭代器,迭代器的每一项都是一个 JavaScript 对象,并返回该对象。
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器。 |
-
示例:
```
let deque = new Deque();
deque.insertFront(2);
deque.insertFront(4);
deque.insertFront(5);
deque.insertFront(4);
// 使用方法一:
for (let item of deque) {
console.log(item);
}
// 使用方法二:
let iter = deque[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
\ No newline at end of file
**示例:**
```
let deque = new Deque();
deque.insertFront(2);
deque.insertFront(4);
deque.insertFront(5);
deque.insertFront(4);
// 使用方法一:
for (let item of deque) {
console.log(item);
}
// 使用方法二:
let iter = deque[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-device-info.md
浏览文件 @
796a106e
...
...
@@ -7,9 +7,9 @@ import deviceInfo from '@ohos.deviceInfo'
```
##
权限列表
##
系统能力
无
SystemCapability.Startup.SysInfo
## 属性
...
...
zh-cn/application-dev/reference/apis/js-apis-faultLogger.md
浏览文件 @
796a106e
...
...
@@ -14,7 +14,7 @@ SystemCapability.HiviewDFX.Hiview.FaultLogger
## FaultType
故障类型枚举
故障类型枚举
。
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
...
...
@@ -25,7 +25,7 @@ SystemCapability.HiviewDFX.Hiview.FaultLogger
## FaultLogInfo
故障信息数据结构,获取到的故障信息的数据结构
故障信息数据结构,获取到的故障信息的数据结构
。
| 名称 | 参数类型 | 说明 |
| -------- | -------- | -------- |
...
...
@@ -44,13 +44,15 @@ querySelfFaultLog(faultType: FaultType, callback: AsyncCallback<Array<Faul
获取当前进程故障信息,该方法通过回调方式获取故障信息数组,故障信息数组内最多上报10份故障信息。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| faultType |
[
FaultType
](
#faulttype
)
| 是 | 输入要查询的故障类型。 |
| callback | AsyncCallbackArray
<
Array
<
[FaultLogInfo](#faultloginfo)
>>
| 是 | 回调函数,在回调函数中获取故障信息数组。
<br/>
-
value拿到故障信息数组;value为undefined表示获取过程中出现异常,error返回错误提示字符串
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| faultType |
[
FaultType
](
#faulttype
)
| 是 | 输入要查询的故障类型。 |
| callback | AsyncCallbackArray
<
Array
<
[FaultLogInfo](#faultloginfo)
>>
| 是 | 回调函数,在回调函数中获取故障信息数组。
<br/>
-
value拿到故障信息数组;value为undefined表示获取过程中出现异常,error返回错误提示字符串
**示例:**
-
示例:
```
function queryFaultLogCallback(error, value) {
if (error) {
...
...
@@ -80,17 +82,20 @@ querySelfFaultLog(faultType: FaultType) : Promise<Array<FaultLogInfo>&g
获取当前进程故障信息,该方法通过Promise方式返回故障信息数组,故障信息数组内最多上报10份故障信息。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| faultType |
[
FaultType
](
#faulttype
)
| 是 | 输入要查询的故障类型。 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| faultType |
[
FaultType
](
#faulttype
)
| 是 | 输入要查询的故障类型。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Array
<
[FaultLogInfo](#faultloginfo)
>>
| Promise实例,可以在其then()方法中获取故障信息实例,也可以使用await。
<br/>
-
value拿到故障信息数组;value为undefined表示获取过程中出现异常 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Array
<
[FaultLogInfo](#faultloginfo)
>>
| Promise实例,可以在其then()方法中获取故障信息实例,也可以使用await。
<br/>
-
value拿到故障信息数组;value为undefined表示获取过程中出现异常 |
**示例:**
-
示例:
```
let value = await faultLogger.querySelfFaultLog(faultlogger.FaultType.JS_CRASH);
if (value) {
...
...
zh-cn/application-dev/reference/apis/js-apis-hashmap.md
浏览文件 @
796a106e
...
...
@@ -10,10 +10,9 @@
import HashMap from '@ohos.util.HashMap'
```
## 系统能力
## 权限
无
SystemCapability.Utils.Lang
## HashMap
...
...
@@ -22,359 +21,392 @@ import HashMap from '@ohos.util.HashMap'
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| length | number | 是 | 否 | HashMap的元素个数 |
| length | number | 是 | 否 | HashMap的元素个数
。
|
### constructor
constructor()
;
constructor()
HashMap的构造函数。
-
示例:
```
let hashMap = new HashMap();
```
**示例:**
```
let hashMap = new HashMap();
```
### isEmpty
isEmpty(): boolean
;
isEmpty(): boolean
判断该HashMap是否为空。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 为空返回true, 不为空返回false |
**返回值:**
-
示例:
```
const hashMap = new HashMap();
hashMap.isEmpty();
```
| 类型 | 说明 |
| -------- | -------- |
| boolean | 为空返回true,不为空返回false。 |
**示例:**
```
const hashMap = new HashMap();
hashMap.isEmpty();
```
### hasKey
hasKey(key: K): boolean
;
hasKey(key: K): boolean
判断此HashMap中是否含有该指定key。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 指定元素 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 指定Key。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 是否包含指定元素 |
**返回值:**
-
示例:
```
let hashMap = new HashMap();
hashMap.hasKey("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.hasKey("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
```
| 类型 | 说明 |
| -------- | -------- |
| boolean | 包含指定Key返回true,否则返回false。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.hasKey("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.hasKey("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
```
### hasValue
hasValue(value: V): boolean
;
hasValue(value: V): boolean
判断此HashMap中是否含有该指定value。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | V | 是 | 指定元素 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | V | 是 | 指定value。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 是否包含指定元素 |
**返回值:**
-
示例:
```
let hashMap = new HashMap();
hashMap.hasValue(123);
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.hasValue(123);
```
| 类型 | 说明 |
| -------- | -------- |
| boolean | 包含指定value返回true,否则返回false。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.hasValue(123);
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.hasValue(123);
```
### get
get(key: K): V
;
get(key: K): V
获取指定key所对应的value。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 查找的指定key |
**参数:**
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| V | 返回key映射的value值 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 查找的指定key。 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
hashMap.get("sdfs");
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| V | 返回key映射的value值。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
hashMap.get("sdfs");
```
### setAll
setAll(map: HashMap
<K
,
V
>
): void
;
setAll(map: HashMap
<K
,
V
>
): void
将一个HashMap中的所有元素组添加到另一个hashmap中。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| map | HashMap
<K
,
V
>
| 是 | 被添加元素的hashmap |
**参数:**
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let newHashMap = new HashMap();
hashMap.setAll(newHashMap);
```
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| map | HashMap
<K
,
V
>
| 是 | 被添加元素的hashmap。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let newHashMap = new HashMap();
hashMap.setAll(newHashMap);
```
### set
set(key: K, value: V): Object
;
set(key: K, value: V): Object
向HashMap中添加一组数据。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 添加成员数据的键名 |
| value | V | 是 | 添加成员数据的值 |
**参数:**
-
返回值:
| 类型 | 说明
|
| -------- | --------
|
| Object | 返回添加后的hashmap
|
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | --------
|
| key | K | 是 | 添加成员数据的键名。
|
| value | V | 是 | 添加成员数据的值。
|
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Object | 返回添加后的hashmap。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
```
### remove
remove(key: K): V
;
remove(key: K): V
删除指定的元素。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 依据key指定删除的元素 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 依据key指定删除的元素。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| V | 返回删除元素的值 |
**返回值:**
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
hashMap.remove("sdfs");
```
| 类型 | 说明 |
| -------- | -------- |
| V | 返回删除元素的值。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
hashMap.remove("sdfs");
```
### clear
clear(): void
;
clear(): void
清除HashMap中的所有元素,并把length置为0。
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
hashMap.clear();
```
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
hashMap.clear();
```
### keys
keys(): IterableIterator
<
K
>
;
keys(): IterableIterator
<
K
>
返回包含此映射中包含的键的新迭代器对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
K
>
| 返回一个迭代器 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let iter = hashMap.keys();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
K
>
| 返回一个迭代器。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let iter = hashMap.keys();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
### values
values(): IterableIterator
<
V
>
;
values(): IterableIterator
<
V
>
返回包含此映射中包含的键的新迭代器对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
V
>
| 返回一个迭代器 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let iter = hashMap.values();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
V
>
| 返回一个迭代器。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let iter = hashMap.values();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
### replace
replace(key: K, value: V): boolean
;
replace(key: K, value: V): boolean
对HashMap中一组数据进行更新(替换)。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 依据key指定替换的元素 |
| value | V | 是 | 添加成员数据的值 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | K | 是 | 依据key指定替换的元素。 |
| value | V | 是 | 添加成员数据的值。 |
**返回值:**
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 是否成功对已有数据进行替换 |
| 类型 | 说明 |
| -------- | -------- |
| boolean | 是否成功对已有数据进行替换 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("sdfs", 123);
hashMap.replace("sdfs", 357);
```
**示例:**
```
let hashMap = new HashMap();
hashMap.set("sdfs", 123);
hashMap.replace("sdfs", 357);
```
### forEach
forEach(callbackfn: (value: V, key?: K, hashMap?: HashMap
<K
,
V
>
) => void, thisArg?: Object): void
;
forEach(callbackfn: (value: V, key?: K, hashMap?: HashMap
<K
,
V
>
) => void, thisArg?: Object): void
通过回调函数来遍历HashMap实例对象上的元素以及元素对应的下标。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数 |
| thisArg | Object | 否 | callbackfn被调用时用作this值 |
-
callbackfn的参数说明
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | V | 是 | 当前遍历到的元素键值对的值 |
| key | K | 是 | 当前遍历到的元素键值对的键 |
| hashMap | HashMap
<K
,
V
>
| 否 | 当前调用forEach方法的实例对象 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("sdfs", 123);
hashMap.set("dfsghsf", 357);
hashMap.forEach((value, key) => {
console.log(value, key);
});
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值。 |
callbackfn的参数说明:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | V | 是 | 当前遍历到的元素键值对的值。 |
| key | K | 是 | 当前遍历到的元素键值对的键。 |
| hashMap | HashMap
<K
,
V
>
| 否 | 当前调用forEach方法的实例对象。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("sdfs", 123);
hashMap.set("dfsghsf", 357);
hashMap.forEach((value, key) => {
console.log(value, key);
});
```
### entries
entries(): IterableIterator
<
[
K
,
V
]
>
;
entries(): IterableIterator
<
[
K
,
V
]
>
返回包含此映射中包含的键的新迭代器对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
[
K
,
V
]
>
| 返回一个迭代器 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let iter = hashMap.entries();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp[0]);
console.log(temp[1]);
temp = iter.next().value;
}
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
[
K
,
V
]
>
| 返回一个迭代器。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
let iter = hashMap.entries();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp[0]);
console.log(temp[1]);
temp = iter.next().value;
}
```
### [Symbol.iterator]
[Symbol.iterator]
\(
): IterableIterator
<
[K, V]
>
;
[Symbol.iterator]
\(
): IterableIterator
<
[K, V]
>
返回一个迭代器,迭代器的每一项都是一个 JavaScript 对象,并返回该对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
[
K
,
V
]
>
| 返回一个迭代器 |
-
示例:
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
// 使用方法一:
for (let item of hashMap) {
console.log("key: " + item[0]);
console.log("value: " + item[1]);
}
// 使用方法二:
let iter = hashMap[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp[0]);
console.log(temp[1]);
temp = iter.next().value;
}
```
\ No newline at end of file
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
[
K
,
V
]
>
| 返回一个迭代器。 |
**示例:**
```
let hashMap = new HashMap();
hashMap.set("Ahfbrgrbgnutfodgorrogorgrogofdfdf", 123);
hashMap.set("sdfs", 356);
// 使用方法一:
for (let item of hashMap) {
console.log("key: " + item[0]);
console.log("value: " + item[1]);
}
// 使用方法二:
let iter = hashMap[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp[0]);
console.log(temp[1]);
temp = iter.next().value;
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-hashset.md
浏览文件 @
796a106e
...
...
@@ -10,9 +10,9 @@
import HashSet from '@ohos.util.HashSet';
```
##
权限
##
系统能力
无
SystemCapability.Utils.Lang
## HashSet
...
...
@@ -21,235 +21,255 @@ import HashSet from '@ohos.util.HashSet';
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| length | number | 是 | 否 | HashSet的元素个数 |
| length | number | 是 | 否 | HashSet的元素个数
。
|
### constructor
constructor()
;
constructor()
HashSet的构造函数。
-
示例:
```
let hashSet = new HashSet();
```
**示例:**
```
let hashSet = new HashSet();
```
### isEmpty
isEmpty(): boolean
;
isEmpty(): boolean
判断该HashSet是否为空。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 为空返回true, 不为空返回false |
**返回值:**
-
示例:
```
const hashSet = new HashSet();
hashSet.isEmpty();
```
| 类型 | 说明 |
| -------- | -------- |
| boolean | 为空返回true,不为空返回false。 |
**示例:**
```
const hashSet = new HashSet();
hashSet.isEmpty();
```
### has
has(value: T): boolean
;
has(value: T): boolean
判断此HashSet中是否含有该指定key。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 指定元素 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 指定元素。 |
**返回值:**
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 是否包含指定元素 |
| 类型 | 说明 |
| -------- | -------- |
| boolean | 包含指定元素返回true,否则返回false。 |
-
示例:
```
let hashSet = new HashSet();
hashSet.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
```
**示例:**
```
let hashSet = new HashSet();
hashSet.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
```
### add
add(value: T): boolean
;
add(value: T): boolean
向HashSet中添加数据。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 添加成员数据 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 添加成员数据。 |
**返回值:**
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 返回是否有成功增加元素 |
| 类型 | 说明 |
| -------- | -------- |
| boolean | 成功增加元素返回true,否则返回false。 |
-
示例:
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
```
**示例:**
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
```
### remove
remove(value: T): boolean
;
remove(value: T): boolean
删除指定的元素。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 指定删除的元素 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 指定删除的元素。 |
**返回值:**
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 返回是否成功删除指定元素 |
| 类型 | 说明 |
| -------- | -------- |
| boolean | 成功删除指定元素返回true,否则返回false。 |
-
示例:
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
hashSet.remove("sdfs");
```
**示例:**
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
hashSet.remove("sdfs");
```
### clear
clear(): void
;
clear(): void
清除HashSet中的所有元素,并把length置为0。
-
示例:
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
hashSet.clear();
```
**示例:**
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
hashSet.clear();
```
### values
values(): IterableIterator
<
T
>
;
values(): IterableIterator
<
T
>
返回包含此映射中包含的键的新迭代器对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器 |
-
示例:
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
let iter = hashSet.values();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器。 |
**示例:**
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
let iter = hashSet.values();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
### forEach
forEach(callbackfn: (value: T, key?: T, hashSet?: HashSet
<
T
>
) => void, thisArg?: Object): void
;
forEach(callbackfn: (value: T, key?: T, hashSet?: HashSet
<
T
>
) => void, thisArg?: Object): void
通过回调函数来遍历实例对象上的元素以及元素对应的下标。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数 |
| thisArg | Object | 否 | callbackfn被调用时用作this值 |
**参数:**
-
callbackfn的参数说明
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素键值对的值 |
| key | T | 否 | 当前遍历到的元素键值对的值(和value相同) |
| hashSet | HashSet
<
T
>
| 否 | 当前调用forEach方法的实例对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值。 |
callbackfn的参数说明:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素键值对的值。 |
| key | T | 否 | 当前遍历到的元素键值对的值(和value相同)。 |
| hashSet | HashSet
<
T
>
| 否 | 当前调用forEach方法的实例对象。 |
-
示例:
```
let hashSet = new HashSet();
hashSet.add("sdfs");
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.forEach((value, key) => {
console.log(value, key);
});
```
**示例:**
```
let hashSet = new HashSet();
hashSet.add("sdfs");
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.forEach((value, key) => {
console.log(value, key);
});
```
### entries
entries(): IterableIterator
<
[
T
,
T
]
>
;
entries(): IterableIterator
<
[
T
,
T
]
>
返回包含此映射中包含的键的新迭代器对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
[
T
,
T
]
>
| 返回一个迭代器 |
-
示例:
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
let iter = hashSet.entries();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp[0]);
console.log(temp[1]);
temp = iter.next().value;
}
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
[
T
,
T
]
>
| 返回一个迭代器 |
**示例:**
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
let iter = hashSet.entries();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp[0]);
console.log(temp[1]);
temp = iter.next().value;
}
```
### [Symbol.iterator]
[Symbol.iterator]
\(
): IterableIterator
<
T
>
;
[Symbol.iterator]
\(
): IterableIterator
<
T
>
返回一个迭代器,迭代器的每一项都是一个 JavaScript 对象,并返回该对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器 |
-
示例:
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
// 使用方法一:
for (let item of hashSet) {
console.log("value: " + item);
}
// 使用方法二:
let iter = hashSet[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
\ No newline at end of file
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器 |
**示例:**
```
let hashSet = new HashSet();
hashSet.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
hashSet.add("sdfs");
// 使用方法一:
for (let item of hashSet) {
console.log("value: " + item);
}
// 使用方法二:
let iter = hashSet[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-hiappevent.md
浏览文件 @
796a106e
...
...
@@ -22,27 +22,29 @@ write(eventName: string, eventType: EventType, keyValues: object, callback: Asyn
应用事件打点方法,将事件写入到当天的事件文件中,可接收类型为Json对象的事件参数,使用callback方式作为异步回调。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| eventName | string | 是 | 应用事件名称。 |
| eventType |
[
EventType
](
#eventtype
)
| 是 | 应用事件类型。 |
| keyValues | object | 是 | 应用事件的参数,key类型只能为string,value类型只能为string、number、boolean、Array(数组数据类型只能为string、number、boolean)。 |
| callback | AsyncCallback
<
void
>
| 否 | 回调函数,可以在回调函数中处理接口返回值。
<br/>
-
返回值为0表示事件校验成功,事件正常异步写入事件文件;
<br/>
-
大于0表示事件校验存在异常参数,在忽略异常参数后将事件异步写入事件文件;
<br/>
-
小于0表示事件校验失败,不将事件写入事件文件。 |
-
示例:
```
hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"}, (err, value) => {
if (err) {
// 事件写入异常:事件存在异常参数时忽略异常参数后继续写入,或者事件校验失败时不执行写入
console.error(`failed to write event because ${err.code}`);
return;
}
// 事件写入正常
console.log(`success to write event: ${value}`);
});
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| eventName | string | 是 | 应用事件名称。 |
| eventType |
[
EventType
](
#eventtype
)
| 是 | 应用事件类型。 |
| keyValues | object | 是 | 应用事件的参数,key类型只能为string,value类型只能为string、number、boolean、Array(数组数据类型只能为string、number、boolean)。 |
| callback | AsyncCallback
<
void
>
| 否 | 回调函数,可以在回调函数中处理接口返回值。
<br/>
-
返回值为0表示事件校验成功,事件正常异步写入事件文件;
<br/>
-
大于0表示事件校验存在异常参数,在忽略异常参数后将事件异步写入事件文件;
<br/>
-
小于0表示事件校验失败,不将事件写入事件文件。 |
**示例:**
```
hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"}, (err, value) => {
if (err) {
// 事件写入异常:事件存在异常参数时忽略异常参数后继续写入,或者事件校验失败时不执行写入
console.error(`failed to write event because ${err.code}`);
return;
}
// 事件写入正常
console.log(`success to write event: ${value}`);
});
```
## hiAppEvent.write
...
...
@@ -51,29 +53,32 @@ write(eventName: string, eventType: EventType, keyValues: object): Promise<vo
应用事件打点方法,将事件写入到当天的事件文件中,可接收类型为Json对象的事件参数,使用promise方式作为异步回调。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| eventName | string | 是 | 应用事件名称。 |
| eventType |
[
EventType
](
#eventtype
)
| 是 | 应用事件类型。 |
| keyValues | object | 是 | 应用事件的参数,key类型只能为string,value类型只能为string、number、boolean、Array(数组数据类型只能为string、number、boolean)。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise实例,可以在其then()、catch()方法中分别对事件写入成功、写入异常的情况进行回调处理。 |
-
示例:
```
hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"})
.then((value) => {
// 事件写入正常
console.log(`success to write event: ${value}`);
}).catch((err) => {
// 事件写入异常:事件存在异常参数时忽略异常参数后继续写入,或者事件校验失败时不执行写入
console.error(`failed to write event because ${err.code}`);
});
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| eventName | string | 是 | 应用事件名称。 |
| eventType |
[
EventType
](
#eventtype
)
| 是 | 应用事件类型。 |
| keyValues | object | 是 | 应用事件的参数,key类型只能为string,value类型只能为string、number、boolean、Array(数组数据类型只能为string、number、boolean)。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise实例,可以在其then()、catch()方法中分别对事件写入成功、写入异常的情况进行回调处理。 |
**示例:**
```
hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"})
.then((value) => {
// 事件写入正常
console.log(`success to write event: ${value}`);
}).catch((err) => {
// 事件写入异常:事件存在异常参数时忽略异常参数后继续写入,或者事件校验失败时不执行写入
console.error(`failed to write event because ${err.code}`);
});
```
## hiAppEvent.configure
...
...
@@ -82,28 +87,30 @@ configure(config: ConfigOption): boolean
应用事件打点配置方法,可用于配置打点开关、文件目录存储限额大小等功能。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
ConfigOption
](
#configoption
)
| 是 | 应用事件打点配置项对象。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 配置结果,true
表示配置成功,false
表示配置失败。 |
-
示例:
```
// 配置应用事件打点功能开关
hiAppEvent.configure({
disable: true
});
// 配置事件文件目录存储限额大小
hiAppEvent.configure({
maxStorage: '100M'
});
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
ConfigOption
](
#configoption
)
| 是 | 应用事件打点配置项对象。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| boolean | 配置结果,true
表示配置成功,false
表示配置失败。 |
**示例:**
```
// 配置应用事件打点功能开关
hiAppEvent.configure({
disable: true
});
// 配置事件文件目录存储限额大小
hiAppEvent.configure({
maxStorage: '100M'
});
```
## ConfigOption
...
...
zh-cn/application-dev/reference/apis/js-apis-hichecker.md
浏览文件 @
796a106e
...
...
@@ -34,22 +34,22 @@ addRule(rule: BigInt): void
添加一条或多条规则到系统,系统根据添加的规则进行检测或反馈。
-
参数:
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------- |
| rule | BigInt | 是 | 需要添加的规则。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------- |
| rule | BigInt | 是 | 需要添加的规则。 |
-
示例:
**示例:**
```
// 添加一条规则
hichecker.addRule(hichecker.RULE_CAUTION_PRINT_LOG);
// 添加多条规则
hichecker.addRule(
hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);
```
```
// 添加一条规则
hichecker.addRule(hichecker.RULE_CAUTION_PRINT_LOG);
// 添加多条规则
hichecker.addRule(
hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);
```
## hichecker.removeRule
...
...
@@ -57,44 +57,44 @@ removeRule(rule: BigInt): void
删除一条或多条规则,删除的规则后续将不再生效。
-
参数:
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------- |
| rule | BigInt | 是 | 需要删除的规则。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------- |
| rule | BigInt | 是 | 需要删除的规则。 |
-
示例:
**示例:**
```
// 删除一条规则
hichecker.removeRule(hichecker.RULE_CAUTION_PRINT_LOG);
// 删除多条规则
hichecker.removeRule(
hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);
```
```
// 删除一条规则
hichecker.removeRule(hichecker.RULE_CAUTION_PRINT_LOG);
// 删除多条规则
hichecker.removeRule(
hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);
```
## hichecker.getRule
()
## hichecker.getRule
getRule(): BigInt
获取当前线程规则、进程规则、告警规则的合集。
-
返回值:
**返回值:**
| 类型 | 说明 |
| ------ | ---------------------- |
| BigInt | 当前系统中添加的规则。 |
| 类型 | 说明 |
| ------ | ---------------------- |
| BigInt | 当前系统中添加的规则。 |
-
示例:
**示例:**
```
// 添加一条规则
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);
// 获取已添加的规则
hichecker.getRule(); // return 1n;
```
```
// 添加一条规则
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);
// 获取已添加的规则
hichecker.getRule(); // return 1n;
```
## hichecker.contains
...
...
@@ -102,25 +102,25 @@ contains(rule: BigInt): boolean
当前已添加的规则集中是否包含了某一个特定的规则,如果传入的规则级别为线程级别,则仅在当前线程中进行查询。
-
参数:
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------- |
| rule | BigInt | 是 | 需要查询的规则。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------- |
| rule | BigInt | 是 | 需要查询的规则。 |
-
返回值:
**返回值:**
| 类型 | 说明 |
| ------- | ---------------------------------------------------------- |
| boolean | 查询结果,true
表示规则已添加,false 表示规则未添加。 |
| 类型 | 说明 |
| ------- | ---------------------------------------------------------- |
| boolean | 查询结果,true
表示规则已添加,false 表示规则未添加。 |
-
示例:
**示例:**
```
// 添加一条规则
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);
```
// 添加一条规则
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);
// 查询是否包含
hichecker.contains(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS); // return true;
hichecker.contains(hichecker.RULE_CAUTION_PRINT_LOG); // return false;
```
// 查询是否包含
hichecker.contains(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS); // return true;
hichecker.contains(hichecker.RULE_CAUTION_PRINT_LOG); // return false;
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-hitracechain.md
浏览文件 @
796a106e
...
...
@@ -68,20 +68,24 @@ begin(name: string, flags: number = HiTraceFlag.DEFAULT): HiTraceId
开始跟踪,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 跟踪业务名。 |
| flags | number | 是 |
[
跟踪标志组合
](
#hitraceflag
)
。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
|
[
HiTraceId
](
#hitraceid
)
| HiTraceId实例。 |
-
示例:
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC | hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 跟踪业务名。 |
| flags | number | 是 | 跟踪标志组合,具体可参考
[
HiTraceFlag
](
#hitraceflag
)
。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
|
[
HiTraceId
](
#hitraceid
)
| HiTraceId实例。 |
**示例:**
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC | hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
```
## hiTraceChain.end
...
...
@@ -89,17 +93,19 @@ end(id: HiTraceId): void
结束跟踪,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | HiTraceId实例。 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | HiTraceId实例。 |
**示例:**
-
示例:
```
let asyncTraceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,结束跟踪。
hiTraceChain.end(asyncTraceId);
```
```
let asyncTraceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,结束跟踪。
hiTraceChain.end(asyncTraceId);
```
## hiTraceChain.getId
...
...
@@ -107,17 +113,19 @@ getId(): HiTraceId
获取跟踪标识,同步接口。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
|
[
HiTraceId
](
#hitraceid
)
| HiTraceId实例。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
|
[
HiTraceId
](
#hitraceid
)
| HiTraceId实例。 |
-
示例:
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,获取当前HiTraceId。
let curTraceId = hiTraceChain.getId();
```
**示例:**
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,获取当前HiTraceId。
let curTraceId = hiTraceChain.getId();
```
## hiTraceChain.setId
...
...
@@ -125,17 +133,19 @@ setId(id: HiTraceId): void
设置跟踪标识,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | HiTraceId实例。 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | HiTraceId实例。 |
-
示例:
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,设置当前HiTraceId。
hiTraceChain.setId(asyncTraceId);
```
**示例:**
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,设置当前HiTraceId。
hiTraceChain.setId(asyncTraceId);
```
## hiTraceChain.clearId
...
...
@@ -143,12 +153,13 @@ clearId(): void
清除跟踪标识,同步接口。
-
示例:
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,清除当前HiTraceId。
hiTraceChain.clearId();
```
**示例:**
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,清除当前HiTraceId。
hiTraceChain.clearId();
```
## hiTraceChain.createSpan
...
...
@@ -156,17 +167,19 @@ createSpan(): HiTraceId
创建跟踪分支,同步接口。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
|
[
HiTraceId
](
#hitraceid
)
| HiTraceId实例。 |
**返回值:**
-
示例:
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,创建跟踪分支。
let spanTraceId = hiTraceChain.createSpan();
```
| 类型 | 说明 |
| -------- | -------- |
|
[
HiTraceId
](
#hitraceid
)
| HiTraceId实例。 |
**示例:**
```
let traceId = hiTraceChain.begin("business");
// 若干业务逻辑完成后,创建跟踪分支。
let spanTraceId = hiTraceChain.createSpan();
```
## hiTraceChain.tracepoint
...
...
@@ -174,20 +187,22 @@ tracepoint(mode: HiTraceCommunicationMode, type: HiTraceTracepointType, id: HiTr
信息埋点,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| mode |
[
HiTraceCommunicationMode
](
#hitracecommunicationmode
)
| 是 | 信息埋点需要指定的跟踪通信模式。 |
| type |
[
HiTraceTracepointType
](
#hitracetracepointtype
)
| 是 | 信息埋点需要指定的跟踪埋点类型。 |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 实施信息埋点操作的HiTraceId实例。 |
| msg | string | 否 | 信息埋点操作传入的trace说明信息。 |
-
示例:
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC | hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
// 若干业务逻辑完成后,触发信息埋点操作。
hiTraceChain.tracepoint(hiTraceChain.HiTraceCommunicationMode.THREAD, hiTraceChain.HiTraceTracepointType.SS, asyncTraceId, "Just a example");
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| mode |
[
HiTraceCommunicationMode
](
#hitracecommunicationmode
)
| 是 | 信息埋点需要指定的跟踪通信模式。 |
| type |
[
HiTraceTracepointType
](
#hitracetracepointtype
)
| 是 | 信息埋点需要指定的跟踪埋点类型。 |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 实施信息埋点操作的HiTraceId实例。 |
| msg | string | 否 | 信息埋点操作传入的trace说明信息。 |
**示例:**
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC | hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
// 若干业务逻辑完成后,触发信息埋点操作。
hiTraceChain.tracepoint(hiTraceChain.HiTraceCommunicationMode.THREAD, hiTraceChain.HiTraceTracepointType.SS, asyncTraceId, "Just a example");
```
## hiTraceChain.isValid
...
...
@@ -195,20 +210,24 @@ isValid(id: HiTraceId): boolean
判断HiTraceId对象是否有效,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 需要判断是否有效的HiTraceId实例。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 返回true表示HiTraceId有效,否则无效。 |
-
示例:
```
let traceId = hiTraceChain.begin("business");
let traceIdIsvalid = hiTraceChain.isValid(traceId);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 需要判断是否有效的HiTraceId实例。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| boolean | 返回true表示HiTraceId有效,否则无效。 |
**示例:**
```
let traceId = hiTraceChain.begin("business");
let traceIdIsvalid = hiTraceChain.isValid(traceId);
```
## hiTraceChain.isFlagEnabled
...
...
@@ -216,21 +235,26 @@ isFlagEnabled(id: HiTraceId, flag: HiTraceFlag): boolean
判断HiTraceId对象中指定的跟踪标志是否已置位,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 需要判断指定跟踪标志是否置位的HiTraceId实例。 |
| flag |
[
HiTraceFlag
](
#hitraceflag
)
| 是 | 指定的跟踪标志。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 返回true标识HiTraceId已置位指定的flag,否则没有置位。 |
-
示例:
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC);
// enabledDoNotCreateSpanFlag为true
let enabledDoNotCreateSpanFlag = hiTraceChain.isFlagEnabled(asyncTraceId, hiTraceChain.HiTraceFlag.INCLUDE_ASYNC);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 需要判断指定跟踪标志是否置位的HiTraceId实例。 |
| flag |
[
HiTraceFlag
](
#hitraceflag
)
| 是 | 指定的跟踪标志。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| boolean | 返回true标识HiTraceId已置位指定的flag,否则没有置位。 |
**示例:**
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC);
// enabledDoNotCreateSpanFlag为true
let enabledDoNotCreateSpanFlag = hiTraceChain.isFlagEnabled(asyncTraceId, hiTraceChain.HiTraceFlag.INCLUDE_ASYNC);
```
## hiTraceChain.enableFlag
...
...
@@ -238,16 +262,17 @@ enableFlag(id: HiTraceId, flag: HiTraceFlag): void
置位HiTraceId对象中指定的跟踪标志,同步接口。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 需要置位指定跟踪标志的HiTraceId实例。 |
| flag |
[
HiTraceFlag
](
#hitraceflag
)
| 是 | 指定的跟踪标志。 |
-
示例:
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC);
hiTraceChain.enable(asyncTraceId, hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
// enabledDoNotCreateSpanFlag为true
let enabledDoNotCreateSpanFlag = hiTraceChain.isFlagEnabled(asyncTraceId, hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| id |
[
HiTraceId
](
#hitraceid
)
| 是 | 需要置位指定跟踪标志的HiTraceId实例。 |
| flag |
[
HiTraceFlag
](
#hitraceflag
)
| 是 | 指定的跟踪标志。 |
**示例:**
```
let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC);
hiTraceChain.enable(asyncTraceId, hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
// enabledDoNotCreateSpanFlag为true
let enabledDoNotCreateSpanFlag = hiTraceChain.isFlagEnabled(asyncTraceId, hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
```
zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md
浏览文件 @
796a106e
...
...
@@ -22,22 +22,24 @@ startTrace(name: string, taskId: number, expectedTime?: number): void
标记一个预追踪耗时任务的开始,expectedTime是可选参数,标识该任务的期望耗时。
如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且任务同时被执行,则每次调用startTrace的taskId不相同。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
| expectedTime | number | 否 | 期望的耗时时间,单位:ms |
如果具有相同name的任务是串行执行的,则taskId可以相同。具体示例可参考
[
hiTraceMeter.finishTrace
](
#hitracemeterfinishtrace
)
中的示例。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的任务是串行执行的,则taskId可以相同。在下面hiTraceMeter.finishTrace的示例中会举例说明。
**参数:**
-
示例:
```
hiTraceMeter.startTrace("myTestFunc", 1);
hiTraceMeter.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
```
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
| expectedTime | number | 否 | 期望的耗时时间,单位:ms |
**示例:**
```
hiTraceMeter.startTrace("myTestFunc", 1);
hiTraceMeter.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
```
## hiTraceMeter.finishTrace
...
...
@@ -46,42 +48,42 @@ finishTrace(name: string, taskId: number): void
标记一个预追踪耗时任务的结束。
finishTrace的name和taskId必须与流程开始的
[
startTrace
](
#hitracemeterstarttrace
)
对应参数值一致。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id。 |
**示例:**
```
hiTraceMeter.finishTrace("myTestFunc", 1);
```
```
//追踪并行执行的同名任务
hiTraceMeter.startTrace("myTestFunc", 1);
//业务流程......
hiTraceMeter.startTrace("myTestFunc", 2); //第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同。
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 1);
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 2);
```
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
-
示例:
```
hiTraceMeter.finishTrace("myTestFunc", 1);
```
```
//追踪并行执行的同名任务
hiTraceMeter.startTrace("myTestFunc", 1);
//业务流程......
hiTraceMeter.startTrace("myTestFunc", 2); //第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同。
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 1);
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 2);
```
```
//追踪串行执行的同名任务
hiTraceMeter.startTrace("myTestFunc", 1);
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 1); //第一个追踪的任务结束
//业务流程......
hiTraceMeter.startTrace("myTestFunc", 1); //第二个追踪的同名任务开始,同名的待追踪任务串行执行。
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 1);
```
```
//追踪串行执行的同名任务
hiTraceMeter.startTrace("myTestFunc", 1);
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 1); //第一个追踪的任务结束
//业务流程......
hiTraceMeter.startTrace("myTestFunc", 1); //第二个追踪的同名任务开始,同名的待追踪任务串行执行。
//业务流程......
hiTraceMeter.finishTrace("myTestFunc", 1);
```
## hiTraceMeter.traceByValue
...
...
@@ -90,18 +92,18 @@ traceByValue(name: string, value: number): void
用来标记一个预追踪的数值变量,该变量的数值会不断变化。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的数值变量名称 |
| value | number | 是 | 变量的值 |
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的数值变量名称 |
| value | number | 是 | 变量的值 |
-
示例:
```
let traceCount = 3;
hiTraceMeter.traceByValue("myTestCount", traceCount);
traceCount = 4;
hiTraceMeter.traceByValue("myTestCount", traceCount);
//业务流程......
```
**示例:**
```
let traceCount = 3;
hiTraceMeter.traceByValue("myTestCount", traceCount);
traceCount = 4;
hiTraceMeter.traceByValue("myTestCount", traceCount);
//业务流程......
```
zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-lightweightset.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-linkedlist.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-list.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-plainarray.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-power.md
浏览文件 @
796a106e
...
...
@@ -23,16 +23,18 @@ shutdownDevice(reason: string): void
需要权限:ohos.permission.SHUTDOWN
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reason | string | 是 | 关机原因。 |
**参数:**
-
示例:
```
power.shutdownDevice("shutdown_test");
console.info('power_shutdown_device_test success')
```
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reason | string | 是 | 关机原因。 |
**示例:**
```
power.shutdownDevice("shutdown_test");
console.info('power_shutdown_device_test success')
```
## power.rebootDevice
...
...
@@ -43,16 +45,18 @@ rebootDevice(reason: string): void
需要权限:ohos.permission.REBOOT(重启权限)、ohos.permission.REBOOT_RECOVERY(重启并进入recovery模式的权限)
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reason | string | 是 | 重启原因。 |
**参数:**
-
示例:
```
power.rebootDevice("reboot_test");
console.info('power_reboot_device_test success')
```
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reason | string | 是 | 重启原因。 |
**示例:**
```
power.rebootDevice("reboot_test");
console.info('power_reboot_device_test success')
```
## power.isScreenOn
...
...
@@ -61,21 +65,23 @@ isScreenOn(callback: AsyncCallback<boolean>): void
检测当前设备的亮灭屏状态。
-
参数:
| 类型 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 指定的callback回调方法,用于获取返回值。
<br/>
callback返回值:亮屏返回true,灭屏返回false。 |
**参数:**
-
示例:
```
power.isScreenOn((error, screenOn) => {
if (typeof error === "undefined") {
console.info('screenOn status is ' + screenOn);
} else {
console.log('error: ' + error);
}
})
```
| 类型 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 指定的callback回调方法,用于获取返回值。
<br/>
callback返回值:亮屏返回true,灭屏返回false。 |
**示例:**
```
power.isScreenOn((error, screenOn) => {
if (typeof error === "undefined") {
console.info('screenOn status is ' + screenOn);
} else {
console.log('error: ' + error);
}
})
```
## power.isScreenOn
...
...
@@ -84,18 +90,19 @@ isScreenOn(): Promise<boolean>
检测当前设备的亮灭屏状态。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
boolean
>
| Promise实例,用于异步获取返回值,亮屏返回true,灭屏返回false。 |
-
示例:
```
power.isScreenOn()
.then(screenOn => {
console.info('screenOn status is ' + screenOn);
})
.catch(error => {
console.log('error: ' + error);
})
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
boolean
>
| Promise实例,用于异步获取返回值,亮屏返回true,灭屏返回false。 |
**示例:**
```
power.isScreenOn()
.then(screenOn => {
console.info('screenOn status is ' + screenOn);
})
.catch(error => {
console.log('error: ' + error);
})
```
zh-cn/application-dev/reference/apis/js-apis-process.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-queue.md
浏览文件 @
796a106e
...
...
@@ -10,10 +10,9 @@
import Queue from '@ohos.util.Queue'
```
## 系统能力
## 权限
无
SystemCapability.Utils.Lang
## Queue
...
...
@@ -23,48 +22,51 @@ import Queue from '@ohos.util.Queue'
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| length | number | 是 | 否 | Queue的元素个数 |
| length | number | 是 | 否 | Queue的元素个数
。
|
### constructor
constructor()
;
constructor()
Queue的构造函数。
**示例:**
-
示例:
```
let queue = new Queue();
```
```
let queue = new Queue();
```
### add
add(element: T): boolean
;
add(element: T): boolean
在队列尾部插入元素。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 添加进去的元素 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| boolean | 插入成功返回true,失败返回false |
-
示例:
```
let queue = new Queue();
queue.add("a");
queue.add(1);
let b = [1, 2, 3];
queue.add(b);
let c = {name : "lala", age : "13"};
queue.add(false);
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| element | T | 是 | 添加进去的元素。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| boolean | 插入成功返回true,否则返回false。 |
**示例:**
```
let queue = new Queue();
queue.add("a");
queue.add(1);
let b = [1, 2, 3];
queue.add(b);
let c = {name : "lala", age : "13"};
queue.add(false);
```
### pop
...
...
@@ -72,109 +74,113 @@ pop(): T
删除头元素并返回该删除元素。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| T | 返回删除的元素 |
-
示例:
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(2);
queue.add(4);
queue.pop();
```
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回删除的元素。 |
**示例:**
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(2);
queue.add(4);
queue.pop();
```
### getFirst
getFirst(): T
;
getFirst(): T
获取队列的头元素。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| T | 返回尾元素 |
-
示例:
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(2);
queue.getFirst();
```
**参数:**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回获取的元素。 |
**示例:**
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(2);
queue.getFirst();
```
### forEach
forEach(callbackfn: (value: T, index?: number, queue?: Queue
<
T
>
) => void,
thisArg?: Object): void
;
thisArg?: Object): void
通过回调函数来遍历Queue实例对象上的元素以及元素对应的下标。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值 |
-
callbackfn的参数说明
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素 |
| index | number | 否 | 当前遍历到的下标值 |
| queue | Queue
<
T
>
| 否 | 当前调用forEach方法的实例对象 |
-
示例:
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(4);
queue.forEach((value, index) => {
console.log(value, index);
});
```
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callbackfn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值。 |
callbackfn的参数说明:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素 |
| index | number | 否 | 当前遍历到的下标值 |
| queue | Queue
<
T
>
| 否 | 当前调用forEach方法的实例对象 |
**示例:**
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(4);
queue.forEach((value, index) => {
console.log(value, index);
});
```
### [Symbol.iterator]
[Symbol.iterator]
\(
): IterableIterator
<
T
>
;
[Symbol.iterator]
\(
): IterableIterator
<
T
>
返回一个迭代器,迭代器的每一项都是一个 JavaScript 对象,并返回该对象。
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| IterableIterator
<
T
>
| 返回一个迭代器 |
-
示例:
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(4);
// 使用方法一:
for (let item of queue) {
console.log(item);
}
// 使用方法二:
let iter = queue[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
\ No newline at end of file
**示例:**
```
let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(4);
// 使用方法一:
for (let item of queue) {
console.log(item);
}
// 使用方法二:
let iter = queue[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log(temp);
temp = iter.next().value;
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-radio.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-runninglock.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-security-accessToken.md
已删除
100644 → 0
浏览文件 @
f19488de
# 访问控制管理
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import abilityAccessCtrl from '@ohos.abilityAccessCtrl'
```
## 系统能力
SystemCapability.Security.AccessToken
## abilityAccessCtrl.createAtManager
createAtManager(): AtManager
访问控制管理:获取访问控制模块对象。
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
|
[
AtManager
](
#atManager
)
| 获取访问控制模块的实例。 |
-
示例:
```
var AtManager = abilityAccessCtrl.createAtManager();
```
## AtManager
管理访问控制模块的实例。
### verifyAccessToken
verifyAccessToken(tokenID: number, permissionName: string): Promise
<
GrantStatus
>
校验应用是否授予权限,使用Promise方式异步返回结果。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ------------------------------------------ |
| tokenID | number | 是 | 要校验的目标应用的身份标识。 |
| permissionName | string | 是 | 需要校验的权限名称。 |
-
返回值:
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
GrantStatus
>
| Promise实例,用于获取异步返回的授权状态结果。 |
-
示例:
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.verifyAccessToken(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
### grantUserGrantedPermission
grantUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number): Promise
<
number
>
授予应用user grant权限,使用Promise方式异步返回结果。
需要权限:ohos.permission.GRANT_SENSITIVE_PERMISSIONS。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被授予的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
-
返回值:
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
number
>
| Promise实例,用于获取异步返回的授权操作结果。 |
-
示例:
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.grantUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
### grantUserGrantedPermission
grantUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number, callback: AsyncCallback
<
number
>
): void
授予应用user grant权限,使用callback回调异步返回结果。
需要权限:ohos.permission.GRANT_SENSITIVE_PERMISSIONS。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被授予的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
| callback | AsyncCallback
<
number
>
| 是 | 检查授予应用user grant权限的操作结果同步的回调。 |
-
示例:
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
AtManager.grantUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag, data => {
console.log(`callback: data->${JSON.stringify(data)}`);
});
```
### revokeUserGrantedPermission
revokeUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number): Promise
<
number
>
撤销应用user grant权限,使用Promise方式异步返回结果。
需要权限:ohos.permission.REVOKE_SENSITIVE_PERMISSIONS。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被撤销的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
-
返回值:
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
number
>
| Promise实例,用于获取异步返回的授权操作结果。 |
-
示例:
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
let promise = AtManager.revokeUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS", permissionFlag);
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
### revokeUserGrantedPermission
revokeUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number, callback: AsyncCallback
<
number
>
): void
撤销应用user grant权限,使用callback回调异步返回结果。
需要权限:ohos.permission.REVOKE_SENSITIVE_PERMISSIONS。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 被撤销的权限名称。 |
| permissionFlag | number | 是 | 授权选项,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。 |
| callback | AsyncCallback
<
number
>
| 是 | 检查撤销应用user grant权限的操作结果同步的回调。 |
-
示例:
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
AtManager.revokeUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag, data => {
console.log(`callback: data->${JSON.stringify(data)}`);
});
```
### getPermissionFlags
getPermissionFlags(tokenID: number, permissionName: string): Promise
<
number
>
获取指定应用的指定权限的flag,使用Promise方式异步返回结果。
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。 |
| permissionName | string | 是 | 查询的权限名称。 |
-
返回值:
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| Promise
<
number
>
| Promise实例,用于获取异步返回的查询结果。 |
-
示例:
```
const AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.getPermissionFlags(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
console.log(`promise: data->${JSON.stringify(data)}`);
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-sim.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-sms.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-stack.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-treemap.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-treeset.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-uri.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-url.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-useriam-userauth.md
浏览文件 @
796a106e
...
...
@@ -10,6 +10,9 @@
import userIAM_userAuth from '@ohos.userIAM.userAuth';
```
## 系统能力
SystemCapability.UserIAM.UserAuth
## 权限列表
...
...
zh-cn/application-dev/reference/apis/js-apis-util.md
浏览文件 @
796a106e
...
...
@@ -14,6 +14,9 @@
import util from '@ohos.util';
```
## 系统能力
SystemCapability.Utils.Lang
## util.printf
...
...
zh-cn/application-dev/reference/apis/js-apis-vector.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-worker.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-xml.md
浏览文件 @
796a106e
此差异已折叠。
点击以展开。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录