JavaScript 키 코드 탐색기
브라우저에서 아무 키나 누르면 event.key, event.code, keyCode, charCode, location, repeat, 수정자 키 상태를 즉시 표시. 복사 가능한 JS 스니펫 제공. 브라우저에서 처리, 설정 불필요.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
event.key vs event.code vs keyCode
프런트엔드 키보드 버그의 대부분은 이 세 가지 속성을 섞어 쓰는 데서 생깁니다. 참조표:
| 속성 | 레이아웃 영향 | 권장 여부 | QWERTY에서 A 누를 때 값 |
|---|---|---|---|
| event.key | 있음(현재 레이아웃 반영) | 권장 — 의미로 판정 | "a" 또는 Shift 시 "A" |
| event.code | 없음(물리 위치) | 권장 — 게임 / 단축키 바인딩 | "KeyA" |
| keyCode | 없음 | 비권장 — 더 이상 권장되지 않음 | 65 |
| which | 없음 | 비권장 — 더 이상 권장되지 않음 | 65 |
| charCode | 없음 | 비권장 — keydown에서는 0 | 0 |
한국어 키보드에서 확인할 값
아래 코드 블록은 해당 키를 패드에서 눌렀을 때 도구가 보여 주는 값입니다. ‘이벤트 속성’의 일부 줄과 ‘복사 가능한 JS 스니펫’을 실었습니다.
한/영 키와 한자 키
UI Events KeyboardEvent code Values 명세에 따르면 한국어 키보드의 한/영 키는 "Lang1", 한자 키는 "Lang2"입니다. 같은 표에서 Mac 일본어 키보드의 かな 키와 英数 키도 각각 "Lang1", "Lang2"이므로, code만으로는 한국어 키인지 일본어 키인지 구분할 수 없습니다.
event.code "Lang1"
event.code "Lang2"
key 값으로는 UI Events KeyboardEvent key Values 명세에 한글/영문 전환용 "HangulMode"와 한자용 "HanjaMode"가 정의되어 있습니다. 실제로 어떤 값이 오는지는 운영체제와 브라우저에 따라 다를 수 있으니 패드에서 직접 눌러 보세요.
채팅 입력창의 Shift+Enter
Enter로 보내고 Shift+Enter로 줄을 바꾸는 입력창을 만들 때, 패드에서 Shift+Enter를 누르면 다음과 같습니다.
event.key "Enter"
event.code "Enter"
keyCode 13
document.addEventListener('keydown', (e) => {
if (e.key === 'Enter' && e.shiftKey) {
// your handler
}
});
한글 조합 중의 Enter
한글을 입력하는 동안 마지막 글자는 조합 중 상태이고, 그동안 isComposing은 true입니다. UI Events의 비규범적인 예전 키 코드 절에는 입력기가 키 입력을 처리하는 keydown에서 keyCode로 229를 돌려준다고 적혀 있습니다. 위의 스니펫은 event.key와 수정자 키만 보므로, 입력란에 쓸 때는 한 줄을 더 넣으세요.
input.addEventListener('keydown', (e) => {
if (e.isComposing || e.keyCode === 229) return;
if (e.key === 'Enter' && !e.shiftKey) {
// 전송
}
});
캡처 패드는 텍스트 입력란이 아니어서 여기서 입력기가 조합을 시작하는지는 환경에 따라 다르고, 229가 보이지 않을 수 있습니다. 이 한 줄의 효과는 직접 만든 입력란에서 한글 입력기를 켜고 확인하세요.
주요 사용 사례
- 키보드 핸들러 디버깅 — 실제 event.key 값을 if 조건에 붙여 오타를 잡습니다.
- 게임 컨트롤 구현 — event.code를 쓰면 AZERTY 배열에서도 WASD가 같은 자리에서 작동합니다.
- 커맨드 팔레트 단축키 — event.key를 e.ctrlKey / e.metaKey와 조합합니다.
- 레거시 코드 점검 — keyCode / which를 읽어 예전 핸들러를 event.key로 옮깁니다.
preventDefault 동작
캡처 패드는 Tab, Space, Backspace, 화살표 키, F1-F12에 대해서만 preventDefault()를 호출합니다.
모두 브라우저가 이동이나 페이지 동작에 쓰는 키입니다. Ctrl+W / Cmd+Q 같은 시스템 단축키는
가로채지 않으며 브라우저 기본 동작이 유지됩니다.
키보드 배열
event.code는 물리 키를 US 키보드에서의 위치로 이름 붙입니다. 같은 명세에 따르면 "KeyQ"는 US 키보드에서 q, 프랑스어 AZERTY 키보드에서 a가 새겨진 키입니다. 그래서 AZERTY에서 a를 치면 key: "a", code: "KeyQ"가 됩니다. 키 위치가 중요한 단축키(WASD 이동)는 code로, 입력되는 글자가 중요한 단축키(Ctrl+Z 실행 취소)는 key로 판단하세요.
제한
- 휴대폰과 태블릿의 소프트 키보드는 보통 완전한 keydown 대신 입력한 글자가 담긴
input이벤트를 보냅니다. 패드 아래 대체 입력란은 그 글자를key로 보여 주고code,keyCode,which,charCode는 비워 둡니다. input 이벤트는 어떤 키를 눌렀는지 알려 주지 않기 때문입니다. 입력기가 조합하는 동안에는 중간 input 이벤트를 무시하고compositionend시점에 확정된 글자를 읽습니다. 이는 모의 조합 이벤트(일본어, 한국어, 중국어 병음)와 데스크톱 Chromium의 입력기 에뮬레이션으로 확인했으며 안드로이드 실기기에서는 테스트하지 않았습니다. - Ctrl+W, Cmd+Q 같은 단축키는 브라우저와 운영체제가 처리하므로 페이지에 전달되지 않습니다.
- 캡처 패드는 텍스트 입력란이 아니므로 입력기가 여기서 조합을 시작하는지는 환경에 따라 다릅니다.
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 명세는 이 속성들을 더 이상 쓰이지 않는 속성으로 보고 값을 정의하지 않으며, charCode와 keyCode 대신 key 속성을 쓰라고 합니다. 값이 브라우저, 운영체제, 키보드 배열에 따라 다릅니다. MDN도 더 이상 사용되지 않음(deprecated)으로 표시합니다. 브라우저는 호환성 때문에 계속 내보내며, 이 도구는 원래 값을 그대로 보여 주므로 예전 핸들러를 점검할 때 쓸 수 있습니다.
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은?
입력기가 글자를 조합하는 동안(한글이 아직 완성되지 않은 동안) isComposing은 true입니다. UI Events의 비규범적인 예전 키 코드 절에는 입력기가 키 입력을 처리 중일 때 keydown의 keyCode로 229를 돌려준다고 적혀 있습니다. Enter를 처리하는 코드는 이때 바로 return해야 조합을 확정하는 Enter로 폼이 제출되지 않습니다. 캡처 패드는 포커스할 수 있는 영역일 뿐 텍스트 입력란이 아니어서, 여기서 입력기가 조합을 시작하는지는 환경에 따라 다릅니다. 조합 중 동작은 직접 만든 입력란에서 확인하세요. 터치 기기용 대체 입력란은 compositionend를 기다렸다가 확정된 글자를 읽습니다(모의 조합 이벤트와 데스크톱 Chromium의 입력기 에뮬레이션으로 확인, 안드로이드 실기기에서는 미확인).
모바일에서 동작하나?
일부만 됩니다. 많은 소프트 키보드는 글자마다 keydown을 보내지 않고 입력한 글자가 담긴 input 이벤트만 보냅니다. 터치 기기에서는 패드 아래에 대체 입력란이 나타나, 입력한 글자를 key로 보여 주고 code, keyCode, which, charCode는 비워 둡니다. 입력기가 글자를 조합하는 동안(한글 음절 조합, 일본어 가나 한자 변환, 중국어 병음 등)에는 입력란의 글자를 건드리지 않고, 조합이 끝나면 확정된 글자(예: ‘한’)를 보여 줍니다. 영문도 단어 단위로 조합하는 소프트 키보드에서는 확정 후 hello 같은 단어가 한 번에 나타납니다. 이 동작은 모의 조합 이벤트와 데스크톱 Chromium의 입력기 에뮬레이션으로 확인했고 안드로이드 실기기에서는 테스트하지 않았습니다. keydown의 자세한 값을 보려면 물리 키보드를 연결한 데스크톱 브라우저를 쓰세요.
키 입력 데이터가 서버로 전송되나?
키 값은 전송하지 않습니다. 이벤트는 브라우저 안에서 읽고, 아무것도 저장하지 않습니다. 페이지는 Google Analytics를 불러오며 도구 이름과 동작만 기록합니다. 페이지를 연 뒤나 ‘지우기’ 뒤 첫 키에서 keydown 한 번, 복사에 성공하면 copy_snippet, 페이지를 연 뒤나 ‘지우기’ 뒤 터치 기기의 대체 입력란에 처음 입력하면 mobile_input 한 번입니다. 어떤 키를 눌렀는지는 기록하지 않습니다.