keyCode 229와 "Unidentified" 키

keyCode 229는 화면 키보드나 입력기가 키를 가져갔다는 뜻이에요. 키 대신 input 이벤트에서 텍스트를 읽으세요.

여기서 눌러 보기

휴대폰 키보드나 입력기로 텍스트 상자에 입력하세요

키보드만 쓰나요? Esc를 누른 뒤 Tab을 눌러 키 상자에서 나오세요.

어떤 값을 쓸까요

keyCode가 229이면 그 키 값만 보고 단축키 같은 동작을 실행하지 마세요. 229는 키가 아니에요. 브라우저가 화면 키보드나 입력기(IME)를 거쳐 키 입력을 받았다는 뜻이에요. 이때는 입력기가 텍스트를 직접 정하기 때문에 어떤 키였는지 알려 주지 않아요. 컴퓨터에서 입력기를 쓰면 code가 물리 키 이름을 알려 줄 수도 있지만, 텍스트는 아직 정해지지 않은 상태예요. 어떤 값이 오는지는 입력 방식에 따라 달라요.

입력 방식 keydown에서 받는 값
안드로이드 키보드 key “Unidentified”, code “”, keyCode 229, isComposing은 흔히 true
한국어·중국어·일본어 입력(IME) key “Process” 또는 실제 키, code 실제 키, keyCode 229, isComposing true
아이폰·아이패드 키보드 key 실제 키, code는 빈 문자열(“”)인 경우가 많음, keyCode 실제 번호, isComposing false
입력기를 쓰지 않는 물리 키보드 key, code, keyCode 모두 실제 값, isComposing false

한국어 키보드에서는 한/영 키(Lang1)로 한글 입력으로 전환할 수 있어요. 입력기가 한글을 조합하는 동안에는 글자 키의 keydown에서 keyCode 229가 올 수 있어요. 한자 키는 Lang2예요.

자주 막히는 부분

한국어·중국어·일본어를 입력하는 동안 단축키가 실행돼요

글자를 만드는 키도 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로 보내요.

안드로이드 휴대폰에서는 모든 키가 “Unidentified”예요

Gboard, SwiftKey 같은 안드로이드 키보드는 대부분의 키를 keyCode 229, event.key “Unidentified”로 보내요. 실제 Backspace나 Enter를 보내는 키보드도 있지만, 키보드와 버전마다 달라요. 화면 키보드의 키를 눌러도 keydown이 아예 오지 않을 때가 있어요. 이럴 때는 키를 읽지 말고 beforeinput이나 input에서 inputType과 data를 읽으세요. Backspace로 커서 바로 앞의 글자를 지울 때 inputType은 “deleteContentBackward”, data는 null이에요.

keydown에서 preventDefault()를 해도 텍스트가 막히지 않아요

텍스트는 keydown에서 만들어지지 않기 때문에 keydown을 취소해도 달라지는 게 없어요. 예시처럼 beforeinput 이벤트를 취소하세요. 한 가지 예외가 있어요. 키보드가 단어를 조합하는 중(inputType “insertCompositionText”)에는 Chrome과 Firefox에서 취소할 수 없어요. 이때는 input 이벤트나 compositionend에서 입력란의 값을 고치세요.

아이폰에서는 event.code가 비어 있어요

아이폰과 아이패드는 보통 실제 event.key와 keyCode를 보내지만, event.code는 빈 문자열("")일 때가 많아요. 화면 키보드의 키는 event.key로 구분하세요.

USB 키보드에서는 되는데 화면 키보드에서는 안 돼요

입력기가 꺼져 있으면 휴대폰에 연결한 외장 키보드는 각 키의 값을 그대로 보내요. 그래서 외장 키보드로만 테스트하면 문제가 가려져요. 화면 키보드로 테스트하거나 위의 확인 도구를 쓰세요.