鍵盤測試功能與運作原理
「鍵盤測試」是一個免費的線上工具，讓使用者能夠即時測試鍵盤的實體功能，並檢查每個按鍵按下時所產生的底層技術事件代碼。
使用者只需在頁面的任何地方按下按鍵，工具便會立即偵測按鍵是否有反應，並在畫面上呈現已測試按鍵的視覺佈局圖、追蹤目前按下的按鍵，以及記錄詳細的事件歷史。這項功能有助於使用者分辨正常的硬件行為（例如系統的自動重複輸入）與實際的硬件故障（例如按鍵無反應或按鍵連點/雙擊）。
輸入方式與偵測模式
本工具支援多種輸入與偵測方式，以適應不同的測試需求：
- 實體按鍵輸入：在頁面任何地方按下鍵盤按鍵，系統會自動偵測並擷取輸入。
- 完整偵測模式：直接點擊畫面上的鍵盤圖示，即可進入完整偵測狀態。在此模式下，按下 Space、Tab 以及各個功能鍵（F1–F12）時，瀏覽器會攔截並阻止其預設的網頁行為（例如頁面滾動或切換焦點），確保這些按鍵能被正確記錄。按下 Esc 鍵即可退出此模式。
- 螢幕鍵盤輸入：針對流動裝置或虛擬鍵盤，使用者可以利用專門的「螢幕鍵盤測試」輸入欄位進行測試。
- 清除記錄指令：手動點擊「清除記錄」按鈕，即可隨時清空已累積的事件歷史。
輸出資訊與即時數據
當按鍵觸發時，工具會即時輸出並更新以下資訊：
最新按鍵事件
此區域會顯示最近一次按鍵動作的詳細屬性：
- 按鍵 (Key)
- 代碼 (Code)
- 舊版 keyCode
- 位置：顯示「標準」、「左」、「右」或「數字鍵盤」
- 修飾鍵：顯示「無」，或當前啟用的修飾鍵（包括「Shift」、「Ctrl」、「Alt」、「Meta」、「Caps Lock」）
- 狀態標籤與重複計數：顯示「按下」或「放開」標籤。若長按按鍵，則會顯示「重複 ×
{count}」徽章，記錄系統自動重複觸發的次數。
鍵盤佈局圖
視覺化的 ANSI 鍵盤佈局圖會根據按鍵狀態即時改變顏色：
- 正按下：顯示目前正被按住的按鍵。
- 已測試：標示自頁面載入或清除記錄後，曾經被按下並成功觸發過的按鍵。
統計數據
即時統計並顯示以下數值：
- 已測試按鍵數量
- 總按下次數
- 目前按下的按鍵數
事件記錄表
以表格形式呈現的歷史紀錄，標題為「事件記錄」（若無任何數據則顯示「目前沒有按鍵事件 — 請按下任意按鍵。」）。表格包含以下欄位：
- 時間
- 事件（顯示「按下」或「放開」）
- 按鍵
- 代碼
- 修飾鍵
備註：長按按鍵所產生的自動重複事件只會累加於最新事件的「重複」徽章中，不會重複寫入事件記錄表中。
偵測狀態指示
顯示目前的偵測狀態，包括「請按下任意按鍵開始測試」、「正在偵測按鍵輸入」或「完整偵測中 — 按 Esc 釋放鍵盤」。
螢幕鍵盤測試區
專為流動裝置設計的測試區域，包含：
- 一個顯示「點擊並輸入…」的文字輸入欄位。
- 提示文字：「點擊此欄位並輸入文字 — 瀏覽器回傳的任何資訊都會顯示在上方。」
技術規則與特殊邊界情況
在測試鍵盤時，需注意以下瀏覽器與作業系統的底層運作規則：
| 狀況類型 | 運作機制與表現 |
|---|---|
| 系統與瀏覽器快捷鍵 | 諸如切換分頁、關閉視窗、全螢幕切換或系統搜尋等組合鍵，在傳遞至網頁前就會被作業系統或瀏覽器攔截，因此無法在工具中登記。測試這些按鍵時，必須單獨按下以確認其硬件功能。 |
| Key 與 Code 的差異 | 「按鍵 (Key)」值是動態的，會隨目前的輸入法、語言佈局及修飾鍵（如 Shift）而改變（例如同一個實體鍵可輸出 "a" 或 "A"）。而「代碼 (Code)」值則代表該按鍵在鍵盤上的實體物理位置（例如 "KeyA"、"ShiftLeft"、"Space"），不論語言設定如何改變，此值皆保持不變。 |
| 自動重複行為 | 長按某個按鍵時，作業系統會持續發送按下事件，工具會透過「重複」徽章與計數器來呈現此狀態，而非在事件記錄中新增大量重複資料。 |
| 流動裝置虛擬鍵盤 | 流動裝置（特別是 Android 系統）的虛擬鍵盤在輸入時，經常傳送不帶有具體按鍵值的通用事件，導致系統顯示 “Unidentified”。使用者必須使用專用的「螢幕鍵盤測試」輸入框，才能擷取流動瀏覽器實際回傳的資訊。 |
| 佈局圖限制 | 頁面上的視覺化地圖採用標準 ANSI 佈局。若使用 ISO 佈局專用鍵、手提電腦的 Fn 組合鍵或多媒體鍵，地圖上雖不會亮起，但「最新按鍵事件」與「事件記錄」仍能正常接收並顯示其技術數據。 |
| 數據保存 | 所有擷取的按鍵數據均不具備持久性。一旦點擊「清除記錄」按鈕，或重新整理、關閉網頁，所有暫存的事件記錄將會被永久抹除。 |
隱私與資料處理說明
本工具高度重視使用者隱私。所有按鍵輸入僅由本網頁在您的瀏覽器內進行本地讀取與處理，用以即時顯示事件詳情與更新頁面記錄。我們絕不儲存或上傳任何資料至外部伺服器。當您清除記錄或離開頁面時，所有活動數據即會被徹底抹除。
常見問題
key 與 code 值有什麼分別？
key 值是按鍵目前產生的字元或動作 — 它會隨你的鍵盤佈局和修飾鍵而改變，因此同一個實體按鍵可能會回傳 “a” 或 “A”，在其他語言佈局上更會是完全不同的字母。而 code 值則代表實體按鍵的位置（例如 KeyA、ShiftLeft、Space）且永遠不變，這就是為什麼遊戲和應用程式都會將快捷鍵綁定到 code 值。
為什麼我的手機鍵盤會顯示 “Unidentified”？
螢幕鍵盤（特別是 Android 系統）經常會傳送不帶有真實 key 值的通用事件，而頁面只能顯示瀏覽器回傳的資訊。你可以開啟鍵盤佈局下方的螢幕鍵盤測試，查看你的鍵盤實際傳送了什麼；外接鍵盤或手提電腦鍵盤則能報告完整的詳細資訊。
長按按鍵時它會不斷觸發，這代表按鍵壞了嗎？
不是。長按按鍵會令系統傳送重複的按下事件，在此處會以 Repeat 徽章和計數器顯示 — 這是正常的自動重複功能。真正的故障跡象剛好相反：單次快速輕按卻產生多個事件，或者輕按後完全沒有反應，這代表按鍵開關已磨損或卡住。
為什麼有些組合鍵沒有顯示出來？
瀏覽器或作業系統保留的快捷鍵（例如關閉或切換分頁與應用程式、全螢幕、系統搜尋）會在頁面接收到之前被攔截，因此絕不會在此處顯示。這種沒有反應是正常的，並非按鍵損壞：你可以逐個測試這些按鍵，它們各自都能單獨登錄。