HarmonyOS API:系统基础能力
版本:v3.1 Beta
console (日志打印)
更新时间: 2023-02-17 09:19
本模块提供基础的日志打印能力,支持按照日志级别打印日志信息。
如果需要使用更高级的日志打印服务,比如按照指定标识筛选日志内容,推荐使用@ohos.hilog。
说明
本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
console.debug
debug(message: string): void
打印debug级别的日志信息。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
message | string | 是 | 表示要打印的文本信息。 |
console.log
log(message: string): void
打印debug级别的日志信息。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
message | string | 是 | 表示要打印的文本信息。 |
console.info
info(message: string): void
打印info级别的日志信息。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
message | string | 是 | 表示要打印的文本信息。 |
console.warn
warn(message: string): void
打印warn级别的日志信息。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
message | string | 是 | 表示要打印的文本信息。 |
console.error
error(message: string): void
打印error级别的日志信息。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
message | string | 是 | 表示要打印的文本信息。 |
示例
export default {
clickConsole(){
var versionCode = 1;
console.info('Hello World. The current version code is ' + versionCode);
console.log(`versionCode: ${versionCode}`);
// 以下写法从API Version 6开始支持console.log('versionCode:%d.', versionCode);
}
}
在DevEco Studio的底部,切换到“HiLog”窗口。选择当前的设备及进程,日志级别选择Info,搜索内容设置为“Hello World”。此时窗口仅显示符合条件的日志,效果如图所示:
Timer (定时器)
更新时间: 2023-02-17 09:19
本模块提供基础的定时器能力,支持按照指定的时间执行对应函数。
说明
本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
setTimeout
setTimeout(handler: Function | string, delay?: number, ...arguments: any[]): number
设置一个定时器,该定时器在定时器到期后执行一个函数。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
handler | Function | string | 是 | 定时器到期后执行函数。 |
delay | number | 否 | 延迟的毫秒数,函数的调用会在该延迟之后发生。如果省略该参数,delay取默认值0,意味着“马上”执行,或尽快执行。 |
...arguments | Array<any> | 否 | 附加参数,一旦定时器到期,它们会作为参数传递给handler。 |
返回值:
类型 | 说明 |
number | timeout定时器的ID。 |
示例:
export default {
setTimeOut() {
var timeoutID = setTimeout(function() {
console.log('delay 1s');
}, 1000);
}
}
clearTimeout
clearTimeout(timeoutID: number): void
取消了先前通过调用setTimeout()建立的定时器。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
timeoutID | number | 是 | 要取消定时器的ID, 是由setTimeout()返回的。 |
示例:
export default {
clearTimeOut() {
var timeoutID = setTimeout(function() {
console.log('do after 1s delay.');
}, 1000);
clearTimeout(timeoutID);
}
}
setInterval
setInterval(handler: Function | string, delay: number, ...arguments: any[]): number
重复调用一个函数,在每次调用之间具有固定的时间延迟。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
handler | Function | string | 是 | 要重复调用的函数。 |
delay | number | 是 | 延迟的毫秒数(一秒等于1000毫秒),函数的调用会在该延迟之后发生。 |
...arguments | Array<any> | 否 | 附加参数,一旦定时器到期,他们会作为参数传递给handler。 |
返回值:
类型 | 说明 |
number | intervalID重复定时器的ID。 |
示例:
export default {
setInterval() {
var intervalID = setInterval(function() {
console.log('do very 1s.');
}, 1000);
}
}
clearInterval
clearInterval(intervalID: number): void
可取消先前通过setInterval()设置的重复定时任务。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
intervalID | number | 是 | 要取消的重复定时器的ID,是由 setInterval() 返回的。 |
示例:
export default {
clearInterval() {
var intervalID = setInterval(function() {
console.log('do very 1s.');
}, 1000);
clearInterval(intervalID);
}
}