寫測試或做自動化時,常需要由程式碼主動觸發某個事件。IE 提供 fireEvent,標準瀏覽器則用 dispatchEvent,兩者介面差異不小,因此實務上會包成一個相容函式。
function simulateClick(el) {
var evt;
if (document.createEvent) {
// DOM Level 2 標準做法
evt = document.createEvent("MouseEvents");
evt.initMouseEvent("click", true, true, window,
0, 0, 0, 0, 0, false, false, false, false, 0, null);
el.dispatchEvent(evt);
} else if (el.fireEvent) {
// IE
el.fireEvent('onclick');
}
}
function simulateDrag(el) {
var evt;
if (document.createEvent) {
evt = document.createEvent("MouseEvent");
evt.initMouseEvent("dragstart", true, true, window,
0, 0, 0, 0, 0, false, false, false, false, 0, null);
el.dispatchEvent(evt);
} else if (el.fireEvent) {
el.fireEvent('ondragstart');
}
}
這一長串數字容易嚇人,其實順序固定:事件類型、是否冒泡、是否可取消、檢視物件、detail、螢幕座標 screenX/screenY、客戶座標 clientX/clientY、按鍵 ctrlKey、altKey、shiftKey、metaKey、滑鼠按鈕 button、相關目標 relatedTarget。範例中的前兩個 true 讓事件會冒泡且可被 preventDefault 取消,這通常是我們想要的行為。
今天不必再手動填 initMouseEvent 的十幾個參數,用建構式加上物件字面值清楚得多:
// 觸發 click
el.dispatchEvent(new MouseEvent('click', {
bubbles: true,
cancelable: true,
view: window
}));
// 觸發自訂事件並帶資料
el.dispatchEvent(new CustomEvent('myevent', {
detail: { id: 1 },
bubbles: true
}));
// 舊瀏覽器的簡短替代寫法
var evt = document.createEvent('HTMLEvents');
evt.initEvent('click', true, true);
el.dispatchEvent(evt);
用 dispatchEvent 觸發的事件是「合成的」,event.isTrusted 會是 false,這與使用者真實點擊不同。多數場合沒有影響,但涉及需要使用者手勢授權的 API(如剪貼簿、全螢幕、音訊播放)時,合成事件不會被接受。測試框架如 Cypress 的 click() 之所以能通過這類檢查,是因為它透過開發工具協定模擬了真實輸入。