若要測試按下的是哪個按鍵,請讓 Key Press Counter 擷取區域取得焦點,然後按下無特殊用途的測試按鍵;瀏覽器接受並回報的 keydown 事件會顯示為其按鍵標籤。
這能辨識目前瀏覽器在可見擷取區域內接收到的標籤,而不是傳送至其他應用程式的按鍵輸入。焦點就是其界限:在頁面其他位置輸入的按鍵會被忽略,但仍可使用 Tab 離開該區域,且不會被計入。

選擇適合的按鍵檢查方式
若任務是辨識瀏覽器接收到的標籤、查看某個標籤出現的次數,或比較一般按壓與瀏覽器標記為按住按鍵的重複事件,請使用 Key Press Counter。它並非完整的鍵盤診斷工具。此工具不會繪製實體配置圖、辨識鍵盤型號、測試每個開關、計算輸入速度或準確度,也不會判定某個按鍵是否故障。
若問題其實是「這個實體按鍵是否會在配置圖中亮起?」,則 Keyboard Tester 更為適合,因為其視覺配置回饋有助於找出會或不會產生事件的按鍵。計數器中出現某個標籤,表示頁面已收到瀏覽器接受的事件;這並不能證明硬體的每個部分都能正常運作。
請將目標範圍保持精確:先辨識目前的按鍵標籤,再使用結果檢視來確認其頻率與近期順序。
如何在瀏覽器中測試按下的是哪個按鍵
- 開始前,請選擇按住按鍵的重複事件處理原則。一般按壓測試時,請關閉 Count held-key repeat events;若想觀察重複的瀏覽器事件,則請啟用它。
- 請點選虛線擷取區域內部,使其取得焦點。計數器只附加於這個可見元素,因此在頁面其他位置按鍵不會被記錄。
- 請逐一按下無特殊用途的測試按鍵。字母、數字鍵、Space,以及 ArrowUp 等具名按鍵,都能辨識瀏覽器的標籤。除 Tab 以外的按鍵在取得焦點的區域內會阻止其一般預設行為,進而減少意外捲動或啟動按鈕的情形。
- 請檢視總數、近期十個標籤及依頻率排序的表格。若在初次測試後變更重複事件選項,請先再次點選擷取區域,再按下更多按鍵。
- 若要離開擷取區域,請隨時使用 Tab。若要在開始新的本機工作階段前清除總數、頻率對應表及近期記錄,請選取 Reset counter。
測試順序應保持中性且審慎。按下一個按鍵,在近期檢視中記下其標籤,然後檢查其頻率是否如預期增加。
解讀總數前先設定重複規則
按住按鍵時,瀏覽器通常會先送出初始 keydown 事件,接著在按鍵持續按住期間傳送標記為重複的事件。關閉重複計數時,標記為重複的事件會讓現有狀態維持不變,因此一般按住按鍵通常只會增加一次接受的計數,而不是每個重複的瀏覽器事件都計入一次。
| 設定 | 計入哪些事件 | 最適合的用途 |
|---|---|---|
| 關閉重複計數 | 接受初始 keydown 事件,並忽略瀏覽器標記為重複的事件 | 簡單的按壓與按住測試,其中一次按住應只計入一次 |
| 啟用重複計數 | 接受初始 keydown 事件,以及每個收到的重複標記事件 | 測量按住按鍵期間所傳送的重複事件 |
比較總數時,這項差異很重要。此工具信任瀏覽器的重複旗標;它不會測量實體去彈間隔,也不會獨立判定重複事件是來自按住按鍵、按鍵連點、自動化工具或無障礙軟體。因此,計數增加只能證明有更多重複事件抵達頁面,無法確立其實體原因。
透過三種結果檢視確認按鍵
總數、近期標籤與頻率表格分別回答不同的問題。確認按下的是哪個按鍵時,請搭配使用這三項資訊。
| 結果檢視 | 提供的資訊 | 無法代表的內容 |
|---|---|---|
| 總數 | 目前工作階段中接受的 keydown 事件數量 | 不重複按鍵或實體按住的數量 |
| 近期十個標籤 | 最近接受的標籤及其抵達順序 | 所有輸入內容的完整記錄 |
| 頻率表格 | 工作階段期間,每個正規化按鍵標籤出現的次數 | 實體鍵盤配置或硬體開關報告 |
頻率資料列會先依計數遞減排序;計數相同時,再依標籤排序。近期記錄只保留最近十個接受的標籤,而頻率對應表涵蓋目前的工作階段。因此,這些輸出可用於確認模式,無須儲存完整的測試重建內容。
選取 Reset counter 會清除總數、頻率對應表及近期記錄。這是無須重新整理頁面,即可開始另一個本機工作階段的手動方式。
瞭解按鍵標籤如何正規化
標籤來自瀏覽器的 KeyboardEvent.key 值,而不是掃描碼、實體配置或鍵帽圖片。此工具會先清理該值,再予以儲存:
- 實際的空格會顯示為 Space。
- 若語系轉換支援,單一可見字元會以大寫顯示。
- ArrowUp 等具名值會保持易於閱讀的形式。
- 控制字元、代理碼點及 Unicode 行分隔符或段落分隔符都會移除。
- 清理後的標籤會去除前後空白;若結果為空,則會變成 Unknown。
儲存的標籤最多限四十個 Unicode 碼點。這些規則能讓顯示結果保持一致,但也表示標籤是瀏覽器層級的表示,而非通用的鍵盤對應表。輸入法、無障礙工具或行動裝置鍵盤,可能提供與實體開關無法一對一對應的標籤。
考量焦點與瀏覽器限制
擷取區域具有明確的焦點界限。其事件處理器只附加至這個可見元素,因此傳送至其他應用程式、瀏覽器對話方塊或頁面其他部分的按鍵輸入,都不在其範圍內。頁面無法回報另一個程式接收到的內容。
部分瀏覽器與作業系統的快速鍵,也可能在頁面收到 keydown 事件前就被攔截。軟體產生的事件、瀏覽器擴充功能、遠端桌面軟體、輸入法、無障礙工具及螢幕小鍵盤,都可能進一步影響最終收到的內容。檢查基本回應時,請使用未經修改、無特殊用途的測試按鍵,而不要使用保留為快速鍵的鍵盤組合。
基於相同原因,結果描述的是瀏覽器事件,而非硬體事實。它們不會顯示掃描碼、輪詢率、延遲、配置正確性或輸入欄位的內容。組合文字也可能對應多個實體動作。缺少記錄是檢查焦點與瀏覽器處理方式的理由,並非按鍵開關故障的證據。
讓測試保持中性且在本機進行
請使用無特殊用途的測試按鍵,並避免在擷取區域中輸入密碼、私人訊息、復原碼或其他敏感內容。計數器會在目前的瀏覽器分頁中執行;接受的標籤與計數不會上傳、儲存至帳戶、自動複製,也 不會在重新整理後保留。
若要快速檢查,請按下一個一般按鍵,在近期檢視中確認其正規化標籤,然後再次按下該鍵,確認對應頻率有所變化。只有需要比較近期順序時,才再加上另一個無特殊用途的按鍵。這套受控流程能回答核心問題——測試按下的是哪個按鍵——同時讓結果與實際接收到的瀏覽器事件保持關聯。