# Keyboard Tester

> キーボードをブラウザでテスト：押したキーが点灯して記録され、key/code/eventの詳細を表示、Nキーロールオーバー測定、チャタリング自動検出。

- URL: https://bytescope.dev/ja/keyboard-test/
- Locale: ja · Also: [en](https://bytescope.dev/en/keyboard-test.md) · [zh-Hant](https://bytescope.dev/zh-Hant/keyboard-test.md)
- Runs: すべてブラウザの中で動くので、何もアップロードされません。
- Requires: Any modern browser (Chrome, Edge, Firefox, Safari), desktop and mobile.
- Updated: 2026-09-08

## What it does

いずれかのキーを押すとビジュアルキーボード（ANSI、ISO、JISレイアウト。60%、TKL、フルサイズ）上で点灯し、その後は影付きのまま残るので、ボード全体を1キーずつたどれます — 新しいキーボードのチェックや中古品の検証にまさに適したワークフローです。押すたびに、完全なイベント詳細 — `event.key`、`event.code`、レガシーのkeyCode、location、repeat — がコピー可能な等幅ログに記録され、Ctrl/Shift/Alt/Metaのライブ修飾キーバーとCapsLock/NumLockのロック状態も表示されます。

ほとんどのテスターを超える2つのチェックがあります。ロールオーバー：できるだけ多くのキーを押し続けると、ツールは同時に登録された数（お使いのキーボードの実際のNキーロールオーバー、現在値とセッション最大値）を報告します。チャタリング：1回の物理的な押下が2回として登録されるとき — 摩耗したメカニカルスイッチの典型的な故障 — ツールはリリースから押下までの間隔が30 ms未満のキーにフラグを付け、マゼンタで示し、発生回数をカウントするので、断続的に二重入力するスイッチが証拠とともに現れます。

ページはブラウザに見えないものについて正直です：OS予約のショートカット（Cmd+Tab、一部のWinキーの組み合わせ）とFnレイヤーのキーはページに届かず、失敗としてではなくそのようなものとして一覧されます。フルスクリーンモードはOSが本来飲み込むいくつかの組み合わせを取り戻し、ページをスクロールしたり移動させたりするキーはテスト中インターセプトされます。

タイピング速度・リズム分析モードでは、短いサンプル文を1つ入力すると、WPMに加えて、キーストローク間の間隔の平均・中央値・標準偏差、そしてそのリズムの小さなヒストグラムが表示されます — WPMという数字だけよりも、あるスイッチやキーキャッププロファイルが実際どう感じるかがよくわかります。Chrome/Edgeが対応している場合は、トグルでKeyboard Layout APIを読み込み、各物理キーがお使いのOSレイアウト上で実際に生成する文字をビジュアルキーボードに直接オーバーレイ表示します — USレイアウトから外れた環境では、デフォルトのQWERTY図が誤解を招くため本当に役立ちます。非対応ブラウザには、壊れたボタンを見せる代わりに正直に「利用不可」と表示されます。そして、フル・ストレステストレポートは、テストセッション全体を1つのコピー可能な要約にまとめます：選択中のレイアウトの全キーに対する完了率、まだ押していないキーの正確な一覧、検出されたすべてのチャタリングイベント、そして到達した最大同時押しキー数 — フリマ出品や保証申請にそのまま貼り付けられる文章です。

## Limits

Does not remap keys or test keyboards the operating system has not recognised; it shows what key events the browser receives.

## Machine output

Copy JSON copies an envelope `{ tool, url, generatedAt, userAgentHint, result }`. `tool` is `"keyboard-test"`; `result` is a de-duplicated, sorted set of `code` values. `key` values, composed strings, press-order lists, timestamp sequences, and per-code counts are omitted.

- `layoutVariant` (string | null) — `"ansi"` | `"iso"` | `"jis"`. `null` = layout variant not set.
- `layoutSize` (string | null) — `"60"` | `"tkl"` | `"full"`. `null` = layout size not set.
- `detectedCodes` (string[]) — Detected `code` values, de-duplicated and sorted lexicographically.
- `notPressedCodes` (string[]) — Layout codes that never produced a keydown, sorted. This is "not pressed yet", not "broken".
- `unresponsiveCodes` (string[] | null) — Codes judged unresponsive (pressed, no event). `null` = not judged (this page has no dead-key confirmation). Never filled from `notPressedCodes`.
- `chatterCodes` (string[]) — Codes that tripped chatter detection, sorted. Counts are omitted.
- `sessionMaxHeld` (number) — Peak concurrent held keys. `0` = none held this session.
- `lastEventAtMs` (number | null) — Timestamp of the most recent captured event. `null` = no event this session.

## FAQ

### キーが点灯しません — 壊れているのですか？

まず、それがテスト不可リスト（OS予約の組み合わせ、Fnレイヤー、一部のメディアキー）に載っているか確認してください — ブラウザはそれらを決して受け取らず、ページはそれらを明示的に一覧します。通常の文字/数字キーがイベントログにも何も表示せず、同じキーが別のアプリでも失敗するなら、スイッチかメンブレンが本当に死んでいます。

### キーのチャタリングとは何で、検出器はどう動作しますか？

チャタリングとは、1回の物理的なキー押下が複数回の押下として登録されること — 摩耗したり汚れたりしたメカニカルスイッチが電気的にバウンスすることです。検出器は、keyup→keydownの間隔が30 ms未満、人間のダブルタップよりはるかに速いキーにフラグを付けます。通常のタイピング中にキーがチャタリングイベントを蓄積するなら、そのスイッチはクリーニングか交換が必要です。

### 同時に何個のキーが登録されるべきですか？

オフィス向けキーボードは一般に6キーロールオーバー（6KRO）に修飾キーを加えたものに対応し、ゲーミングキーボードはNKRO — すべてのキーを同時に — を謳います。ボード全体でできるだけ多くのキーを押し続けてください：同時押しの最大数が実際のロールオーバーで、6で頭打ちなら6KROのハードウェア（または一部のボードが切り替えられるUSBモードの制限）です。

### Cmd+Tab / Win+L / Fnキーが表示されないのはなぜですか？

オペレーティングシステムが、ブラウザに何らかのイベントが見える前にそれらのショートカットを消費します — これはセキュリティ/UXの境界であり、キーボードの故障ではありません。フルスクリーンモードはいくつかの組み合わせを取り戻し、Fnレイヤーの挙動はキーボード自身のコントローラー内に完全に存在し、いかなるソフトウェアテストからも見えません。

### タイピング速度モードは実際に何を測定していますか？

標準的なgross WPM — （入力文字数 ÷ 5）を経過分数で割ったもの — に加えて、その数字の裏にあるリズムです：連続するキーストローク間の間隔の平均・中央値・標準偏差、そしてその分布の小さなヒストグラム。自らの限界についても正直です：タイミングはブラウザタブに届いた時点で測定されるため、あなたの指の動きだけでなくOS/ブラウザの入力遅延のジッターも含まれ、キーを押しっぱなしにしたオートリピートは新しいキーストロークとしてカウントされません。

### 自分のキーボードの実際のレイアウトをわざわざ表示するのはなぜですか — 図はもう正しいのでは？

ビジュアルキーボードは物理的な参照図（US ANSI/ISO/JIS）として描かれていますが、各キーが実際に何を入力するかはOSのキーボードレイアウト設定次第です — AZERTY、Dvorak、非ラテン文字のレイアウトでは、印字された図とは大きく異なることがあります。「自分のレイアウトを表示」トグルはKeyboard Layout APIを呼び出し、キーごとの実際の文字をオーバーレイ表示します。これはChromium系（Chrome/Edge）限定の機能で、他のブラウザにはサイレントに間違ったオーバーレイを見せる代わりに、正直に「利用不可」というラベルが表示されます。

### フル・ストレステストレポートには何が含まれますか？

1つのコピー可能なプレーンテキスト要約です：現在のレイアウトのうち何個のキーを押したか、その割合、まだテストしていないキーの正確なコード、検出されたすべてのチャタリングイベント（どのキーが何回か）、そして同時に押していた最大キー数（実測ロールオーバー）。フリマ出品や保証申請、特定の個体についてのフォーラム投稿に貼り付けられるように作られています。
