From a5eff0b8bc97ce246c9af2af4b42502bf19fd04f Mon Sep 17 00:00:00 2001
From: DCloud_LXH <283700113@qq.com>
Date: Thu, 18 Nov 2021 17:31:26 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20Promise=20=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/api/README.md | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/docs/api/README.md b/docs/api/README.md
index 420cbba10..49a1abe5e 100644
--- a/docs/api/README.md
+++ b/docs/api/README.md
@@ -100,7 +100,7 @@ async function request () {
 
 #### Vue 3
 
-> 对部分 API 进行了 Promise 封装，`then` 为 success 成功回调。`catch` 为 fail 失败回调
+> 对部分 API 进行了 Promise 封装，调用成功会进入 `then 方法` 回调。调用失败会进入 `catch 方法` 回调
 
 **使用示例：**
 
@@ -116,26 +116,30 @@ uni.request({
 	}
 });
 
-// Promise
+// 使用 Promise then/catch 方式调用
 uni.request({
 		url: 'https://www.example.com/request'
 	})
-	.then(res => {	// 此处即为 success 回调中的 res
+	.then(res => {
+		// 此处的 res 参数，与使用默认方式调用时 success 回调中的 res 参数一致
 		console.log(res.data);
 	})
-	.catch(err => {	// 此处即为 fail 回调中的 err
+	.catch(err => {
+		// 此处的 err 参数，与使用默认方式调用时 fail 回调中的 err 参数一致
 		console.error(err)
 	})
 
-// Await
+// 使用 Await/Await 方式调用
 async function request () {
 	try{
 		var res = await uni.request({
 			url: 'https://www.example.com/request'
 		});
-		console.log(res); // 此处即为 success 回调中的 res
+		// 此处的 res 参数，与使用默认方式调用时 success 回调中的 res 参数一致
+		console.log(res);
 	} catch (err) {
-		console.error(err) // 此处即为 fail 回调中的 err
+		// 此处的 err 参数，与使用默认方式调用时 fail 回调中的 err 参数一致
+		console.error(err)
 	}
 }
 ```
-- 
GitLab