キーボードテスター

ブラウザのキーボードテストでわかること

最新のデスクトップブラウザのキーボードイベントは、役立つ値を 2 つ返します。event.code は KeyQ、Space、NumpadEnter、ShiftLeft のように物理的なキーの位置を示します。event.key は現在有効なキーボードレイアウトが生成した値なので、同じ物理キーでも QWERTY、JIS、AZERTY、QWERTZ、Dvorak、その他の入力方式によって異なる文字が報告されます。

この違いはトラブルシューティングの要です。KeyQ が点灯しているのにキー値が q でない場合、物理キー自体は正しく届いており、違いの原因は有効なレイアウトや入力方式にあります。ページに届くはずのキーでイベントがまったく表示されない場合は、ハードウェア、ファームウェア、OS のドライバー、ブラウザ、あるいはページより先にショートカットとして奪われている可能性があります。

JIS 配列と日本語入力 (IME) の注意点

画面上のキーグリッドは物理的な位置にラテン文字のラベルを付けています。event.code が文字ではなく位置を表すためです。JIS 配列固有のキーも、コード自体はブラウザが報告します。無変換は NonConvert、変換は Convert、かなは KanaMode、右 Shift の左にある「ろ」キーは IntlRo、Backspace の隣の「¥」キーは IntlYen です。これらは ANSI 前提のグリッドには枠が用意されていませんが、イベントログには記録されるので、押したときにログへ流れるかどうかで動作を確認できます。

日本語入力 (IME) が変換中のときは、ブラウザがキー値を Process と報告したり、旧来の keyCode 229 を返したりします。これは故障ではなく IME の正常な挙動です。物理コードは IME の影響を受けないため、日本語入力のままでもハードウェアの点検は可能ですが、各キーの文字を確認したい場合は半角/全角キーで英数入力に切り替えてからテストすると結果が読みやすくなります。

ロールオーバー、ゴースティング、限界

ロールオーバーとは、キーボードが同時に報告できる押下数のことです。一般的なオフィス向けキーボードは 2 キーから 3 キー程度の組み合わせに対応し、ゲーミングキーボードは 6 キーロールオーバーや N キーロールオーバーをうたいます。このテスターはブラウザに実際に届いたイベントしか表示できず、キーボード、OS、ブラウザが送らなかったキーを証明することはできません。ロールオーバー最大値は Web ページ上での実用的な確認であり、ラボの認証書ではないと考えてください。

よくある落とし穴

• タブのフォーカスを保ってください。タブを切り替えたりアドレスバーを開いたりすると keyup イベントが途切れることがあるため、ページがフォーカスを失うと押下中のキーは解除されます。
• Alt+Tab、Cmd+Tab、Cmd+W、Cmd+L、F5 など、ブラウザや OS が先に予約しているショートカットがあります。
• モバイルキーボード、スクリーンキーボード、IME の変換処理、デッドキー、アクセシビリティ支援ツールは、報告されるキー値を変えたり遅らせたりします。
• 特定の 1 キーだけ反応しない場合は、スイッチの故障と決めつける前に別のブラウザと別の USB ポートで試してください。