diff --git a/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md b/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md
index c08edb1e7bb45081b84d82818a31f528bd97491d..0f302eb0e6eccd14e73db49b92686113e443e290 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md
@@ -39,10 +39,12 @@ import faultLogger from '@ohos.faultLogger'
| summary | string | 故障的概要 |
| fullLog | string | 故障日志全文 |
-## faultLogger.querySelfFaultLog
+## faultLogger.querySelfFaultLog(deprecated)
querySelfFaultLog(faultType: FaultType, callback: AsyncCallback<Array<FaultLogInfo>>) : void
+> **说明:** 从 API Version 9 开始废弃,建议使用[faultLogger.query](#faultloggerquery9)替代。
+
获取当前进程故障信息,该方法通过回调方式获取故障信息数组,故障信息数组内最多上报10份故障信息。
**系统能力:** SystemCapability.HiviewDFX.Hiview.FaultLogger
@@ -79,10 +81,12 @@ function queryFaultLogCallback(error, value) {
faultLogger.querySelfFaultLog(faultLogger.FaultType.JS_CRASH, queryFaultLogCallback);
```
-## faultLogger.querySelfFaultLog
+## faultLogger.querySelfFaultLog(deprecated)
querySelfFaultLog(faultType: FaultType) : Promise<Array<FaultLogInfo>>
+> **说明:** 从 API Version 9 开始废弃,建议使用[faultLogger.query](#faultloggerquery9-1)替代。
+
获取当前进程故障信息,该方法通过Promise方式返回故障信息数组,故障信息数组内最多上报10份故障信息。
**系统能力:** SystemCapability.HiviewDFX.Hiview.FaultLogger
@@ -106,18 +110,125 @@ async function getLog() {
let value = await faultLogger.querySelfFaultLog(faultLogger.FaultType.JS_CRASH);
if (value) {
console.info("value length is " + value.length);
- let len = value.length;
- for (let i = 0; i < len; i++) {
- console.info("log: " + i);
- console.info("Log pid: " + value[i].pid);
- console.info("Log uid: " + value[i].uid);
- console.info("Log type: " + value[i].type);
- console.info("Log timestamp: " + value[i].timestamp);
- console.info("Log reason: " + value[i].reason);
- console.info("Log module: " + value[i].module);
- console.info("Log summary: " + value[i].summary);
- console.info("Log text: " + value[i].fullLog);
- }
+ let len = value.length;
+ for (let i = 0; i < len; i++) {
+ console.info("log: " + i);
+ console.info("Log pid: " + value[i].pid);
+ console.info("Log uid: " + value[i].uid);
+ console.info("Log type: " + value[i].type);
+ console.info("Log timestamp: " + value[i].timestamp);
+ console.info("Log reason: " + value[i].reason);
+ console.info("Log module: " + value[i].module);
+ console.info("Log summary: " + value[i].summary);
+ console.info("Log text: " + value[i].fullLog);
+ }
+ }
+}
+```
+
+## faultLogger.query9+
+
+query(faultType: FaultType, callback: AsyncCallback<Array<FaultLogInfo>>) : void
+
+获取当前进程故障信息,该方法通过回调方式获取故障信息数组,故障信息数组内最多上报10份故障信息。
+
+**系统能力:** SystemCapability.HiviewDFX.Hiview.FaultLogger
+
+**参数:**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| faultType | [FaultType](#faulttype) | 是 | 输入要查询的故障类型。 |
+| callback | AsyncCallbackArray<Array<[FaultLogInfo](#faultloginfo)>> | 是 | 回调函数,在回调函数中获取故障信息数组。
- value拿到故障信息数组;value为undefined表示获取过程中出现异常,error返回错误提示字符串
+
+**错误码:**
+
+以下错误码的详细介绍参见[ohos.faultLogger错误码](../errorcodes/errorcode-faultlogger.md)。
+
+| 错误码ID | 错误信息(此处仅提供错误抛出的关键信息) |
+| --- | --- |
+| 10600001 | The service is not running or broken |
+
+**示例:**
+
+```js
+function queryFaultLogCallback(error, value) {
+ if (error) {
+ console.info('error is ' + error);
+ } else {
+ console.info("value length is " + value.length);
+ let len = value.length;
+ for (let i = 0; i < len; i++) {
+ console.info("log: " + i);
+ console.info("Log pid: " + value[i].pid);
+ console.info("Log uid: " + value[i].uid);
+ console.info("Log type: " + value[i].type);
+ console.info("Log timestamp: " + value[i].timestamp);
+ console.info("Log reason: " + value[i].reason);
+ console.info("Log module: " + value[i].module);
+ console.info("Log summary: " + value[i].summary);
+ console.info("Log text: " + value[i].fullLog);
+ }
+ }
+}
+try {
+ faultLogger.query(faultLogger.FaultType.JS_CRASH, queryFaultLogCallback);
+} catch (err) {
+ console.error(`code: ${err.code}, message: ${err.message}`);
+}
+```
+
+## faultLogger.query9+
+
+query(faultType: FaultType) : Promise<Array<FaultLogInfo>>
+
+获取当前进程故障信息,该方法通过Promise方式返回故障信息数组,故障信息数组内最多上报10份故障信息。
+
+**系统能力:** SystemCapability.HiviewDFX.Hiview.FaultLogger
+
+**参数:**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| faultType | [FaultType](#faulttype) | 是 | 输入要查询的故障类型。 |
+
+**返回值:**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise<Array<[FaultLogInfo](#faultloginfo)>> | Promise实例,可以在其then()方法中获取故障信息实例,也可以使用await。
- value拿到故障信息数组;value为undefined表示获取过程中出现异常 |
+
+**错误码:**
+
+以下错误码的详细介绍参见[ohos.faultLogger错误码](../errorcodes/errorcode-faultlogger.md)。
+
+| 错误码ID | 错误信息(此处仅提供错误抛出的关键信息) |
+| --- | --- |
+| 10600001 | The service is not running or broken |
+
+**示例:**
+
+```js
+async function getLog() {
+ try {
+ let value = await faultLogger.query(faultLogger.FaultType.JS_CRASH);
+ if (value) {
+ console.info("value length is " + value.length);
+ let len = value.length;
+ for (let i = 0; i < len; i++) {
+ console.info("log: " + i);
+ console.info("Log pid: " + value[i].pid);
+ console.info("Log uid: " + value[i].uid);
+ console.info("Log type: " + value[i].type);
+ console.info("Log timestamp: " + value[i].timestamp);
+ console.info("Log reason: " + value[i].reason);
+ console.info("Log module: " + value[i].module);
+ console.info("Log summary: " + value[i].summary);
+ console.info("Log text: " + value[i].fullLog);
+ }
+ }
+ } catch (err) {
+ console.error(`code: ${err.code}, message: ${err.message}`);
}
}
```
diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-faultlogger.md b/zh-cn/application-dev/reference/errorcodes/errorcode-faultlogger.md
new file mode 100644
index 0000000000000000000000000000000000000000..397279658180123ee8d4b8989810ff549e29b6bd
--- /dev/null
+++ b/zh-cn/application-dev/reference/errorcodes/errorcode-faultlogger.md
@@ -0,0 +1,19 @@
+# faultlogger 错误码
+
+## 10600001 服务未启动或故障
+
+**错误信息**
+
+The service is not running or broken.
+
+**错误描述**
+
+服务未启动/故障。
+
+**可能原因**
+
+hiview服务未启动。
+
+**处理步骤**
+
+不应该发生的场景,考虑重试。
\ No newline at end of file