dt-error

錯誤事件 - 在 DataTables 處理資料期間發生錯誤。

描述

在任何複雜的應用程式中，錯誤控制都是一個重要的考量，而 DataTables 提供了這個事件，讓您可以將應用程式本身的錯誤處理掛鉤到 DataTables 中。例如，您可以觸發 Ajax 呼叫來記錄錯誤以供調查，或使用錯誤事件向最終使用者顯示自訂錯誤訊息。

此事件與 DataTable.ext.errMode 選項密切相關，該選項控制 DataTables 如何處理錯誤。該靜態選項可以採用以下四個值之一：

• alert（預設）- 警示錯誤
• throw - 拋出 Javascript 錯誤
• none - 不執行任何動作（在這種情況下您會想要使用這個 error）
• function - 當發生錯誤時，在頁面上所有 DataTables 中呼叫的通用函式。

請注意，與所有 DataTables 發出的事件一樣，事件物件在其上具有可用的 DataTables API 實例（第一個參數）。此外，事件會使用 dt 命名空間觸發。因此，若要監聽此事件，您還必須使用 dt 命名空間，只需將 .dt 附加到您的事件名稱即可，如下面的範例所示。

此事件將在文件中向上冒泡，因此您可以將 dt-error.dt 的監聽器新增至 body，以捕獲 DataTables 觸發的所有錯誤事件。

在 DataTables 2 之前，此事件簡稱為 error，但是，這會導致觸發 onerror DOM0 事件處理常式，如果監視網站的腳本錯誤，則會導致虛假的記錄。

類型

範例

DataTable.ext.errMode = 'none';

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

相關

以下選項直接相關，在您的應用程式開發中可能也很有用。