JavaScript キーコードエクスプローラー
ブラウザで任意のキーを押すと event.key、event.code、keyCode、charCode、location、repeat、修飾キー状態を即時表示。コピー可能な JS スニペット付き。ブラウザ内で処理、設定不要。
- ブラウザ内で処理
- ツールの入力を ZeroTool のサーバーにアップロードしません
- 無料 · 登録不要
WeChat でスキャンしてシェア
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。
event.key vs event.code vs keyCode
フロントエンドのキーボード関連のバグの多くは、この 3 つを混同することから起きます。対応表は次のとおりです。
| プロパティ | 配列依存 | 推奨 | QWERTY で A を押した時の値 |
|---|---|---|---|
| event.key | あり(現在の配列を反映) | 推奨——意味で判定 | "a" または Shift で "A" |
| event.code | なし(物理位置) | 推奨——ゲーム・ショートカット | "KeyA" |
| keyCode | なし | 非推奨 | 65 |
| which | なし | 非推奨 | 65 |
| charCode | なし | 非推奨——keydown では 0 | 0 |
JIS 配列のキーで試す
以下のコードブロックは、指定したキーをパッドで押したときにツールが表示する値です。「イベントプロパティ」の一部の行と、「コピー可能な JS スニペット」を載せています。
半角/全角キーの code は "Backquote"
UI Events KeyboardEvent code Values 仕様は、"Backquote" を US キーボードの `~ キーとし、日本語キーボードでは半角/全角/漢字キーがこれにあたると書いています。
event.code "Backquote"
つまり、code === 'Backquote' で判定するショートカット(US 配列の ` キーを想定したもの)は、JIS 配列では半角/全角キーに当たります。JIS 配列の利用者を想定するなら、入力される文字(event.key)で判定するか、別のキーを割り当ててください。
Mac の「かな」キーは "Lang1"
同じ仕様では、Mac の日本語キーボードの「かな」キーが "Lang1"、「英数」キーが "Lang2" です。韓国語キーボードの 한/영 キーと 한자 キーも同じ "Lang1"・"Lang2" なので、code だけでは日本語用か韓国語用かは区別できません。
event.code "Lang1"
Enter で送信するフォーム
Enter をパッドで押すと、次の値とスニペットになります。
event.key "Enter"
event.code "Enter"
keyCode 13
document.addEventListener('keydown', (e) => {
if (e.key === 'Enter') {
// your handler
}
});
変換中の Enter に注意する
Microsoft 日本語 IME のサポートページは、候補ウィンドウにフォーカスがある状態で Enter キーを押すと、フォーカスされている候補を選ぶと説明しています。つまり、その Enter は変換を確定するためのもので、フォームを送信するためのものではありません。上のスニペットは event.key と修飾キーしか見ないので、入力欄で使うなら次のように 1 行足してください。
input.addEventListener('keydown', (e) => {
if (e.isComposing || e.keyCode === 229) return;
if (e.key === 'Enter') {
// 送信
}
});
変換中は isComposing が true です。UI Events の非規範的な旧キーコードの節には、IME がキー入力を処理しているときの keydown では keyCode に 229 を返すとあります。キャプチャパッドはテキスト入力欄ではないので、ここで IME が変換を始めるかどうかは環境しだいです。この 1 行の効果は、自分の入力欄で IME をオンにして確かめてください。
よくある用途
- キーボードハンドラーのデバッグ——実際の event.key を if 条件に貼って、つづりの誤りを直す。
- ゲームの操作——event.code を使えば AZERTY でも WASD が同じ位置で使える。
- コマンドパレット——event.key と e.ctrlKey / e.metaKey を組み合わせる。
- 古いコードの確認——keyCode / which を読み、古いハンドラーを event.key に移す。
preventDefault の挙動
キャプチャパッドが preventDefault() を呼ぶのは Tab、Space、Backspace、矢印キー、F1-F12 だけです。どれもブラウザーが移動やページ操作に使うキーです。
Ctrl+W / Cmd+Q などのシステムショートカットは止めず、ブラウザーの既定動作のままです。
キーボード配列と IME
event.code は物理キーを US キーボード上の位置で名付けます。同じ仕様では、"KeyQ" は US キーボードで q、フランス語 AZERTY キーボードで a と刻印されたキーです。キーの位置に意味があるショートカット(WASD 移動)は code、入力される文字に意味があるショートカット(Ctrl+Z で元に戻す)は key で判定してください。
JIS 配列(106/109 キーボード)には US 配列にないキーがあり、"IntlYen"(¥)、"IntlRo"(ろ)、"NonConvert"(無変換)、"Convert"(変換)、"KanaMode"(カタカナ/ひらがな/ローマ字)です。パッドで押すと、ブラウザーが返す値を確認できます。
制限
- スマートフォンやタブレットのソフトウェアキーボードは、完全な keydown ではなく入力した文字を持つ
inputイベントを送るのが普通です。パッドの下の代替入力欄はその文字をkeyとして表示し、code・keyCode・which・charCodeは空欄にします。input イベントはどのキーを押したかを伝えないためです。IME で変換中は途中の input イベントを無視し、compositionendの時点で確定文字列を読み取ります。これは模擬した変換イベント(日本語・韓国語・中国語ピンイン)とデスクトップの Chromium の IME エミュレーションで確認したもので、Android の実機では試していません。 - Ctrl+W や Cmd+Q などはブラウザーと OS が処理するため、ページには届きません。
- キャプチャパッドはテキスト入力欄ではないので、IME がここで変換を始めるかどうかは環境によります。
keyCode229 が表示されないこともあります。 - スニペットは
event.keyと押されていた修飾キーだけで判定し、event.codeもisComposingも見ません。 - 捕捉するのは keydown だけで、keyup と keypress は表示しません。「最近のキー」は直近 8 回分です。
FAQ
event.key、event.code、keyCode の違いは?
event.key はキーボード配列と Shift を反映したあとの文字、またはキーの名前です。event.code は US キーボード上の位置で物理キーを名付けたもの(KeyA、Digit1、ArrowUp)で、配列を変えても変わりません。たとえばフランス語 AZERTY キーボードで a と刻印されたキーは、key が "a"、code が "KeyQ" です。keyCode は古い数値コード(A は 65)で、互換性のためにブラウザーが今も送っています。
なぜ keyCode・which・charCode は非推奨なのか?
UI Events 仕様はこれらを古い(obsolete)属性とし、値を定義せず、charCode と keyCode の代わりに key 属性を使うよう勧めています。値はブラウザー、OS、キーボード配列によって異なります。MDN も非推奨としています。ブラウザーは互換性のために今も出力しており、本ツールは生の値を表示するので古いハンドラーの確認に使えます。
Shift / Ctrl / Alt / Meta 修飾キーをどう判定する?
KeyboardEvent の e.shiftKey、e.ctrlKey、e.altKey、e.metaKey を読みます。どれも真偽値です。e.metaKey は Windows では Windows キー、Mac では Command キーです。生成されるスニペットは、押されていた修飾キーごとに条件を加えます。Shift を押したまま英字キーを押すと event.key は大文字になるので、Ctrl+Shift+K は "k" ではなく "K" です。
keyCode が 229 になるのはなぜ?isComposing とは?
IME で変換中(未確定の文字があるあいだ)は isComposing が true になります。UI Events の非規範的な旧キーコードの節には、IME がキー入力を処理しているときの keydown では keyCode に 229 を返すと書かれています。Enter を処理するコードはこのとき先に return しないと、変換を確定する Enter でフォームまで送信されます。キャプチャパッドはフォーカスできる領域で、テキスト入力欄ではないため、ここで IME が変換を始めるかどうかは環境によります。変換中の動きは自分の入力欄で確かめてください。タッチ端末用の代替入力欄は compositionend を待ってから確定文字列を読み取ります(模擬した変換イベントとデスクトップの Chromium の IME エミュレーションで確認、Android 実機では未確認)。
モバイルで動作する?
一部だけです。多くのソフトウェアキーボードは 1 文字ごとの keydown を送らず、入力した文字を持つ input イベントだけを送ります。タッチ端末ではパッドの下に代替入力欄が出て、入力した文字を key として表示し、code・keyCode・which・charCode は空欄にします。IME で変換中(かな漢字変換、ハングルの組み立て、ピンインなど)は入力欄の文字に手を付けず、確定したとき「東京」のような確定文字列を表示します。英語も単語ごとに変換するソフトウェアキーボードでは、確定後に hello のような単語がまとめて表示されます。この動きは模擬した変換イベントとデスクトップの Chromium の IME エミュレーションで確認したもので、Android の実機では試していません。keydown の詳細を見るには、物理キーボードをつないだデスクトップのブラウザーを使ってください。
キー入力データはサーバーに送信される?
キーの値は送信しません。イベントはブラウザー内で読み取り、何も保存しません。ページは Google Analytics を読み込み、ツール名と操作だけを記録します。ページの読み込み後または「クリア」後の最初のキーで keydown を 1 回、コピーに成功したときに copy_snippet、ページの読み込み後または「クリア」後にタッチ端末の代替入力欄へ最初に入力したとき mobile_input を 1 回です。どのキーを押したかは記録しません。