dt 错误
错误事件 - DataTables 处理数据时发生错误。
内容
错误控制在任何复杂应用程序中都是重要的考虑因素,DataTables 提供此事件,使您可以将自己的应用程序错误处理绑定到 DataTables。例如,您可以触发一个 Ajax 调用来记录要调查的错误,或使用错误事件向最终用户显示自定义错误消息。
此事件与控制 DataTables 如何处理错误的 DataTable.ext.errMode
选项齐头并进。该静态选项可以采用四个值之一
alert
(默认) - 警报错误throw
- 抛出 JavaScript 错误none
- 不执行任何操作(在这种情况下应使用此error
)function
- 当发生错误时调用,适用于页面上所有 DataTables 的一个常用函数。
请注意,与所有 DataTables 发出的事件一样,事件对象在其上有一个可用的 DataTables API 实例(第一个参数)。此外,这些事件使用 dt
名称空间触发。因此,要侦听此事件,您必须还使用 dt
名称空间,方法是简单地将 .dt
附加到事件名称后,如以下示例所示。
此事件将在文档中冒泡,因此您可以在 body
中添加 dt-error.dt
的侦听器,以捕获由 DataTables 触发的所有错误事件。
在 DataTables 2 之前,此事件仅称为 error
,但是,这样会导致 onerror
DOM0 事件处理程序被触发,如果您正在监控您的网站是否存在脚本错误,则会导致错误日志记录。
类型
function 功能(e, settings, techNote, message)
- 参数
名称 类型 必填 1 e
否 jQuery 事件对象
2 settings
否 DataTables 设置对象
3 techNote
否 Tech Note 错误编号 - 使用
https://datatables.net.cn/tn/{techNote}
查看说明4 message
否 错误描述
示例
将此事件用作自定义错误处理程序
DataTable.ext.errMode = 'none';
$('#example')
.on('error.dt', function (e, settings, techNote, message) {
console.log('An error has been reported by DataTables: ', message);
})
.DataTable();
相关
以下选项直接相关,并且在应用程序开发中也可能很有用。