키보드 테스트 이벤트 뷰어
아무 키나 누르면 JavaScript KeyboardEvent의 key, code, keyCode, which 값을 즉시 확인할 수 있습니다. 키보드 스위치 고장(채터링/더블클릭), 무한 동시 입력(NKRO), 조합 단축키 진단 등 하드웨어 상태를 정밀 진단해 보세요.
옵션
조합: -
현재 키
key: -
code: -
최근 입력
keyCode/which는 legacy 속성입니다. 새 코드에서는 key와 code를 함께 확인하는 것을 권장합니다.
모바일에서는 화면 키보드 제한이 있을 수 있으며, 외부 키보드나 입력창 포커스 상태에서 더 정확하게 테스트할 수 있습니다.
활용 꿀팁
키보드 입력이 제대로 인식되는지 바로 확인하세요
키보드를 눌렀을 때 브라우저가 실제로 어떤 키 입력으로 받아들이는지 확인하면 키보드 고장 여부나 입력 오류를 빠르게 점검할 수 있습니다. 특정 키가 먹히지 않거나 단축키가 예상과 다르게 작동할 때 눌린 키와 조합키 상태를 함께 확인해 보세요.
키보드 테스트 이벤트 뷰어란?
키보드 테스트 및 키 인식 확인 뷰어는 사용 중인 키보드가 고장 없이 모든 키를 제대로 인식하는지 실시간으로 자가 진단할 수 있는 온라인 테스트 도구입니다. 키 씹힘, 중복 입력(채터링), 무한 동시 입력(N-Key Rollover) 등 키보드의 하드웨어적 불량 여부를 즉각 확인하여 원활한 타이핑과 게이밍 환경을 점검할 수 있습니다.
사용 방법
- 1키보드 테스트 화면을 켠 상태에서 확인하고 싶은 키보드의 자판을 하나씩 차례대로 눌러봅니다.
- 2키를 누를 때마다 화면에 해당 키가 즉각 입력(keydown/keyup)되는지, 정상적인 키 신호가 초록색이나 활성화 배지로 켜지는지 확인합니다.
- 3여러 개의 키를 동시에 눌러보며 동시 입력(N-Key Rollover)이 누락 없이 작동하는지 테스트합니다.
- 4설정 옵션에서 특정 키의 기본 브라우저 단축키 작동 차단을 활성화하면, F5나 Tab 키를 누를 때 페이지 새로고침 없이 해당 키의 순수 작동 여부를 안전하게 검사할 수 있습니다.
- 5히스토리 로그를 통해 특정 키가 1번 눌렀을 때 여러 번 중복 입력되는 '채터링(중복 입력)' 불량 현상이 있는지 확인합니다.
key·code·keyCode는 서로 다른 식별자다
최근 검토: 2026년 7월 11일키보드 이벤트 확인 항목
키 이벤트 = key(표시값) + code(물리 위치) + keyCode/which(레거시 숫자)
한 번의 KeyboardEvent에서 사용자에게 보이는 값, 키의 물리적 위치, 호환용 숫자 코드를 나눠 확인합니다.
영문 a 키를 눌렀을 때
- • event.key = a
- • event.code = KeyA
- • event.keyCode = 65
- 1. 표시 문자는 a로 기록
- 2. 물리 키 식별자는 KeyA, 레거시 숫자 값은 65로 기록
일반적인 영문 a 입력은 key=a, code=KeyA, keyCode=65 조합으로 확인됩니다.
결과 해석
- key는 Shift나 Caps Lock에 따라 달라질 수 있지만 code는 물리 키 위치를 표현합니다.
- 게임 입력이나 하드웨어 진단에서는 code를, 텍스트 편집에서는 key를 우선 확인하는 편이 적합합니다.
결과가 달라지는 조건
- Fn·미디어 키는 키보드 펌웨어나 운영체제가 먼저 처리해 브라우저에 도달하지 않을 수 있습니다.
- keyCode와 which는 레거시 값이므로 새 구현에서는 key와 code를 함께 사용하는 것이 안전합니다.
자주 발생하는 입력 오류
- 대문자 A를 code=KeyA와 동일한 문자값으로 착각하면 Shift 상태를 놓치게 됩니다.
- Prevent Default를 켜지 않고 Space나 F5를 테스트하면 페이지 스크롤·새로고침이 먼저 일어날 수 있습니다.
관련 지식 및 참고 자료
- ●키보드 불량의 대표 증상 (채터링 및 키 씹힘): 채터링은 스위치 내부 접점 문제로 키를 한 번만 눌렀음에도 두 번 이상 중복 입력되는 현상입니다. 키 씹힘은 키를 강하게 눌러도 신호가 전혀 입력되지 않거나 늦게 반응하는 증상을 뜻합니다.
- ●무한 동시 입력(N-Key Rollover)과 고스트 현상: 보급형 키보드는 특정 조합의 키들을 동시에 누르면 인식이 안 되거나 엉뚱한 키가 입력되는 고스트(Ghosting) 현상이 일어날 수 있습니다. 게이밍 키보드는 무한 동시 입력을 지원하여 복잡한 단축키나 동시 조작을 완벽하게 수용합니다.
- ●기본 단축키 제어와 안전 테스트: 웹 브라우저에서 스페이스바를 누르면 스크롤이 내려가고, F5를 누르면 새로고침이 되며, Tab을 누르면 포커스가 이동합니다. 이 도구는 브라우저 기본 동작 방지 기능(preventDefault)을 지원해 브라우저 튕김 없이 모든 키를 오롯이 테스트할 수 있게 돕습니다.
- ●가상 키보드와 기기별 차이: 스마트폰이나 태블릿의 가상 화면 키보드는 문자 예측 및 조합 방식(IME)을 사용하므로, 실제 물리 키보드 하드웨어 스위치와는 다르게 입력이 인지될 수 있습니다. 정밀한 하드웨어 불량 테스트는 유선 또는 블루투스로 연결된 실제 물리 키보드로 수행하는 것을 권장합니다.
FAQ
Q.특정 키를 한 번만 눌렀는데 화면에 두 번 이상 연속으로 찍힙니다. 고장인가요?
네, 이를 '채터링(Chattering) 현상'이라고 하며 대표적인 키보드 스위치 접점 불량 증상입니다. 기계식 키보드의 스위치 내부 접점에 먼지가 끼거나 마모가 발생했을 때 주로 일어납니다. 이 툴의 히스토리 로그에서 짧은 시간 내에 keydown 이벤트가 연속해서 발생했는지 확인하여 자가 진단할 수 있습니다.
Q.동시에 여러 키를 누르면 일부 키가 입력되지 않고 누락됩니다. 해결 방법이 있나요?
키보드의 하드웨어 스펙에 따른 제한일 가능성이 큽니다. 일반 사무용 키보드는 동시에 인식할 수 있는 키 개수가 2~6개로 제한되거나 특정 조합에서 키가 씹히는 '고스트(Ghosting)' 현상이 발생합니다. 게임을 할 때 동시 입력이 중요하다면 무한 동시 입력(N-Key Rollover)을 공식적으로 지원하는 게이밍 키보드를 사용하는 것이 좋습니다.
Q.스페이스바나 F5, Tab 키를 누르면 화면이 움직이거나 새로고침이 되어 테스트가 힘듭니다.
웹 브라우저의 기본 기능이 작동하기 때문입니다. 화면의 설정 메뉴에서 '기본 동작 차단(Prevent Default)' 옵션을 활성화하시면, F5나 Tab, 스페이스바 같은 키를 입력해도 브라우저의 기본 반응이 억제되고 키의 입력 여부만 뷰어에 정확히 캡처되어 편리하게 테스트할 수 있습니다.
Q.기계식 키보드와 멤브레인 키보드는 동시 입력 성능에 차이가 있나요?
네, 멤브레인 키보드는 회로판 전체가 한 판으로 되어 있어 전기적 신호가 겹치면 동시 입력 한계(보통 3~6키)가 생기기 쉽습니다. 반면 개별 스위치마다 다이오드가 장착된 기계식 키보드나 무접점 키보드는 모든 키를 동시에 눌러도 100% 인식하는 무한 동시 입력(N-Key Rollover) 성능을 발휘하는 경우가 대부분입니다.
Q.노트북 키보드의 Fn 키나 전원 버튼, 볼륨 조절 키 등은 왜 인식이 되지 않나요?
Fn(Function) 키는 운영체제(OS)나 메인보드 바이오스(BIOS) 수준에서 내부적으로 처리되는 하드웨어 제어 키이므로 웹 브라우저까지 입력 신호가 오지 않습니다. 볼륨 조절이나 화면 밝기 같은 특수 미디어 키도 운영체제 시스템이 신호를 가로채기 때문에 웹 테스트 화면에서 인식이 생략될 수 있습니다.
Q.휴대폰이나 태블릿 등 모바일 기기에서도 이 키보드 테스트를 활용할 수 있나요?
네, 모바일 기기에 OTG 젠더를 사용하여 유선 키보드를 연결하거나 블루투스 키보드를 페어링한 상태에서 키 입력을 정확히 테스트할 수 있습니다. 다만, 모바일 화면의 가상 키보드(소프트웨어 자판)는 운영체제의 텍스트 자동 완성 및 입력 방식(IME) 정책에 따라 정확한 물리 키 신호를 보내지 않으므로, 정확한 테스트를 위해서는 물리 키보드를 연결해 주시기 바랍니다.
