若要測試按下的是哪個按鍵,請讓 Key Press Counter 擷取區域取得焦點,然後按下無特殊用途的測試按鍵;瀏覽器接受並回報的 keydown 事件會顯示為其按鍵標籤。

這能辨識目前瀏覽器在可見擷取區域內接收到的標籤,而不是傳送至其他應用程式的按鍵輸入。焦點就是其界限:在頁面其他位置輸入的按鍵會被忽略,但仍可使用 Tab 離開該區域,且不會被計入。

test which key is pressed
如何在瀏覽器中測試按下的是哪個按鍵

選擇適合的按鍵檢查方式

若任務是辨識瀏覽器接收到的標籤、查看某個標籤出現的次數,或比較一般按壓與瀏覽器標記為按住按鍵的重複事件,請使用 Key Press Counter。它並非完整的鍵盤診斷工具。此工具不會繪製實體配置圖、辨識鍵盤型號、測試每個開關、計算輸入速度或準確度,也不會判定某個按鍵是否故障。

若問題其實是「這個實體按鍵是否會在配置圖中亮起?」,則 Keyboard Tester 更為適合,因為其視覺配置回饋有助於找出會或不會產生事件的按鍵。計數器中出現某個標籤,表示頁面已收到瀏覽器接受的事件;這並不能證明硬體的每個部分都能正常運作。

請將目標範圍保持精確:先辨識目前的按鍵標籤,再使用結果檢視來確認其頻率與近期順序。

如何在瀏覽器中測試按下的是哪個按鍵

  1. 開始前,請選擇按住按鍵的重複事件處理原則。一般按壓測試時,請關閉 Count held-key repeat events;若想觀察重複的瀏覽器事件,則請啟用它。
  2. 請點選虛線擷取區域內部,使其取得焦點。計數器只附加於這個可見元素,因此在頁面其他位置按鍵不會被記錄。
  3. 請逐一按下無特殊用途的測試按鍵。字母、數字鍵、Space,以及 ArrowUp 等具名按鍵,都能辨識瀏覽器的標籤。除 Tab 以外的按鍵在取得焦點的區域內會阻止其一般預設行為,進而減少意外捲動或啟動按鈕的情形。
  4. 請檢視總數、近期十個標籤及依頻率排序的表格。若在初次測試後變更重複事件選項,請先再次點選擷取區域,再按下更多按鍵。
  5. 若要離開擷取區域,請隨時使用 Tab。若要在開始新的本機工作階段前清除總數、頻率對應表及近期記錄,請選取 Reset counter。

測試順序應保持中性且審慎。按下一個按鍵,在近期檢視中記下其標籤,然後檢查其頻率是否如預期增加。

解讀總數前先設定重複規則

按住按鍵時,瀏覽器通常會先送出初始 keydown 事件,接著在按鍵持續按住期間傳送標記為重複的事件。關閉重複計數時,標記為重複的事件會讓現有狀態維持不變,因此一般按住按鍵通常只會增加一次接受的計數,而不是每個重複的瀏覽器事件都計入一次。

設定 計入哪些事件 最適合的用途
關閉重複計數 接受初始 keydown 事件,並忽略瀏覽器標記為重複的事件 簡單的按壓與按住測試,其中一次按住應只計入一次
啟用重複計數 接受初始 keydown 事件,以及每個收到的重複標記事件 測量按住按鍵期間所傳送的重複事件

比較總數時,這項差異很重要。此工具信任瀏覽器的重複旗標;它不會測量實體去彈間隔,也不會獨立判定重複事件是來自按住按鍵、按鍵連點、自動化工具或無障礙軟體。因此,計數增加只能證明有更多重複事件抵達頁面,無法確立其實體原因。

透過三種結果檢視確認按鍵

總數、近期標籤與頻率表格分別回答不同的問題。確認按下的是哪個按鍵時,請搭配使用這三項資訊。

結果檢視 提供的資訊 無法代表的內容
總數 目前工作階段中接受的 keydown 事件數量 不重複按鍵或實體按住的數量
近期十個標籤 最近接受的標籤及其抵達順序 所有輸入內容的完整記錄
頻率表格 工作階段期間,每個正規化按鍵標籤出現的次數 實體鍵盤配置或硬體開關報告

頻率資料列會先依計數遞減排序;計數相同時,再依標籤排序。近期記錄只保留最近十個接受的標籤,而頻率對應表涵蓋目前的工作階段。因此,這些輸出可用於確認模式,無須儲存完整的測試重建內容。

選取 Reset counter 會清除總數、頻率對應表及近期記錄。這是無須重新整理頁面,即可開始另一個本機工作階段的手動方式。

瞭解按鍵標籤如何正規化

標籤來自瀏覽器的 KeyboardEvent.key 值,而不是掃描碼、實體配置或鍵帽圖片。此工具會先清理該值,再予以儲存:

  • 實際的空格會顯示為 Space。
  • 若語系轉換支援,單一可見字元會以大寫顯示。
  • ArrowUp 等具名值會保持易於閱讀的形式。
  • 控制字元、代理碼點及 Unicode 行分隔符或段落分隔符都會移除。
  • 清理後的標籤會去除前後空白;若結果為空,則會變成 Unknown。

儲存的標籤最多限四十個 Unicode 碼點。這些規則能讓顯示結果保持一致,但也表示標籤是瀏覽器層級的表示,而非通用的鍵盤對應表。輸入法、無障礙工具或行動裝置鍵盤,可能提供與實體開關無法一對一對應的標籤。

考量焦點與瀏覽器限制

擷取區域具有明確的焦點界限。其事件處理器只附加至這個可見元素,因此傳送至其他應用程式、瀏覽器對話方塊或頁面其他部分的按鍵輸入,都不在其範圍內。頁面無法回報另一個程式接收到的內容。

部分瀏覽器與作業系統的快速鍵,也可能在頁面收到 keydown 事件前就被攔截。軟體產生的事件、瀏覽器擴充功能、遠端桌面軟體、輸入法、無障礙工具及螢幕小鍵盤,都可能進一步影響最終收到的內容。檢查基本回應時,請使用未經修改、無特殊用途的測試按鍵,而不要使用保留為快速鍵的鍵盤組合。

基於相同原因,結果描述的是瀏覽器事件,而非硬體事實。它們不會顯示掃描碼、輪詢率、延遲、配置正確性或輸入欄位的內容。組合文字也可能對應多個實體動作。缺少記錄是檢查焦點與瀏覽器處理方式的理由,並非按鍵開關故障的證據。

讓測試保持中性且在本機進行

請使用無特殊用途的測試按鍵,並避免在擷取區域中輸入密碼、私人訊息、復原碼或其他敏感內容。計數器會在目前的瀏覽器分頁中執行;接受的標籤與計數不會上傳、儲存至帳戶、自動複製,也 不會在重新整理後保留。

若要快速檢查,請按下一個一般按鍵,在近期檢視中確認其正規化標籤,然後再次按下該鍵,確認對應頻率有所變化。只有需要比較近期順序時,才再加上另一個無特殊用途的按鍵。這套受控流程能回答核心問題——測試按下的是哪個按鍵——同時讓結果與實際接收到的瀏覽器事件保持關聯。