---
title: "keyCode 229, event.key \"Unidentified\": 안드로이드·IME 키 | DeviceTests"
description: "안드로이드 키보드와 입력기는 실제 키 대신 keyCode 229와 event.key \"Unidentified\" 또는 \"Process\"를 보내요. 내 기기에서 확인하고, 키 대신 입력된 텍스트를 읽는 방법을 알아보세요."
url: https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/229
language: ko
---

# keyCode 229와 "Unidentified" 키

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

## 어떤 값을 쓸까요

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 키보드에서는 되는데 화면 키보드에서는 안 돼요

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

## 관련 키

- [Enter 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/enter)
- [Backspace 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/backspace)
- [글자 키 코드 (A–Z)](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/letter-keys)
- [Space 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/space)
- [키코드 확인: 아무 키나 눌러 코드 보기](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8)
- [모든 키 코드 표](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8#key-codes)
