키보드 테스터

키보드 진단
ms
브라우저 예약 단축키는 기록되지 않을 수 있습니다.

이 키보드 테스터로 노트북, 데스크톱 키보드, USB/Bluetooth 외장 키보드의 모든 물리 키가 브라우저에 제대로 전달되는지 확인하세요. 키를 누르면 화면에서 즉시 불이 들어오고, 물리 코드 event.code, 실제로 만들어진 값 event.key, 키 위치, 반복 이벤트, 롤오버 최고치, 걸린 키 경고가 모두 브라우저 안에서 표시됩니다.

키보드를 테스트하는 방법

  1. 1

    배열 보기 선택

    점검하려는 키보드와 비슷하도록 ANSI, ISO, 컴팩트 중에서 고르세요. 국내에서 유통되는 키보드는 대부분 ANSI 기반의 한글 106키 배열이며, 오른쪽 Alt 자리에 한/영 키, 오른쪽 Ctrl 자리에 한자 키가 따로 있습니다. 자판에 한글이 새겨져 있어도 브라우저는 물리 키 코드를 그대로 보고합니다.

  2. 2

    테스트를 시작하고 키를 누르기

    테스트 시작을 클릭하고 이 탭에 포커스를 유지한 채 키를 하나씩 눌러 보세요. 누르고 있는 동안에는 파란색, 뗀 뒤에는 초록색, 걸린 키 경고 시간을 넘겨 계속 눌린 상태면 주황색으로 표시됩니다.

  3. 3

    진단 결과 읽기

    이벤트 로그, 롤오버 최고치, 반복 횟수, 눌린 키 목록을 보면 이벤트가 아예 오지 않는 키, 저절로 반복 입력되는 키, 조합 키 좌우 위치 문제, 키보드가 동시에 보고하지 못하는 조합을 찾아낼 수 있습니다.

브라우저 키보드 테스트로 알 수 있는 것

최신 데스크톱 브라우저의 키보드 이벤트는 유용한 값 두 가지를 제공합니다. event.codeKeyQ, Space, NumpadEnter, ShiftLeft처럼 물리적인 키 위치를 나타냅니다. event.key는 현재 활성화된 자판 배열이 만들어 낸 값이므로, 같은 물리 키라도 QWERTY, 두벌식, AZERTY, QWERTZ, 드보락 등 배열이나 입력기에 따라 다른 문자를 보고할 수 있습니다.

이 차이가 문제 해결의 핵심입니다. KeyQ에 불이 들어왔는데 키 값이 ㅂ으로 나온다면 물리 키는 정상적으로 전달된 것이고, 차이는 지금 켜져 있는 한글 자판 배열 때문입니다. 반대로 페이지가 받을 수 있어야 할 키인데도 이벤트가 전혀 나타나지 않는다면 하드웨어, 펌웨어, 운영체제 드라이버, 브라우저, 또는 웹 페이지보다 먼저 가로채는 단축키가 원인일 수 있습니다.

진단 항목 의미 활용
물리 코드 KeyA, Numpad5 같은 하드웨어 위치 코드 실제로 눌린 스위치 확인
키 값 현재 자판 배열이 만들어 낸 문자나 동작 배열 차이나 조합 키 문제 파악
위치 표준, 왼쪽, 오른쪽, 숫자 패드 Shift, Ctrl, Alt와 숫자 패드 키 구분 테스트
롤오버 최고치 한 번에 동시에 눌린 키의 최대 개수 동시 입력 한계나 고스팅 간단 점검
반복 이벤트 키를 누르고 있을 때 브라우저가 보내는 repeat 이벤트 저절로 반복 입력되는 키 찾기
걸린 키 경고 설정한 기준 시간보다 오래 눌린 상태로 남은 키 깨끗하게 떨어지지 않는 키 잡아내기

두벌식 자판과 한/영 전환

