滑鼠按鍵測試可以確認瀏覽器偵測到哪些按鍵，並為每次按下動作指派正確的 MouseEvent.button 程式碼。滑鼠測試工具會記錄虛線目標區內的每一次點擊，顯示事件總次數、按鍵名稱以及原始數值程式碼(主要按鍵為 0、輔助按鍵為 1、次要按鍵為 2、上一頁為 3、下一頁為 4)。這能讓您驗證滑鼠的實體按鍵是否符合瀏覽器預期的輸入，這對於遊戲、輔助功能工具以及自訂快捷鍵來說至關重要。不同於系統層級的滑鼠公用程式，此工具完全在您的瀏覽器中運作，因此可在任何配備滑鼠或觸控板的裝置上使用——無需下載或管理員權限。
許多使用者以為滑鼠按鍵運作正常，卻發現上一頁或下一頁按鍵被辨識為次要點擊，或是輔助按鍵完全沒有被偵測到。這種不相符的情況常在遊戲時浮現，因為設定錯誤的按鍵會破壞按鍵綁定，或在使用螢幕閱讀器時，未偵測到的按鍵會限制導覽功能。滑鼠測試工具能立即顯示瀏覽器實際接收到的按鍵程式碼，讓您無需猜測即可調整設定或排除硬體問題。對開發者而言，這也是快速測試網頁應用程式如何處理非標準按鍵輸入(例如配備 12 個以上按鍵的遊戲滑鼠)的便捷方式。
若您正在測試新滑鼠或除錯現有滑鼠，將滑鼠測試工具與鍵盤測試工具搭配使用，有助於排除更廣泛的輸入問題。針對時效敏感的測試(例如測量點擊速度),CPS 測試工具可透過追蹤主要按鍵的每秒點擊次數來加以輔助。這些工具合計涵蓋了完整的輸入測試範圍，且無需離開瀏覽器。
為什麼滑鼠按鍵可能無法正確註冊
滑鼠按鍵可能因多種原因而無法註冊或註冊錯誤，通常與硬體、驅動程式或瀏覽器限制有關。最常見的問題包括:
- 驅動程式衝突: 過時或通用的驅動程式可能無法將輔助按鍵(如上一頁/下一頁)對應到正確的程式碼，導致它們顯示為次要點擊或完全無法偵測。
- 硬體磨損: 滑鼠微動開關的物理損壞可能導致按鍵雙擊、卡住或完全失效。這在高使用頻率的按鍵(如主要按鍵或滾輪)上特別常見。
- 瀏覽器限制: 某些瀏覽器會基於安全考量封鎖或重新對應非標準按鍵(例如側邊按鍵)，特別是在 kiosk 或公用電腦等沙盒化環境中。
- 自訂按鍵對應: 遊戲軟體(例如 Logitech G Hub、Razer Synapse)或系統公用程式(例如 AutoHotkey)可能會覆寫預設按鍵行為，導致它們觸發非預期動作或完全沒有動作。
- 輔助功能設定: 作業系統層級的輔助功能(例如輔助鍵或滑鼠鍵)可能透過延遲或變更輸入事件來干擾按鍵偵測。
舉例來說，遊戲滑鼠的「上一頁」按鍵可能被程式化為觸發鍵盤快捷鍵(例如 Alt+向左鍵)，而非傳送原始的按鍵程式碼(3)。在這種情況下，即使實體按鍵在其他應用程式中運作正常，滑鼠測試工具仍不會顯示上一頁按鍵的任何事件。類似地，磨損的主要按鍵可能會被註冊為兩次點擊(「雙擊」)而非一次，工具會將其記錄為兩個具有相同按鍵程式碼(0)的獨立事件。
如何使用滑鼠測試工具測試滑鼠按鍵
- 在瀏覽器中開啟滑鼠測試工具。無需安裝或註冊——它完全在您的裝置上運作。
- 將滑鼠游標移至虛線目標區域內。該工具只會記錄在此區域內的點擊。
- 逐一按下每個滑鼠按鍵，從主要(左)按鍵開始。觀察事件是否出現在目標區下方的記錄中。
- 檢查記錄中的三項細節:
- 事件總次數，會在每次有效的按鍵按下時遞增。
- 按鍵名稱(例如「左」「右」「上一頁」)，可確認瀏覽器如何解讀該輸入。
- 按鍵程式碼(例如 0、1、2)，符合W3C MouseEvent.button 規格。
- 對所有可用的按鍵重複此步驟，包括輔助(中間/滾輪)、上一頁及下一頁按鍵。若某個按鍵沒有註冊，請注意它是完全消失還是被對應到非預期的程式碼。
- 若需要重新測試或清除記錄，請點擊重置測試按鈕。這會在無需重新整理頁面的情況下清除所有先前的事件。
- 為了進行比較，請在不同的瀏覽器或應用程式(例如遊戲或文字編輯器)中開啟此工具，並重複測試，觀察行為是否有所改變。
解讀按鍵程式碼
滑鼠測試工具會以符合 MouseEvent.button 之 W3C 標準的數值程式碼，記錄每一次按鍵按下。這些程式碼在所有現代瀏覽器(Chrome、Firefox、Edge、Safari)中都保持一致，定義如下:
| 按鍵程式碼 | 按鍵名稱 | 常見實體按鍵 | 常見用途 |
|---|---|---|---|
| 0 | 主要 | 左鍵 | 選取文字、點擊連結、拖曳物件。 |
| 1 | 輔助 | 中鍵(滾輪點擊) | 在新分頁中開啟連結、在地圖或 CAD 軟體中平移。 |
| 2 | 次要 | 右鍵 | 內容選單、次要動作(例如「內容」)。 |
| 3 | 上一頁 | 側邊按鍵(通常靠近拇指) | 在瀏覽器或檔案總管中向後導覽。 |
| 4 | 下一頁 | 側邊按鍵(通常靠近拇指，與上一頁相對) | 在瀏覽器或檔案總管中向前導覽。 |
若您的滑鼠有額外的按鍵(例如 DPI 切換鍵、巨集按鍵)，若這些按鍵由專有軟體而非瀏覽器處理，則可能無法在工具中註冊。舉例來說，Logitech G502 的「DPI 切換」按鍵可能會觸發瀏覽器忽略的系統層級事件。在這種情況下，請檢查滑鼠的軟體(例如 Logitech G Hub)，確認該按鍵是否已對應至鍵盤快捷鍵或巨集，這就能解釋為何它不會出現在滑鼠測試工具的記錄中。
對開發者而言，在為網頁應用程式撰寫事件處理常式時，這些程式碼至關重要。例如，遊戲可能會使用 event.button === 3 來觸發「上一頁」動作，但若使用者的滑鼠傳送了不同的程式碼(例如右鍵的 2)，該動作便無法運作。滑鼠測試工具可協助識別這些不相符之處，讓您能調整程式碼或記錄支援的硬體。
在特定應用程式中測試滑鼠按鍵
雖然滑鼠測試工具可確認瀏覽器如何解讀按鍵按下，但部分應用程式(例如遊戲、CAD 軟體或輔助功能工具)可能會以不同的方式處理輸入。以下說明在常見情境中測試滑鼠按鍵的方式:
遊戲(例如第一人稱射擊遊戲、大型多人線上遊戲)
- 啟動遊戲並開啟其按鍵綁定或控制選單。
- 嘗試將非主要按鍵(例如上一頁或下一頁)重新綁定至某個動作(例如「裝填」或「跳躍」)。
- 若遊戲未偵測到該按鍵，請注意它是完全消失還是被對應到非預期的動作(例如上一頁按鍵觸發了主要動作)。
- 在瀏覽器分頁中開啟滑鼠測試工具，按下相同的按鍵，觀察是否會註冊。若會註冊，則問題可能出在遊戲的輸入處理或您的滑鼠軟體上。
- 檢查滑鼠軟體(例如 Razer Synapse、Corsair iCUE)，確認該按鍵並未重新對應至遊戲無法識別的鍵盤快捷鍵。
輔助功能工具(例如螢幕閱讀器、開關控制)
- 開啟輔助功能工具的設定(例如 Windows 朗讀程式、macOS VoiceOver 或 NVDA)。
- 導覽至輸入或滑鼠設定，尋找自訂按鍵動作的選項。
- 按下非主要按鍵(例如上一頁或輔助鍵)，檢查工具是否會朗報按鍵名稱，或讓您為其指派動作。
- 若該按鍵未被偵測，請開啟滑鼠測試工具並按下相同的按鍵，確認瀏覽器是否接收到該事件。若有，則問題出在輔助功能工具的輸入處理上。
- 請參閱工具的說明文件，了解支援的按鍵程式碼或相容性注意事項。某些工具可能需要特定驅動程式或瀏覽器擴充功能才能偵測輔助按鍵。
生產力軟體(例如 Photoshop、Excel、AutoCAD)
- 開啟軟體並導覽至其偏好設定或自訂選單(例如 Photoshop 的編輯 > 鍵盤快捷鍵)。
- 嘗試將非主要按鍵指派至某個指令(例如「放大」或「復原」)。
- 若軟體未偵測到該按鍵，請注意它是消失還是被對應到非預期的動作(例如上一頁按鍵觸發了右鍵點擊)。
- 開啟滑鼠測試工具並按下相同的按鍵，驗證瀏覽器是否偵測到該按鍵。若有，則問題可能出在軟體的輸入處理或滑鼠驅動程式上。
- 請參閱軟體的說明文件，了解支援的輸入裝置或已知的相容性問題。部分應用程式可能需要特定驅動程式或外掛程式才能識別輔助按鍵。
疑難排解：按鍵未被偵測
如果滑鼠測試工具沒有記錄到按鍵按下事件，請依照下列步驟來釐清問題：
1. 確認按鍵在實體上可正常運作
- 在實體表面（例如桌面）上按下該按鍵，確認能聽到清脆的喀噠聲並有明確的回饋感。如果沒有，按鍵可能卡住或損壞。
- 在不同的應用程式中測試該按鍵（例如記事本、遊戲，或瀏覽器的網址列）。如果在其他地方可正常運作，問題很可能出在滑鼠測試工具或瀏覽器上。
2. 檢查瀏覽器權限
- 確認瀏覽器並未封鎖滑鼠輸入。某些瀏覽器（例如 kiosk 模式下的 Chrome）會基於安全考量限制非主要按鍵。
- 嘗試使用不同的瀏覽器（例如 Firefox 或 Edge）看看按鍵是否能被記錄。如果可以，表示問題出在您原本使用的瀏覽器設定或擴充功能上。
- 停用可能干擾輸入事件的瀏覽器擴充功能（例如廣告封鎖程式、腳本封鎖程式）。重新啟動瀏覽器後再測試一次。
3. 更新或重新安裝滑鼠驅動程式
- 在 Windows 上：開啟裝置管理員，展開滑鼠及其他指標裝置，在您的滑鼠上按右鍵，然後選擇更新驅動程式。如果無效，請解除安裝驅動程式並重新啟動電腦，以強制重新安裝。
- 在 macOS 上：前往系統偏好設定 > 滑鼠，檢查是否有韌體更新。如果沒有可用的更新，請依照 Apple 的指南重置系統管理控制器（SMC）。
- 若是電競滑鼠，請安裝原廠提供的軟體（例如 Logitech G Hub、Razer Synapse），並確認該按鍵沒有被重新對應到鍵盤快速鍵或巨集。
4. 在其他裝置上測試
- 將滑鼠連接到其他電腦或裝置（例如筆記型電腦或平板），然後在滑鼠測試工具中重複測試。如果按鍵可正常運作，表示問題出在原本裝置的硬體或軟體。
- 如果按鍵仍然無法運作，可能是滑鼠本身有瑕疵。請嘗試在原本的裝置上使用另一隻滑鼠來確認。
5. 檢查系統層級的干擾
- 在作業系統設定中停用輔助功能（例如「黏滯鍵」、「滑鼠鍵」）。這些功能可能會延遲或變更按鍵輸入。
- 在 Windows 上：前往設定 > 輔助功能 > 滑鼠指標與觸控，停用所有滑鼠相關選項。
- 在 macOS 上：前往系統偏好設定 > 輔助功能 > 指標控制，停用所有滑鼠相關選項。
- 重新啟動電腦，然後在滑鼠測試工具中重新測試該按鍵。
進階：將滑鼠測試工具用於開發工作
對於網頁開發者來說，滑鼠測試工具是快速驗證瀏覽器如何處理滑鼠事件的好方法，特別是在非標準按鍵方面。以下是如何將它整合進您工作流程的方法：
測試事件處理常式
如果您正在撰寫依賴特定按鍵代碼的 JavaScript（例如遊戲或自訂 UI），可以使用滑鼠測試工具來確認您的目標瀏覽器會送出哪些代碼。例如：
<script>
document.addEventListener('mousedown', (event) => {
console.log(`Button pressed: ${event.button}`);
// 0 = primary, 1 = auxiliary, 2 = secondary, etc.
});
</script>在滑鼠測試工具中依序按下每個按鍵，即可在瀏覽器的控制台中看到記錄下來的 event.button 值。這有助於您撰寫具有防禦性的程式碼，以應對硬體或瀏覽器行為上的差異。
除錯跨瀏覽器問題
某些瀏覽器（例如較舊版本的 Safari 或 Internet Explorer）處理按鍵代碼的方式可能不同。請使用滑鼠測試工具來比較各瀏覽器間的行為差異，並據此調整您的程式碼。例如：
- 在 Internet Explorer 8 及更早版本中，
event.button屬性使用不同的位元遮罩（例如 1 代表主要鍵、2 代表次要鍵、4 代表輔助鍵）。現代瀏覽器則使用 W3C 標準（0、1、2 等）。 - 某些行動瀏覽器或觸控螢幕裝置可能不支援所有按鍵代碼，特別是輔助鍵或側邊按鍵。
記錄硬體需求
如果您的網頁應用程式依賴特定的滑鼠按鍵（例如使用中鍵進行平移的 CAD 工具），可以使用滑鼠測試工具記錄使用者需要啟用哪些按鍵。例如：
- 「本應用程式需要配備中鍵（按鍵代碼 1）的滑鼠才能進行平移。如果您的滑鼠沒有此按鍵，您可能需要在滑鼠的軟體中將其他按鍵重新對應。」
- 「為享有完整功能，請確認您的瀏覽器支援 W3C 的
MouseEvent.button規範。請使用滑鼠測試工具來測試您的滑鼠。」
將滑鼠測試工具整合到您的測試流程中，可以及早發現與輸入相關的錯誤，並針對硬體相容性為使用者提供更清楚的指引。
相關主題：如何測試鍵盤是否有死鍵或卡鍵。
想深入了解，請參閱在 Keka 中使用網頁打卡：透過線上瀏覽器時鐘。
想深入了解，請參閱使用瀏覽器白板進行即時線上教學。