{hero}

dt 错误

自 DataTables 2.0 起可用

错误事件 - 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)

参数

示例

将此事件用作自定义错误处理程序

DataTable.ext.errMode = 'none';

$('#example')
	.on('error.dt', function (e, settings, techNote, message) {
		console.log('An error has been reported by DataTables: ', message);
	})
	.DataTable();

相关

以下选项直接相关,并且在应用程序开发中也可能很有用。