화면의 키 격자는 물리 위치를 기준으로 라틴 문자 라벨을 붙입니다. event.code가 문자가 아니라 위치를 나타내기 때문입니다. 한글 두벌식 배열에서는 같은 물리 키가 한글 낱자를 만들어 냅니다. 예를 들어 KeyQ는 ㅂ, KeyA는 ㅁ이 됩니다. 한/영 키는 보통 Lang1(HangulMode), 한자 키는 Lang2(HanjaMode) 코드로 보고되며, 노트북에서는 오른쪽 Alt와 오른쪽 Ctrl이 그 역할을 겸하기도 합니다.

한글 입력기가 글자를 조합하는 동안에는 브라우저가 키 값을 Process로 보고하거나 레거시 keyCode 229를 넘겨줄 수 있습니다. 이는 고장이 아니라 IME의 정상 동작입니다. 이럴 때도 물리 코드는 변하지 않으므로, 한/영 상태와 관계없이 키보드 하드웨어를 그대로 점검할 수 있습니다. 물리 키 자체를 확인하고 싶다면 영문 입력 상태에서 테스트하는 편이 결과를 읽기 쉽습니다.

롤오버, 고스팅, 그리고 한계

롤오버는 키보드가 동시에 보고할 수 있는 키 입력 수입니다. 일반 사무용 키보드는 두세 개 조합을 처리하는 수준이고, 게이밍 키보드는 6키 롤오버나 N키 롤오버를 내세웁니다. 이 테스터는 브라우저까지 실제로 도달한 키 이벤트만 보여 줄 수 있으며, 키보드나 운영체제, 브라우저가 애초에 전달하지 않은 키는 증명할 수 없습니다. 롤오버 최고치는 웹 페이지에서 해 보는 실용적인 점검일 뿐, 실험실 수준의 하드웨어 인증서가 아닙니다.

자주 하는 실수

  • 탭에 포커스를 유지하세요. 탭을 바꾸거나 주소창을 열면 keyup 이벤트가 끊길 수 있어, 페이지가 포커스를 잃으면 눌린 키 목록이 초기화됩니다.
  • Alt+Tab, Cmd+Tab, Cmd+W, Cmd+L, F5처럼 브라우저나 운영체제가 먼저 가져가는 단축키가 있습니다.
  • 모바일 키보드, 화상 키보드, IME 조합, 데드 키, 접근성 도구는 보고되는 키 값을 바꾸거나 지연시킬 수 있습니다.
  • 특정 키 하나가 반응하지 않는다면 스위치 고장이라고 단정하기 전에 다른 브라우저와 다른 USB 포트에서 다시 시도해 보세요.

자주 묻는 질문

아니요. 키 이벤트는 브라우저에서 읽고 표시할 뿐입니다. 키 값, 물리 코드, 타이밍 데이터, 이벤트 기록을 서버로 전송하지 않습니다.

한글 입력기가 낱자를 조합하는 중이라는 뜻입니다. 조합이 진행되는 동안 브라우저는 키 값을 Process로 보고하거나 레거시 keyCode 229를 넘길 수 있습니다. 물리 코드는 그대로이므로 하드웨어 점검에는 문제가 없으며, 문자 값을 확인하려면 한/영 키로 영문 상태에서 테스트하세요.

브라우저와 운영체제는 페이지가 읽기 전에 일부 키와 단축키를 먼저 가져갑니다. Alt+Tab, Cmd+Tab, Cmd+L, 새로고침 같은 시스템 조합은 이 테스터까지 전달되지 않을 수 있습니다.

event.code는 물리적인 키 위치이고, event.key는 현재 자판 배열이 만들어 낸 문자나 동작입니다. 배열을 바꾸면 키 값은 달라지지만 물리 코드는 그대로입니다.

테스트 중 브라우저에 한 번에 도달한 키의 최대 개수는 보여 줄 수 있습니다. 다만 키보드 펌웨어나 운영체제, 브라우저가 페이지에 전달하기 전에 걸러 낸 키까지 인증할 수는 없습니다.

관련 도구