diff --git a/zh-cn/application-dev/reference/apis/js-apis-logs.md b/zh-cn/application-dev/reference/apis/js-apis-logs.md index 40213556ac95c072d5b85679700734315d2e9470..edad84e6c1080774b6c6dc625d62db707854fb61 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-logs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-logs.md @@ -83,7 +83,7 @@ error(message: string): void | message | string | 是 | 表示要打印的文本信息。 | -## 示例 +**示例:** ``` export default { @@ -99,3 +99,240 @@ export default { 在DevEco Studio的底部,切换到“HiLog”窗口。选择当前的设备及进程,日志级别选择Info,搜索内容设置为“Hello World”。此时窗口仅显示符合条件的日志,效果如图所示: ![zh-cn_image_0000001200913929](figures/zh-cn_image_0000001200913929.png) + +## console.assert10+ + +assert(value?: Object, ...arguments: Object[]): void + +若value为假,打印后续内容。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| value | Object | 否 | 值 | +| arguments | Object | 否 | 错误消息打印。 | + +**示例:** +``` +console.assert(true, 'does nothing'); + +console.assert(false, 'console %s work', 'didn\'t'); +// Assertion console:ohos didn't work + +console.assert(); +// Assertion failed +``` +## console.count10+ + +count(label?: string): void + +维护一个内部计数器, 并输出调用label的console.count()次数。默认值为'default'。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| label | string | 否 | 计数器标签名。 | + +**示例:** +``` +console.count() +// default: 1 +console.count('default') +// default: 2 +console.count('abc') +// abc: 1 +console.count('xyz') +// xyz: 1 +console.count('abc') +abc: 2 +console.count() +// default: 3 +``` + +## console.countReset10+ + +countReset(label?: string): void + +清除label名的计数。默认值为'default'。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| label | string | 否 | 计数器标签名。 | + +**示例:** +``` +console.count('abc'); +// abc: 1 +console.countReset('abc'); +console.count('abc'); +// abc: 1 +``` + +## console.dir10+ + +dir(dir?: Object): void + +打印对象内容。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| dir | Object | 否 | 需要打印内容的对象。 | + +## console.dirxml10+ + +dirxml(...arguments: Object[]): void + +此方法调用 console.log() 将接收到的参数传给它。此方法不会产生任何 XML 格式。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| arguments | Object | 否 | 要打印的信息。 | + +## console.group10+ + +group(...arguments: Object[]): void + +将后续行的缩进增加 groupIndentation 长度的空格。 +如果提供需要打印的信息,首先先打印信息,没有额外的缩进。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| arguments | Object | 否 | 要打印的信息。 | +## console.groupCollapsed10+ + +groupCollapsed(...arguments: Object[]): void + +group的别名。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| arguments | Object | 否 | 要打印的信息。| + +## console.groupEnd10+ + +groupEnd(): void + +将后续行的缩进减少 groupIndentation 长度的空格。 + +**系统能力:** SystemCapability.Utils.Lang + +## console.table10+ + +table(tableData?: Object): void + +以表格形式打印数据。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| tableData | Object | 否 | 要打印为表格形式的对象。 | + +**示例:** +``` +console.table([1, 2, 3]); +// ┌─────────┬────────┐ +// │ (index) │ Values │ +// ├─────────┼────────┤ +// │ 0 │ 1 │ +// │ 1 │ 2 │ +// │ 2 │ 3 │ +// └─────────┴────────┘ + +console.table({ a: [1, 2, 3, 4, 5], b: 5, c: { e: 5 } }); + +// ┌─────────┬───┬───┬───┬───┬───┬───┬────────┐ +// │ (index) │ 0 │ 1 │ 2 │ 3 │ 4 │ e │ Values │ +// ├─────────┼───┼───┼───┼───┼───┼───┼────────┤ +// │ a │ 1 │ 2 │ 3 │ 4 │ 5 │ │ │ +// │ b │ │ │ │ │ │ │ 5 │ +// │ c │ │ │ │ │ │ 5 │ │ +// └─────────┴───┴───┴───┴───┴───┴───┴────────┘ +``` +## console.time10+ + +time(label?: string): void + +启动可用于计算操作持续时间的计时器。默认值为'default'。可使用console.timeEnd()关闭计时器并打印结果。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| label | string | 否 | 计时器标识。 | + +## console.timeEnd10+ + +timeEnd(label?: string): void + +停止之前通过调用 console.time() 启动的计时器并将结果打印。默认值为'default'。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| label | string | 否 | 计时器标识。 | + +**示例:** +``` +console.time('abc'); +console.timeEnd('abc'); +// abc: 225.438ms +``` + +## console.timeLog10+ + +timeLog(label?: string, ...arguments: Object[]): void + +对于先前通过调用 console.time() 启动的计时器,打印经过时间和其他 data 参数。 + +**系统能力:** SystemCapability.Utils.Lang + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ----------- | +| label | string | 否 | 计时器标识。 | +| arguments | Object | 否 | 需要打印的其他日志。 | + +**示例:** +``` +console.time('timer1'); +const value = aaa(); // 返回 17 +console.timeLog('timer1', value); +// timer1: 365.227ms 17 +console.timeEnd('timer1'); +// timer1: 513.22ms +``` \ No newline at end of file