AJAX 已成為 Web 技術領域最熱門的話題,其關鍵是名為 XMLHttpRequest 的 JavaScript 物件。它讓客戶端開發人員能在不打斷使用者操作的情況下,透過 HTTP 直接送出與接收 XML 文件。本文示範如何結合 XMLHttpRequest 與 JavaScript 錯誤處理,把客戶端錯誤回報到伺服器記錄。
新近的瀏覽器支援類似 C++ 與 Java 的 try/catch/finally 錯誤處理關鍵字,並實作了 onerror 事件來攔截執行期產生的錯誤:
function riskyBusiness() {
try {
riskyOperation1();
riskyOperation2();
} catch (e) {
// e 是錯誤型別物件,至少有 name 與 message 兩個屬性
} finally {
// 清理工作
}
}
window.onerror = handleError;
function handleError(message, URI, line) {
// 提示用戶該頁可能無法正確回應
return true; // 終止預設訊息
}
我們建立一個 Logger 類別,讓它在使用時只實例化一次,並透明地處理細節。首先是建構子:
function Logger() {
this.req;
this.errorToXML = errorToXML;
this.log = log;
}
接著定義把 Error 物件轉成 XML 的方法:
function errorToXML(err) {
var xml = '<?xml version="1.0"?>\n' +
'<error>\n' +
'<name>' + err.name + '</name>\n' +
'<message>' + err.message + '</message>\n';
if (err.location) xml += '<location>' + err.location + '</location>';
xml += '</error>';
return xml;
}
接著是 log 方法,它把 XMLHttpRequest 與 XML DOM 結合起來。這裡使用 POST 方法,因為本質上是在建立一個只寫的定制 Web 服務:
function log(err) {
if (window.XMLHttpRequest) this.req = new XMLHttpRequest();
else if (window.ActiveXObject) this.req = new ActiveXObject("Microsoft.XMLHTTP");
else return;
this.req.open("POST", "/cgi-bin/AjaxLogger.cgi");
this.req.setRequestHeader('REFERER', location.href);
this.req.setRequestHeader('content-type', 'text/XML');
this.req.onreadystatechange = errorLogged;
this.req.send(this.errorToXML(err));
this.timeout = window.setTimeout("abortLog();", 10000);
}
最後實例化 Logger(只能有一個實例),並定義兩個輔助方法處理逾時與狀態變化:
var logger = new Logger();
function abortLog() {
logger.req.abort();
alert("Attempt to log the error timed out.");
}
function errorLogged() {
if (logger.req.readyState != 4) return;
window.clearTimeout(logger.timeout);
if (logger.req.status >= 400)
alert('Attempt to log the error failed.');
}
<script type="text/javascript" src="Logger.js"></script>
<script type="text/javascript">
function trapError(msg, URI, ln) {
var error = new Error(msg);
error.location = URI + ', line: ' + ln;
logger.log(error);
warnUser();
return true;
}
window.onerror = trapError;
</script>
伺服器端則可用 CGI 腳本接收並解析客戶端傳來的訊息,透過 XML::Simple 解析資料、用 CGI::Carp 把結果寫入 httpd 的錯誤記錄,讓系統管理者不必另外監控日誌。當含有問題的 JavaScript 溜進系統時,就能第一時間被記錄下來,及早發現並修正。