update zh-cn/application-dev/reference/apis/js-apis-util.md.

Signed-off-by: N jwx1068251 <jiangkai43@huawei.com>

update zh-cn/application-dev/reference/apis/js-apis-util.md.
Signed-off-by: N jwx1068251 <jiangkai43@huawei.com>
9cdf6db6 · jwx1068251 · Gitee · 1f75a43c · 9cdf6db6
显示空白变更内容
内联并排

Showing with 107 addition and 79 deletion

zh-cn/application-dev/reference/apis/js-apis-util.md zh-cn/application-dev/reference/apis/js-apis-util.md +107 -79

未找到文件。
--- a/zh-cn/application-dev/reference/apis/js-apis-util.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-util.md
@@ -64,7 +64,7 @@ errnoToString(errno: number): string
 **示例：**
 ```js
-let errnum = 10; // 10 : a system error number
+let errnum = -1; // -1 : a system error number
 let result = util.errnoToString(errnum);
 console.log("result = " + result);
 ```
@@ -286,7 +286,7 @@ getErrorString(errno: number): string
 **示例：**
  ```js
-  let errnum = 10; // 10 : a system error number
+  let errnum = -1; // -1 : a system error number
  let result = util.getErrorString(errnum);
  console.log("result = " + result);
  ```
@@ -365,9 +365,9 @@ let textDecoder = new util.TextDecoder()
 textDecoder.create('utf-8', { ignoreBOM : true });
 ```
-### decode
+### decodeWithStream<sup>9+</sup>
-decode(input: Uint8Array, options?: { stream?: false }): string
+decodeWithStream(input: Uint8Array, options?: { stream?: boolean }): string
 通过输入参数解码后输出对应文本。
@@ -384,7 +384,7 @@ decode(input: Uint8Array, options?: { stream?: false }): string
 | 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| stream | boolean | 否 | 在随后的decode()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。 |
+| stream | boolean | 否 | 在随后的decodeWithStream()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。 |
 **返回值：**
@@ -404,16 +404,19 @@ decode(input: Uint8Array, options?: { stream?: false }): string
  result[4] = 0x62;
  result[5] = 0x63;
  console.log("input num:");
-  let retStr = textDecoder.decode( result , {stream: false});
+  let retStr = textDecoder.decodeWithStream( result , {stream: false});
  console.log("retStr = " + retStr);
  ```
