keyCode 229と「Unidentified」のキー

keyCode 229は、画面のキーボードかIMEがキーを受け取ったという意味です。代わりにinputイベントからテキストを読み取ってください。

ここで押してみる

スマホのキーボードかIMEで、入力欄に入力してください

キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。

どの値を使うか

keyCodeが229のときは、そのキーに反応しないでください。229はキーではありません。ブラウザが、画面のキーボードかIME(日本語入力などの入力システム)を通してキー入力を受け取ったという意味です。画面のキーボードやIMEは入力する文字を自分で決め、どのキーだったかを伝えません(パソコンのIMEでは、codeが物理的なキーを表すこともありますが、テキストはまだ決まっていません)。届く値は、ユーザーの入力方法によって変わります。

入力方法 keydownで届く値
Androidのキーボード keyは「Unidentified」、codeは”“、keyCodeは229、isComposingはtrueのことが多い
日本語・中国語・韓国語の入力(IME) keyは「Process」か本当のキー、codeは本当のキー、keyCodeは229、isComposingはtrue
iPhoneやiPadのキーボード keyは本当のキー、codeは”“のことが多い、keyCodeは本当の数値、isComposingはfalse
物理キーボード(IMEなし) key、code、keyCodeはすべて本当の値、isComposingはfalse

よくあるつまずき

日本語・中国語・韓国語の入力中にショートカットが動いてしまう

文字を組み立てるためのキーも、keydownイベントを送ります。ショートカットの処理ではこれらを飛ばし、確定したテキストはinputイベントかcompositionendイベントから読み取ってください。

input.addEventListener('keydown', (event) => {
  if (event.isComposing || event.keyCode === 229) return;
  // ここにショートカットの処理
});

input.addEventListener('beforeinput', (event) => {
  // event.inputType: 'insertText', 'deleteContentBackward', 'insertLineBreak', ...
  // event.data: 追加されるテキスト、または null
  // 止めるのは入力された数字以外の文字だけ。貼り付け、ドロップ、変換は別の経路で入るので、
  // input や change でも入力欄の値を確かめる。
  if (event.inputType === 'insertText' && /\D/.test(event.data ?? '')) {
    event.preventDefault();
  }
});

両方の値を確かめてください。Safariは、文字を確定するEnterを、isComposingがfalseでkeyCodeが229の状態で送ります。

Androidスマホでは、どのキーも「Unidentified」になる

GboardやSwiftKeyなどのAndroidのキーボードは、ほとんどのキーをkeyCode 229、event.key「Unidentified」として送ります。BackspaceやEnterだけ本当のキーを送るものもありますが、キーボードやバージョンによって違い、keydownがまったく来ないタップもあります。ここではキーを読み取らず、beforeinputかinputのinputTypeとdataを読み取ってください。削除のときは、inputTypeが「deleteContentBackward」、dataがnullになります。

keydownでpreventDefault()を呼んでもテキストが止まらない

テキストはkeydownから入力されるわけではないので、keydownを取り消しても何も変わりません。上の例のように、代わりにbeforeinputイベントを取り消してください。例外が1つあります。キーボードが単語を変換している間(inputTypeが「insertCompositionText」)は、ChromeとFirefoxでは取り消せません。inputイベントかcompositionendの時点で、入力欄の値を直してください。

iPhoneでevent.codeが空になる

iPhoneやiPadは、たいてい本当のevent.keyとkeyCodeを送りますが、event.codeは”“のことがよくあります。画面のキーボードのキーはevent.keyで判定してください。

USBキーボードでは動くのに、画面のキーボードでは動かない

スマホにつないだ物理キーボードは、IMEがオンでなければ本当のキーを送ります。そのため、物理キーボードでテストすると問題が隠れてしまいます。画面のキーボードでテストするか、上の「ここで押してみる」で確かめてください。