在事件處理函數中,如何區分事件是由用戶真實操作(點擊、鍵盤)觸發,還是由代碼調用 .trigger()、.click() 等程序化觸發?
// 綁定事件,接收額外參數
$('button').on('click', function(event, isTriggered) {
if (isTriggered) {
console.log('代碼觸發');
} else {
console.log('用戶點擊');
}
});
// 程序化觸發時傳遞 true
$('button').trigger('click', [true]); // 陣列形式傳參
// 或
$('button').trigger('click', true); // 單參數 (jQuery 內部轉為陣列)
// 等價簡寫
$('button').click(true); // 內部調用 trigger('click', true)
jQuery 的 trigger(event, extraParameters) 會將 extraParameters 作為參數傳給處理函數,位置在 event 對象之後:
// jQuery 內部簡化邏輯
function trigger(event, extraParams) {
const handler = elements[0].events[event.type];
// handler.call(element, event, ...extraParams)
handler.apply(element, [event].concat(extraParams || []));
}
如果不想修改所有 trigger 調用處,可檢查事件對象特徵:
$('button').on('click', function(e) {
// 1. 檢查 isTrigger 內部標記 (jQuery 內部屬性)
if (e.isTrigger) {
console.log('jQuery trigger 觸發');
return;
}
// 2. 檢查 originalEvent (原生事件)
// 用戶真實操作有 originalEvent,程序觸發通常沒有
if (!e.originalEvent) {
console.log('可能是程序觸發');
} else {
console.log('用戶真實操作');
}
// 3. 組合判斷(更可靠)
const isProgrammatic = e.isTrigger || !e.originalEvent || e.isSimulated;
if (isProgrammatic) {
// 程序觸發邏輯
}
});
const btn = document.querySelector('button');
btn.addEventListener('click', function(e) {
// 原生事件有 isTrusted 屬性 (標準)
if (e.isTrusted) {
console.log('用戶真實操作');
} else {
console.log('代碼觸發 (dispatchEvent)');
}
});
// 程序觸發
btn.dispatchEvent(new MouseEvent('click', {bubbles: true}));
// e.isTrusted === false
關鍵差異:原生 Event.isTrusted 是標準、只讀、不可偽造;jQuery 無對應標準屬性,需約定俗成參數傳遞。
$('#toggle').on('change', function(e, fromCode) {
if (fromCode) return; // 代碼觸發不處理,防止死循環
const checked = this.checked;
$('#related').prop('checked', checked).trigger('change', [true]);
});
// 頁面加載時設置默認值,不觸發業務邏輯
$('#select').val(defaultVal).trigger('change', [true]);
// 用戶手動選擇時觸發業務邏輯
$('#select').on('change', function(e, fromCode) {
if (!fromCode) {
loadData(this.value); // 只在用戶操作時請求數據
}
});
// 單元測試中
test('用戶點擊提交按鈕', () => {
// 使用 isTrusted: true 模擬真實用戶 (需現代瀏覽器/JSdom 配置)
fireEvent.click(screen.getByRole('button'), {isTrusted: true});
expect(mockFn).toHaveBeenCalled();
});
| 場景 | 推薦方案 |
|---|---|
| 可控制所有 trigger 調用處 | 額外參數 trigger('event', [true]) - 最清晰 |
| 第三方插件/不可控代碼觸發 | 檢查 e.isTrigger || !e.originalEvent |
| 現代項目/原生事件監聽 | 使用 e.isTrusted (原生標準) |
| 需要區分具體觸發源 | 自定義事件 trigger('click:user') vs trigger('click:code') |
jQuery 中區分事件觸發源的標準方式是 trigger(event, [true]) 額外參數傳遞。現代項目建議逐步遷移至原生 addEventListener 並使用標準的 event.isTrusted 屬性,這是更可靠、標準化的方案。