+### constructor<sup>(deprecated)</sup>
-### decodeWithStream<sup>9+</sup>
+constructor(encoding?: string, options?: { fatal?: boolean; ignoreBOM?: boolean },)
-decodeWithStream(input: Uint8Array, options?: { stream?: boolean }): string
+TextDecoder的构造函数。
-通过输入参数解码后输出对应文本。
+> **说明：**
+>
+> 从API version 7开始支持，从API version 9开始废弃，建议使用[constructor<sup>9+</sup>](#constructor9)替代。
 **系统能力：** SystemCapability.Utils.Lang
@@ -421,46 +424,31 @@ decodeWithStream(input: Uint8Array, options?: { stream?: boolean }): string
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| input | Uint8Array | 是 | 符合格式需要解码的数组。 |
+| encoding | string | 否 | 编码格式。 |
-| options | Object | 否 | 解码相关选项参数。 |
+| options | Object | 否 | 编码相关选项参数，存在两个属性fatal和ignoreBOM。 |
-**表2** options
+  **表1** options
 | 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| stream | boolean | 否 | 在随后的decodeWithStream()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。 |
+| fatal | boolean | 否 | 是否显示致命错误。 |
+| ignoreBOM | boolean | 否 | 是否忽略BOM标记。 |
-**返回值：**
-| 类型 | 说明 |
-| -------- | -------- |
-| string | 解码后的数据。 |
 **示例：**
  ```js
  let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});
-  let result = new Uint8Array(6);
-  result[0] = 0xEF;
-  result[1] = 0xBB;
-  result[2] = 0xBF;
-  result[3] = 0x61;
-  result[4] = 0x62;
-  result[5] = 0x63;
-  console.log("input num:");
-  let retStr = textDecoder.decodeWithStream( result , {stream: false});
-  console.log("retStr = " + retStr);
  ```
-### constructor<sup>(deprecated)</sup>
+### decode
-constructor(encoding?: string, options?: { fatal?: boolean; ignoreBOM?: boolean },)
+decode(input: Uint8Array, options?: { stream?: false }): string
-TextDecoder的构造函数。
+通过输入参数解码后输出对应文本。
 > **说明：**
 >
-> 从API version 7开始支持，从API version 9开始废弃，建议使用[constructor<sup>9+</sup>](#constructor9)替代。
+> 从API version 7开始支持，从API version 9开始废弃，建议使用[decodeWithStream<sup>9+</sup>](#decodeWithStream9)替代。
 **系统能力：** SystemCapability.Utils.Lang
@@ -468,20 +456,35 @@ TextDecoder的构造函数。
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| encoding | string | 否 | 编码格式。 |
+| input | Uint8Array | 是 | 符合格式需要解码的数组。 |
-| options | Object | 否 | 编码相关选项参数，存在两个属性fatal和ignoreBOM。 |
+| options | Object | 否 | 解码相关选项参数。 |
-  **表1** options
+**表2** options
 | 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| fatal | boolean | 否 | 是否显示致命错误。 |
+| stream | boolean | 否 | 在随后的decode()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。 |
-| ignoreBOM | boolean | 否 | 是否忽略BOM标记。 |
+**返回值：**
+| 类型 | 说明 |
+| -------- | -------- |
+| string | 解码后的数据。 |
 **示例：**
  ```js
  let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});
+  let result = new Uint8Array(6);
+  result[0] = 0xEF;
+  result[1] = 0xBB;
+  result[2] = 0xBF;
+  result[3] = 0x61;
+  result[4] = 0x62;
+  result[5] = 0x63;
+  console.log("input num:");
+  let retStr = textDecoder.decode( result , {stream: false});
+  console.log("retStr = " + retStr);
  ```
 ## TextEncoder
@@ -494,7 +497,6 @@ TextDecoder的构造函数。
 | -------- | -------- | -------- | -------- | -------- |
 | encoding | string | 是 | 否 | 编码格式，默认值是utf-8。 |
 ### constructor
 constructor()
@@ -509,6 +511,26 @@ TextEncoder的构造函数。
  let textEncoder = new util.TextEncoder();
  ```
+### constructor<sup>9+</sup>
+constructor(encoding?: string)
+TextEncoder的构造函数。
+**系统能力：** SystemCapability.Utils.Lang
+**参数：**
+| 参数名 | 类型 | 必填 | 说明 |
+| ----- | ---- | ---- | ---- |
+| encoding | string | 否 | 编码格式 |
+**示例：**
+  ```js
+  let textEncoder = new util.TextEncoder("utf-8");
+  ```
 ### encodeInto<sup>9+</sup>
 encodeInto(input?: string): Uint8Array
@@ -1464,7 +1486,7 @@ lru.afterRemoval(false,10,30,null);
 ### contains<sup>9+</sup>
-contains(key: object): boolean
+contains(key: K): boolean
 检查当前缓冲区是否包含指定的键。
@@ -1474,7 +1496,7 @@ contains(key: object): boolean
 | 参数名 | 类型   | 必填 | 说明             |
 | ------ | ------ | ---- | ---------------- |
-| key    | object | 是   | 表示要检查的键。 |
+| key    | K | 是   | 表示要检查的键。 |
 **返回值：**
@@ -1564,6 +1586,50 @@ pro.put(2,10);
 let result = pro[Symbol.iterator]();
  ```
+## ScopeComparable<sup>8+</sup>
+ScopeComparable类型的值需要实现compareTo方法，确保传入的数据具有可比性。
+  ```js
+  interface ScopeComparable{
+    compareTo(other: ScopeComparable): boolean;
+}
+  ```
+**系统能力：** SystemCapability.Utils.Lang
+## ScopeType<sup>8+</sup>
+用于表示范围中的值的类型。
+**系统能力：** SystemCapability.Utils.Lang
+| 类型 | 说明 |
+| -------- | -------- |
+| number | 表示值的类型为数字。 |
+| [ScopeComparable](#ScopeComparable8) | 表示值的类型为ScopeComparable。|
+构造新类，实现compareTo方法。后续示例代码中，均通过Temperature，获取[ScopeType](#scopetype8)的实例化对象。
+示例：
+```js
+class Temperature{
+    constructor(value){
+       // 当使用ts语言开发时，需要补充以下代码：
+       // private readonly _temp: Temperature;
+       this._temp = value;
+    }
+    compareTo(value){
+       return this._temp >= value.getTemp();
+    }
+    getTemp(){
+       return this._temp;
+    }
+    toString(){
+       return this._temp.toString();
+    }
+}
+```
 ## ScopeHelper<sup>9+</sup>
@@ -2121,46 +2187,8 @@ that.decode(array).then(val=>{
 })
  ```
-## ScopeType<sup>8+</sup>
-用于表示范围中的值的类型。该类型的值，类型可以为ScopeComparable或number。
-ScopeComparable类型的值需要实现compareTo方法，确保传入的数据具有可比性。
-```js
-interface ScopeComparable{
-    compareTo(other: ScopeComparable): boolean;
-}
-type ScopeType = ScopeComparable | number;
-```
-构造新类，实现compareTo方法。后续示例代码中，均通过Temperature，获取[ScopeType](#scopetype8)的实例化对象。
-示例：
-```js
-class Temperature{
-    constructor(value){
-       // 当使用ts语言开发时，需要补充以下代码：
-       // private readonly _temp: Temperature;
-       this._temp = value;
-    }
-    compareTo(value){
-       return this._temp >= value.getTemp();
-    }
-    getTemp(){
-       return this._temp;
-    }
-    toString(){
-       return this._temp.toString();
-    }
-}
-```
 ## types<sup>8+</sup>
 ### constructor<sup>8+</sup>
 constructor()