console
Console模块用于跟踪调试的API,可根据调试需求输出日志,协助开发人员定位业务逻辑问题。
方法:
权限:
permissions
"Console": { "description": "跟踪调试输出日志" }
log
记录用户日志
plus.console.log( obj, ... );
说明:
调用此方法在日志文件中写入日志信息。
参数:
- obj:
(
Object
)
必选 要写入日志文件的对象
为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。 - ...:
(
Object
)
可选 要写入日志文件的其它对象
不定个数参数,为兼容各种对象,如果传入的参数不是字符串对象,系统将自动转换为字符串。
返回值:
void : 无平台支持:
- Android2.2+ (支持)
- iOS4.3+ (支持)
- WP7.5+ (支持)
示例:
<!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 : 无平台支持:
- Android2.2+ (支持)
- iOS4.3+ (支持)
- WP7.5+ (支持)
示例:
<!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 : 无平台支持:
- Android2.2+ (支持)
- iOS4.3+ (支持)
- WP7.5+ (支持)
示例:
<!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 : 无平台支持:
- Android2.2+ (支持)
- iOS4.3+ (支持)
- WP7.5+ (支持)
示例:
<!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 : 无平台支持:
- Android2.2+ (支持)
- iOS4.3+ (支持)
- WP7.5+ (支持)
示例:
<!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>