keyboard 키보드 테스터 star

작동 원리

물리적으로 키를 하나 누를 때마다 브라우저에서는 한 쌍의 KeyboardEvent가 발생합니다 — 누르는 순간 keydown, 손을 떼는 순간 keyup입니다. 각 이벤트는 서로 다른 두 가지 식별자를 담고 있으며, 이 차이는 보기보다 훨씬 중요합니다: key는 현재 키보드 배열이 만들어내는 문자(실제로 입력되는 값)이고, code는 어떤 배열이 활성화되어 있든 변하지 않는 스위치의 물리적 위치입니다. 이 도구는 누를 때마다 두 값을 나란히 기록합니다.

이 구분이 하드웨어 테스트의 핵심입니다. 예를 들어 운영체제의 키보드 배열을 QWERTY에서 Dvorak으로 바꾸고 왼쪽 위 글자 키를 눌러본다고 가정해 봅시다. QWERTY에서는 이 키가 key: "q"를 보고하고, Dvorak에서는 같은 물리적 스위치가 key: "'"를 보고합니다 — 하지만 두 경우 모두 code는 항상 KeyQ로 유지됩니다. code는 문자가 아니라 스위치 자체를 나타내기 때문입니다. 특정 물리적 스위치가 죽었는지 채터링을 일으키는지 확인하고 싶다면, 배열과 무관하게 진실을 말해주는 값은 code입니다. 반대로 배열 매핑이 올바른지 — 예를 들어 새 키보드 드라이버나 언어 팩을 설치한 뒤 — 확인하려면 key가 해당 배열에서 기대한 값과 일치하는지 비교해야 하며, 이는 완전히 다른 질문입니다.

키를 누를 때마다 화면은 문자 또는 키 이름을 즉시 표시하고 물리적 코드를 덧붙이며, 지금까지 테스트한 모든 키를 배지 목록으로 계속 쌓아가므로 키보드 전체를 빠짐없이 훑어보기 쉽습니다. 등록된 keydown마다 카운터가 하나씩 증가하며, 한 번의 물리적 입력이 두 번 이상의 카운트를 만든다면 이는 테스트 오류가 아니라 채터링입니다.

알아두어야 할 사항

• 죽은 키: 해당 물리적 위치에서 아무것도 나타나지 않습니다 — key가 아니라 code를 확인하세요. 죽은 스위치는 어떤 이벤트도 발생시키지 않기 때문입니다.
• 채터링: 한 번의 물리적 입력에 카운터가 2 이상 증가합니다 — 마모된 기계식 스위치나 신호를 튀게 만드는 멤브레인 접점 불량이 원인입니다.
• 운영체제·브라우저 예약 키: Fn, 일부 미디어 키, 특정 조합의 Windows/Command 키는 웹페이지의 JavaScript에 도달하기 전에 운영체제나 브라우저가 가로챕니다 — 여기서 반응이 없다고 해서 항상 하드웨어 고장을 의미하지는 않습니다.
• 고스팅과 롤오버: 저가형 키보드에서 여러 키를 동시에 누르면 내부 매트릭스의 한계에 부딪힐 수 있습니다. 동시 조합에서 특정 키가 소리 없이 빠진다면 이는 안티고스팅/N-키 롤오버의 한계이지, 반드시 손상을 의미하지는 않습니다.
• 모든 처리는 로컬에서: 이벤트는 오직 브라우저 안의 JavaScript로만 읽히고 표시됩니다 — 어떤 키 입력도 네트워크로 전송되지 않으며, 페이지를 벗어나는 즉시 기록은 사라집니다.