작동 방식
키를 누를 때마다 W3C UI Events 표준이 정한 keydown과 keyup 이벤트가 발생합니다. 테스터는 자판 배열과 상관없이 물리적인 키 위치를 나타내는 event.code(예: KeyA, ShiftRight)와, 현재 배열과 보조키로 그 키가 만드는 문자나 기능인 event.key를 읽습니다.
화면 키보드는 풀사이즈 ANSI 배열에 왼쪽 Shift 옆의 ISO 키를 더한 것입니다. 미디어 키나 한/영 같은 언어 키처럼 배열에 없는 키는 따로 목록으로 보여 줍니다. 브라우저가 Keyboard Map API를 지원하면 글자 키에 내 자판의 글자가 표시됩니다.
event.key와 event.code
같은 물리 키도 다른 값을 낼 수 있습니다. 두 값을 모두 보여 주는 이유입니다.
| 누른 키 | event.key | event.code |
|---|---|---|
| 미국 배열에서 A | "a" | "KeyA" |
| Shift와 함께 A | "A" | "KeyA" |
| 프랑스 AZERTY 배열에서 같은 키 | "q" | "KeyA" |
| 오른쪽 Shift | "Shift" | "ShiftRight" |
| 숫자 키패드의 1 (Num Lock 켬) | "1" | "Numpad1" |
고스팅과 동시 입력(롤오버)
많은 키보드는 키를 격자(매트릭스)로 배선해서 세 개 이상 함께 누르면 일부 조합을 모두 감지하지 못합니다. 키가 안 먹히거나(블로킹), 누르지 않은 키가 입력되기도 합니다(고스팅). ‘최대 동시 입력’은 이 키보드가 동시에 눌렸다고 알린 키의 최대 개수입니다. N키 롤오버 게이밍 키보드는 모든 키를 알리고, 부트 모드의 USB 키보드는 보통 보조키 외 6개에서 멈춥니다.
팁
- 다른 키는 되는데 한 키만 불이 안 들어오면 고장이거나 이물질 때문일 수 있습니다. 한 번 눌렀는데 두 번 들어오면 채터링일 수 있습니다.
- 게임에서 W A S D와 Shift, Space처럼 실제로 쓰는 조합으로 동시 입력을 확인하세요.
- 운영체제가 브라우저보다 먼저 가로채는 단축키는 여기서 테스트할 수 없습니다.
기준과 출처
- UI Events · W3C
- UI Events KeyboardEvent code 값 · W3C
- UI Events KeyboardEvent key 값 · W3C
- KeyboardEvent.code · MDN Web Docs
최종 검토 2026년 10월 18일
자주 묻는 질문
키에 불이 안 들어오는 이유는?
키나 스위치가 고장 났거나, 그 키가 브라우저까지 오지 않기 때문입니다. Fn 키와 Win+L, Cmd+Tab 같은 시스템 단축키는 운영체제가 처리합니다. 다른 프로그램에서도 눌러 보면 구별할 수 있습니다.
event.key와 event.code는 무엇이 다른가요?
event.code는 키의 물리적 위치라 배열이 바뀌어도 그대로이고, event.key는 지금 그 키가 입력하는 값이라 배열, Shift, 다른 보조키에 따라 달라집니다. 한글 입력 중에는 key가 Process로 나올 수 있습니다.
N키 롤오버는 어떻게 테스트하나요?
키를 떼지 말고 하나씩 더 눌러 보세요. ‘최대 동시 입력’이 키보드가 함께 눌렸다고 알린 최대 개수입니다. 누르고 있는 키에 불이 안 들어오면 그 조합에서 한계에 도달한 것입니다.