console
优质
小牛编辑
129浏览
2023-12-01
Console模块用于跟踪调试的API,可根据调试需求输出日志,协助开发人员定位业务逻辑问题。
方法:
权限:
5+功能模块(permissions)
{
// ...
"permissions":{
// ...
"Console": {
"description": "日志,跟踪调试输出日志信息"
}
}
}
log
记录用户日志
plus.console.log( obj, ... );
说明:
调用此方法在日志文件中写入日志信息。
参数:
- obj: ( Object ) 必选 要写入日志文件的对象
为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
- ...: ( Object ) 可选 要写入日志文件的其它对象
不定个数参数,为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
返回值:
void : 无平台支持:
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Console Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
plus.console.log( "Plus ready for log!" );
}, false );
</script>
</head>
<body>
</body>
</html>
info
记录用户提示信息
plus.console.info( obj, ... );
说明:
调用此方法在日志文件中写入提示信息。
参数:
- obj: ( Object ) 必选 要写入日志文件的对象
为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
- ...: ( Object ) 可选 要写入日志文件的其它对象
不定个数参数,为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
返回值:
void : 无平台支持:
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Console Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
plus.console.info( "Plus ready for info!" );
}, false );
</script>
</head>
<body>
</body>
</html>
warn
记录用户警告信息
plus.console.warn( obj, ... );
说明:
调用此方法在日志文件中写入警告信息。
参数:
- obj: ( Object ) 必选 要写入日志文件的对象
为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
- ...: ( Object ) 可选 要写入日志文件的其它对象
不定个数参数,为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
返回值:
void : 无平台支持:
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Console Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
plus.console.warn( "Plus ready for warn!" );
}, false );
</script>
</head>
<body>
</body>
</html>
error
记录用户错误信息
plus.console.error( obj, ... );
说明:
调用此方法在日志文件中写入警告信息。
参数:
- obj: ( Object ) 必选 要写入日志文件的对象
为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
- ...: ( Object ) 可选 要写入日志文件的其它对象
不定个数参数,为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
返回值:
void : 无平台支持:
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Console Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
plus.console.error( "Plus ready for error!" );
}, false );
</script>
</head>
<body>
</body>
</html>
assert
断言操作
plus.console.assert( expression );
说明:
如果执行语句不为true则终止脚本运行并抛出异常,并把异常记录到日志中。
参数:
- obj: ( Object ) 必选 要断言的脚本
返回值:
void : 无平台支持:
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Console Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
plus.console.assert( trueAssert() );
plus.console.assert( falseAssert() );
}, false );
function trueAssert() {
var s1 = "Hello";
var t = "abc" + s1;
return true;
}
function falseAssert() {
}
</script>
</head>
<body>
</body>
</html>