Application:error 事件
error 事件在有没被捕获的异常时派发。它由运行时自己派发,不来自系统。
语法
application.addEventListener('error', (event) => { })事件对象
| 字段 | 类型 | 含义 |
|---|---|---|
message | 字符串 | 错误的摘要文字,由引擎生成 |
error | unknown | 抛出来的那个值 |
filename | 字符串 | 出错的脚本名,例如 'main.js' |
lineno | 数字 | 出错的行号 |
target 是 application。cancelable 是 true:调 preventDefault() 的效果是运行时不再输出默认的错误日志。
什么时候派发
- 异常出现在
main.js顶层、定时器的回调、事件监听器的回调(包括sceneconnect的回调、按钮的点击回调),并且没有被try/catch接住时派发。脚本顶层的验证过;定时器回调里的未在模拟器验证。 - 事件监听器抛出异常时,
error在同一个事件的下一个监听器执行之前就派发了,其余监听器照常执行(实测)。 error的监听器自己抛出的异常不会再次派发error,只向控制台输出默认日志。Promise的拒绝不走这里,走unhandledrejection。- 没有监听器调
preventDefault()时,运行时用console.error的级别输出一条以Uncaught开头的日志。调了只取消这条日志:异常已经发生,被中断的代码不会恢复执行。
示例
js
application.addEventListener('error', (e) => {
console.log('出错位置', e.filename, e.lineno);
console.log('是 Error 对象吗', e.error instanceof Error);
e.preventDefault();
});
throw new Error('没人接的异常');结果
- 控制台输出
出错位置 main.js加上throw那一行的行号。 - 控制台输出
是 Error 对象吗 true。 - 因为调了
preventDefault(),运行时不再输出默认的错误日志。
注意:监听器要写在
main.js的最前面。排在它前面的顶层代码抛出的异常它收不到。
对应的 iOS API
没有对应的系统 API。对应浏览器的 window 上的 error 事件。