diff --git a/zh-cn/application-dev/reference/apis/js-apis-convertxml.md b/zh-cn/application-dev/reference/apis/js-apis-convertxml.md
index d805a588e1c387868121d14ec9443435236ec785..fccd142de86dfb397585557c8a9c3ed6ff01af02 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-convertxml.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-convertxml.md
@@ -47,21 +47,27 @@ convertToJSObject(xml: string, options?: ConvertOptions) : Object
**示例:**
```js
-let xml =
- '' +
- '' +
- ' Happy' +
- ' Work' +
- ' Play' +
- '';
-let conv = new convertxml.ConvertXML()
-let options = {trim : false, declarationKey:"_declaration",
- instructionKey : "_instruction", attributesKey : "_attributes",
- textKey : "_text", cdataKey:"_cdata", doctypeKey : "_doctype",
- commentKey : "_comment", parentKey : "_parent", typeKey : "_type",
- nameKey : "_name", elementsKey : "_elements"}
-let result = JSON.stringify(conv.convertToJSObject(xml, options));
-console.log(result);
+try {
+ let xml =
+ '' +
+ '' +
+ ' Happy' +
+ ' Work' +
+ ' Play' +
+ '';
+ let conv = new convertxml.ConvertXML()
+ let options = {
+ trim: false, declarationKey: "_declaration",
+ instructionKey: "_instruction", attributesKey: "_attributes",
+ textKey: "_text", cdataKey: "_cdata", doctypeKey: "_doctype",
+ commentKey: "_comment", parentKey: "_parent", typeKey: "_type",
+ nameKey: "_name", elementsKey: "_elements"
+ }
+ let result = JSON.stringify(conv.convertToJSObject(xml, options));
+ console.log(result);
+} catch (e) {
+ console.log(e.toString());
+}
// 输出(宽泛型)
// {"_declaration":{"_attributes":{"version":"1.0","encoding":"utf-8"}},"_elements":[{"_type":"element","_name":"note","_attributes":{"importance":"high","logged":"true"},"_elements":[{"_type":"element","_name":"title","_elements":[{"_type":"text","_text":"Happy"}]},{"_type":"element","_name":"todo","_elements":[{"_type":"text","_text":"Work"}]},{"_type":"element","_name":"todo","_elements":[{"_type":"text","_text":"Play"}]}]}]}
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-util.md b/zh-cn/application-dev/reference/apis/js-apis-util.md
index c50d6b23af161c2bbd9c58dc9e04a9b0fdbaea17..0254aca1a63d8d2086da50f893b1c9b2f657d8c9 100755
--- a/zh-cn/application-dev/reference/apis/js-apis-util.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-util.md
@@ -26,7 +26,7 @@ format(format: string, ...args: Object[]): string
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------- | ---- | -------------- |
| format | string | 是 | 式样化字符串。 |
-| ...args | Object[] | 否 | 替换式样化字符串通配符的数据。 |
+| ...args | Object[] | 否 | 替换式样化字符串通配符的数据,此参数缺失时,默认返回第一个参数。 |
**返回值:**
@@ -69,6 +69,20 @@ let result = util.errnoToString(errnum);
console.log("result = " + result);
```
+**部分错误码及信息示例:**
+
+| 错误码 | 信息 |
+| ------ | -------------------------------- |
+| -1 | operation not permitted |
+| -2 | no such file or directory |
+| -3 | no such process |
+| -4 | interrupted system call |
+| -5 | i/o error |
+| -11 | resource temporarily unavailable |
+| -12 | not enough memory |
+| -13 | permission denied |
+| -100 | network is down |
+
## util.callbackWrapper
callbackWrapper(original: Function): (err: Object, value: Object )=>void
@@ -92,15 +106,14 @@ callbackWrapper(original: Function): (err: Object, value: Object )=>void
**示例:**
```js
- async function promiseFn() {
- return Promise.reject('value');
- }
- let err = "type err";
- let cb = util.callbackWrapper(promiseFn);
- cb((err, ret) => {
- console.log(err);
- console.log(ret);
- }, err)
+async function fn() {
+ return 'hello world';
+}
+let cb = util.callbackWrapper(fn);
+cb((err, ret) => {
+ if (err) throw err;
+ console.log(ret);
+});
```
## util.promisify9+
@@ -126,24 +139,30 @@ promisify(original: (err: Object, value: Object) => void): Function
**示例:**
```js
- function aysnFun(str1, str2) {
- if (typeof str1 === 'object' && typeof str2 === 'object') {
- return str2
- } else {
- return str1
- }
- }
- let newPromiseObj = util.promisify(aysnFun);
- newPromiseObj({ err: "type error" }, {value:'HelloWorld'}).then(res => {
- console.log(res);
- })
+function fun(num, callback) {
+ if (typeof num === 'number') {
+ callback(null, num + 3);
+ } else {
+ callback("type err");
+ }
+}
+
+const addCall = util.promisify(fun);
+(async () => {
+ try {
+ let res = await addCall(2);
+ console.log(res);
+ } catch (err) {
+ console.log(err);
+ }
+})();
```
-## util.randomUUID9+
+## util.generateRandomUUID9+
-randomUUID(entropyCache?: boolean): string
+generateRandomUUID(entropyCache?: boolean): string
-使用加密安全随机数生成器生成随机的RFC 4122版本4的 UUID。
+使用加密安全随机数生成器生成随机的RFC 4122版本4的string类型UUID。
**系统能力:** SystemCapability.Utils.Lang
@@ -162,17 +181,17 @@ randomUUID(entropyCache?: boolean): string
**示例:**
```js
- let uuid = util.randomUUID(true);
+ let uuid = util.generateRandomUUID(true);
console.log("RFC 4122 Version 4 UUID:" + uuid);
// 输出:
// RFC 4122 Version 4 UUID:88368f2a-d5db-47d8-a05f-534fab0a0045
```
-## util.randomBinaryUUID9+
+## util.generateRandomBinaryUUID9+
-randomBinaryUUID(entropyCache?: boolean): Uint8Array
+generateRandomBinaryUUID(entropyCache?: boolean): Uint8Array
-使用加密安全随机数生成器生成随机的RFC 4122版本4的 UUID。
+使用加密安全随机数生成器生成随机的RFC 4122版本4的Uint8Array类型UUID。
**系统能力:** SystemCapability.Utils.Lang
@@ -191,7 +210,7 @@ randomBinaryUUID(entropyCache?: boolean): Uint8Array
**示例:**
```js
- let uuid = util.randomBinaryUUID(true);
+ let uuid = util.generateRandomBinaryUUID(true);
console.log(JSON.stringify(uuid));
// 输出:
// 138,188,43,243,62,254,70,119,130,20,235,222,199,164,140,150
@@ -201,7 +220,7 @@ randomBinaryUUID(entropyCache?: boolean): Uint8Array
parseUUID(uuid: string): Uint8Array
-从字符串中解析UUID,如RFC 4122版本4中所述。
+将generateRandomUUID生成的string类型UUID转换为generateRandomBinaryUUID生成的Uint8Array类型UUID,如RFC 4122版本4中所述。
**系统能力:** SystemCapability.Utils.Lang
@@ -243,7 +262,7 @@ printf(format: string, ...args: Object[]): string
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| format | string | 是 | 式样化字符串。 |
-| ...args | Object[] | 否 | 替换式样化字符串通配符的数据。 |
+| ...args | Object[] | 否 | 替换式样化字符串通配符的数据,此参数缺失时,默认返回第一个参数。 |
**返回值:**
@@ -361,8 +380,8 @@ create(encoding?: string,options?: { fatal?: boolean; ignoreBOM?: boolean }): Te
**示例:**
```js
-let textDecoder = new util.TextDecoder()
-textDecoder.create('utf-8', { ignoreBOM : true });
+let result = util.TextDecoder.create('utf-8', { ignoreBOM : true })
+let retStr = result.encoding
```
### decodeWithStream9+