鍵盤事件屬性與網頁開發
在現代網頁開發中，準確捕捉使用者的鍵盤輸入至關重要。本工具提供即時的技術參數檢測，幫助開發者深入理解瀏覽器如何處理鍵盤事件。當您在頁面上按下任意按鍵時，系統會即時解析並顯示以下關鍵屬性：
- 按鍵 (Key)：對應
KeyboardEvent.key，表示該按鍵目前產生的字元值或動作名稱。 - 代碼 (Code)：對應
KeyboardEvent.code，代表該按鍵在鍵盤上的實體物理位置。 - 舊版 keyCode (Legacy keyCode)：顯示傳統瀏覽器所使用的數值代碼，供相容性測試參考。
- 位置 (Location)：顯示按鍵在鍵盤上的具體區域，包含「標準」(Standard)、「左側」(Left)、「右側」(Right) 或「數字鍵區」(Numpad)。
- 修飾鍵 (Modifiers)：偵測當前是否同時啟用了「Shift」、「Ctrl」、「Alt」、「Meta」或「Caps Lock」等修飾鍵。
透過這些詳細的數據回報，開發者可以輕鬆驗證不同瀏覽器與作業系統環境下，鍵盤事件 API 的實際行為與相容性。
實體配置與軟體對應的差異
鍵盤輸入的複雜之處，在於作業系統的語言輸入法設定（軟體對應）與鍵盤本身的物理按鍵（實體配置）之間存在脫鉤關係。
「按鍵」值是動態的，會隨著您當前啟用的輸入法、語言配置以及是否按下修飾鍵而改變。例如，按下同一個實體按鍵，在英文輸入法下可能輸出 "a" 或 "A"，在其他語言配置下則會回報完全不同的字元。
相反地，「代碼」值代表的是該按鍵在鍵盤上的實體物理位置，例如 "KeyA"、"ShiftLeft" 或 "Space"。無論您切換到哪種語言或輸入法，這個代碼值都永遠保持不變。這也是為什麼網頁遊戲與專業應用程式在設定快捷鍵時，通常會優先綁定到代碼值，以確保使用者在不同語言配置下仍能擁有一致的操作體驗。
診斷鍵盤硬體故障
本工具是檢測鍵盤硬體健康狀況的實用工具，能協助使用者快速找出以下常見的機械或薄膜按鍵故障：
- 按鍵無反應 (Dead Keys)：按下特定按鍵時，若畫面的鍵盤圖示未亮起，且「最新按鍵事件」與「事件記錄」皆無任何新增數據，即代表該按鍵可能已損壞或接觸不良。
- 按鍵連點 (Key Chattering)：正常的長按會觸發系統的自動重複機制，此時工具會顯示「重複 ×
{count}」徽章。然而，若您只是輕敲按鍵一次，事件記錄卻瞬間產生多個「按下」與「放開」事件，這通常意味著按鍵開關已磨損，產生了物理性的連點故障。 - 按鍵衝突 (Ghosting)：當您同時按下多個按鍵時，可以透過「目前按住」統計與鍵盤圖示，確認所有按鍵是否皆能同時被系統正確識別，藉此測試鍵盤的防衝突能力。
瀏覽器事件攔截機制
在測試鍵盤時，部分按鍵組合可能無法在工具中顯示。這是因為瀏覽器或作業系統本身保留了特定的系統快捷鍵（例如切換分頁、關閉視窗、全螢幕模式或系統搜尋）。
這些快捷鍵在傳遞到網頁應用程式之前，就已經被作業系統或瀏覽器底層攔截並執行對應動作。因此，這類組合鍵無法被本工具捕捉。若要驗證這些按鍵的硬體功能是否正常，建議您單獨按下該按鍵（例如單獨按下 F11 或 Alt 鍵），只要單一按鍵能正常觸發事件，即代表硬體功能完好。
行動裝置與虛擬鍵盤的限制
在智慧型手機或平板電腦等行動裝置上，虛擬螢幕鍵盤的運作機制與實體鍵盤有很大的不同。
特別是在 Android 系統上，虛擬鍵盤為了優化文字輸入與自動修正，經常會傳送不帶有具體按鍵值的通用事件，導致工具的即時資訊顯示為 "Unidentified"。為了應對此限制，本工具設計了專門的「螢幕虛擬鍵盤測試」區域。使用者可以點擊該輸入欄位並開始輸入文字，藉此觀察行動瀏覽器實際回報的輸入事件與字元內容。
本地端安全處理宣告
本工具極度重視您的隱私。所有按鍵輸入與產生的事件數據，完全是在您的本機瀏覽器中進行即時處理與顯示。本工具不會將任何輸入內容儲存或上傳至外部伺服器。一旦您點擊「清除記錄」按鈕，或是關閉、重新整理網頁，所有暫存的事件記錄與測試數據都將被永久抹除，不留任何痕跡。
常見問題
key 與 code 值有什麼不同？
key 值是該按鍵目前產生的字元或動作 —— 它會隨著您的鍵盤配置與修飾鍵而改變，因此同一個實體按鍵可能會回報 "a" 或 "A"，在其他語言配置下甚至會回報完全不同的字母。code 值則是命名該按鍵的實體位置（例如 KeyA、ShiftLeft、Space）且永遠不會改變，這也是為什麼遊戲與應用程式通常會將快捷鍵綁定到 code 值上。
為什麼有些組合鍵沒有顯示出來？
瀏覽器或作業系統保留的快捷鍵（例如關閉或切換分頁與應用程式、全螢幕、系統搜尋）在頁面接收到之前就會被攔截，因此永遠不會出現在這裡。這種無反應是正常的，並非按鍵損壞：請逐一測試這些按鍵，它們各自單獨按下時都能正常偵測。
按住按鍵時它會一直連續觸發，這是故障嗎？
不會。長按按鍵會使系統傳送重複的按下事件，在此處會以 Repeat 徽章與計數器顯示 —— 這是正常的自動重複。真正的異常警訊是相反的情況：單次快速輕敲卻產生多個事件，或是輕敲卻完全沒有反應，這通常代表按鍵開關已磨損或卡住。
為什麼我的手機鍵盤會顯示 "Unidentified"？
螢幕虛擬鍵盤（特別是在 Android 上）經常會傳送不帶有實際 key 值的通用事件，而本頁面只能顯示瀏覽器所回報的內容。您可以開啟鍵盤配置下方的螢幕鍵盤測試，查看您的鍵盤實際傳送了什麼；外接鍵盤或筆電鍵盤則能回報完整的詳細資訊。