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 c0a79872d031576a7ebefe61a5b172b10d02f1c4..193b6fb237deaafa28a0c5620b435f9d428d5c84 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-util.md +++ b/zh-cn/application-dev/reference/apis/js-apis-util.md @@ -98,10 +98,13 @@ callbackWrapper(original: Function): (err: Object, value: Object )=>void ``` -## util.promiseWrapper +## util.promiseWrapper(deprecated) promiseWrapper(original: (err: Object, value: Object) => void): Object +> **说明:**
+> 从API Version 9开始废弃,建议使用[util.promiseWrapper9+](#utilpromisewrapper9)替代。 + 对异步函数处理并返回一个promise的版本。 **系统能力:** SystemCapability.Utils.Lang @@ -131,6 +134,38 @@ promiseWrapper(original: (err: Object, value: Object) => void): Object }) ``` +## util.promiseWrapper9+ + +promiseWrapper(original: (err: Object, value: Object) => void): Function + +对异步函数处理并返回一个promise的函数。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| original | Function | 是 | 异步函数。 | + +**返回值:** +| 类型 | 说明 | +| -------- | -------- | +| Function | 采用遵循常见的错误优先的回调风格的函数(也就是将 (err, value) => ... 回调作为最后一个参数),并返回一个返回 promise 的函数。 | + +**示例:** + ```js + function aysnFun(str1, str2, callback) { + if (typeof str1 === 'string' && typeof str2 === 'string') { + callback(null, str1 + str2); + } else { + callback('type err'); + } + } + let newPromiseObj = util.promiseWrapper(aysnFun); + newPromiseObj("Hello", 'World').then(res => { + console.log(res); + }) + ``` ## TextDecoder