• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# console (控制台)
2
3本模块提供了一个简单的调试控制台,类似于浏览器提供的JavaScript控制台机制。
4
5> **说明:**
6>
7> 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## console.debug
10
11debug(message: string, ...arguments: any[]): void
12
13以格式化输出方式打印调试信息。
14
15从API version 9开始,该接口支持在ArkTS卡片中使用。
16
17**系统能力:** SystemCapability.ArkUI.ArkUI.Full
18
19**参数:**
20
21| 参数名     | 类型     | 必填   | 说明          |
22| ------- | ------ | ---- | ----------- |
23| message | string | 是    | 表示要打印的文本信息。 |
24| arguments | any[] | 否    | 表示其余要打印的信息或message的替换值。 |
25
26**示例:**
27
28```js
29const number = 5;
30console.debug('count: %d', number);  // 格式化输出替换message中的文本。
31// count: 5
32console.debug('count:', number);  // 打印message以及其余信息
33// count: 5
34console.debug('count:'); // 仅打印message
35// count:
36```
37
38## console.log
39
40log(message: string, ...arguments: any[]): void
41
42以格式化输出方式打印日志信息。
43
44从API version 9开始,该接口支持在ArkTS卡片中使用。
45
46**系统能力:** SystemCapability.ArkUI.ArkUI.Full
47
48**参数:**
49
50| 参数名     | 类型     | 必填   | 说明          |
51| ------- | ------ | ---- | ----------- |
52| message | string | 是    | 表示要打印的文本信息。 |
53| arguments | any[] | 否    |表示其余要打印的信息或message的替换值。 |
54
55**示例:**
56
57```js
58const number = 5;
59console.log('count: %d', number);  // 格式化输出替换message中的文本。
60// count: 5
61console.log('count:', number);  // 打印message以及其余信息
62// count: 5
63console.log('count:'); // 仅打印message
64// count:
65```
66
67## console.info
68
69info(message: string, ...arguments: any[]): void
70
71以格式化输出方式打印日志信息。(console.log()的别名)。
72
73从API version 9开始,该接口支持在ArkTS卡片中使用。
74
75**系统能力:** SystemCapability.ArkUI.ArkUI.Full
76
77**参数:**
78
79| 参数名     | 类型     | 必填   | 说明          |
80| ------- | ------ | ---- | ----------- |
81| message | string | 是    | 表示要打印的文本信息。 |
82| arguments | any[] | 否    | 表示其余要打印的信息或message的替换值。 |
83
84**示例:**
85
86```js
87const number = 5;
88console.info('count: %d', number);  // 格式化输出替换message中的文本。
89// count: 5
90console.info('count:', number);  // 打印message以及其余信息
91// count: 5
92console.info('count:'); // 仅打印message
93// count:
94```
95
96## console.warn
97
98warn(message: string, ...arguments: any[]): void
99
100以格式化输出方式打印警告信息。
101
102从API version 9开始,该接口支持在ArkTS卡片中使用。
103
104**系统能力:** SystemCapability.ArkUI.ArkUI.Full
105
106**参数:**
107
108| 参数名     | 类型     | 必填   | 说明          |
109| ------- | ------ | ---- | ----------- |
110| message | string | 是    | 表示要打印的警告信息。 |
111| arguments | any[] | 否    | 表示其余要打印的信息或message的替换值。 |
112
113**示例:**
114
115```js
116const str = "name should be string";
117console.warn('warn: %d', str);  // 格式化输出替换message中的文本。
118// warn: name should be string
119console.warn('warn:', str);  // 打印message以及其余信息
120// warn: name should be string
121console.warn('warn:'); // 仅打印message
122// warn:
123```
124
125## console.error
126
127error(message: string, ...arguments: any[]): void
128
129以格式化输出方式打印错误信息。
130
131从API version 9开始,该接口支持在ArkTS卡片中使用。
132
133**系统能力:** SystemCapability.ArkUI.ArkUI.Full
134
135**参数:**
136
137| 参数名     | 类型     | 必填   | 说明          |
138| ------- | ------ | ---- | ----------- |
139| message | string | 是    | 表示要打印的错误信息。 |
140| arguments | any[] | 否    | 表示其余要打印的信息或message的替换值。 |
141
142
143**示例:**
144
145```js
146const str = "value is not defined";
147console.error('error: %d', str);  // 格式化输出替换message中的文本。
148// error: value is not defined
149console.error('error:', str);  // 打印message以及其余信息
150// error: value is not defined
151console.error('error:'); // 仅打印message
152// error:
153```
154
155