본문 바로가기

키보드 테스트

화면 자판에 눌린 키가 표시됩니다. 어떤 키가 안 눌리는지, 엉뚱한 키로 들어가는지 눈으로 확인할 수 있습니다.

로딩 중...

왜 만들었나요

중고로 산 키보드가 특정 키만 가끔 안 먹는 것 같은데, 메모장에 쳐 보는 것만으로는 확신이 안 섰습니다. 눌러 본 키가 화면에 남으면 빠뜨린 키도 없이 점검되겠다 싶어 만들었습니다.

Note

누른 키 정보는 서버로 전송되지 않습니다. 화면에 표시할 뿐 어디에도 기록되지 않으므로, 비밀번호를 눌러 봐도 남지 않습니다.

사용 방법

  1. 페이지를 열면 바로 입력을 받습니다. 아무 키나 누르면 화면 자판에서 그 키가 강조됩니다. Ctrl+Shift+S 처럼 함께 눌러도 모두 켜집니다.

    키보드 테스트-guide-1

  2. 모든 키를 하나씩 눌러 보세요. 눌러 본 키는 옅은 색으로 남고, 끝까지 색이 바뀌지 않는 키가 문제 있는 키입니다. 다시 점검하려면 다시 테스트를 누릅니다.

    키보드 테스트-guide-2

이렇게 나옵니다

A 키를 누르면 이렇게 나옵니다.

화면 자판    A 키가 강조되고, 이후 옅은 색으로 남음
key          a
code         KeyA
keyCode      65

알아두면 좋은 것

세 가지 값의 차이

값뜻
key실제로 입력된 글자. Shift를 누르면 a → A 로 바뀝니다
code자판의 물리적 위치. 한/영 상태나 Shift와 무관하게 같습니다
keyCode옛날 방식 번호. 지금은 쓰지 않기를 권합니다

단축키를 만들 때는 code 를 쓰는 게 안전합니다. 한글 입력 상태에서도 위치가 같아 동작이 어긋나지 않습니다.

이런 경우에는

어떤 키를 눌러도 반응이 없어요

  • 브라우저 다른 창이나 탭이 선택된 상태일 수 있습니다. 이 페이지를 한 번 클릭한 뒤 다시 눌러 보세요
  • 키보드 연결(USB·블루투스)을 확인하세요

특정 키만 표시되지 않아요

키보드 고장일 수도 있지만, 브라우저나 운영체제가 먼저 가져가는 키일 수도 있습니다.

  • F11(전체화면), Cmd+Q, Alt+Tab 같은 조합은 브라우저에 도달하지 않습니다
  • 다른 키는 정상인데 하나만 계속 안 되면 그 키가 고장 났을 가능성이 큽니다

여러 키가 동시에 안 눌려요

저가형 키보드는 동시에 인식할 수 있는 키 수가 제한되어 있습니다. 게임처럼 여러 키를 함께 눌러야 하는 상황에서 문제가 되며, 이 도구로 몇 개까지 동시에 켜지는지 확인할 수 있습니다.

이 도구로는 안 되는 것

  • 고장을 고쳐 주지 않습니다. 확인만 합니다
  • 타자 속도를 재는 기능은 없습니다

용어 설명

동시 입력 제한

키보드가 한 번에 인식할 수 있는 키 개수입니다. 제품에 따라 6개까지만 되기도 하고, 전체 키를 모두 인식하는 제품도 있습니다.

자주 묻는 질문

어떤 키가 고장 났는지 어떻게 확인하나요?

화면 자판을 켠 상태에서 키를 하나씩 눌러 보면 됩니다. 누르는 순간 그 키가 강조되고, 한 번이라도 눌러 본 키는 옅은 색으로 남아 아직 안 눌러 본 키와 구분됩니다. 모든 키를 한 번씩 눌러 봤을 때 색이 바뀌지 않는 키가 물리적으로 고장 났거나 인식되지 않는 키입니다. '다시 테스트'를 누르면 표시를 처음부터 초기화합니다.

keyCode는 deprecated인데 왜 아직 보여주나요?

event.keyCode는 웹 표준에서 폐기(deprecated)됐지만, 오래된 라이브러리나 레거시 코드가 여전히 이 숫자값으로 키를 비교하기 때문에 디버깅할 때 확인이 필요합니다. 그래서 값은 보여주되 deprecated 표시를 달아 뒀습니다. 새로 짜는 코드라면 물리 키 위치를 나타내는 event.code나 입력 문자를 나타내는 event.key를 쓰는 게 맞습니다.

event.key와 event.code는 뭐가 다른가요?

event.key는 실제로 입력된 문자로, 자판 배열·Shift·입력 언어가 반영됩니다(같은 키라도 'a'와 'A'가 다르게 들어옴). event.code는 키의 물리적 위치라 자판 배열과 무관하게 항상 같은 값(예: 'KeyA')이 들어옵니다. 단축키 매칭에는 code, 텍스트 입력 처리에는 key가 보통 적합합니다.

Ctrl+S를 눌렀는데 브라우저 저장 창이 안 떠요.

가운데 캡처 영역에 포커스가 있는 동안에는 테스트하려는 단축키가 브라우저 기본 동작(저장·인쇄·페이지 스크롤 등)을 건드리지 않고 화면에만 기록되도록 막아 둡니다. 영역 바깥을 한 번 클릭해 포커스를 해제하면 모든 단축키가 원래대로 동작합니다. 특정 페이지 전체에서 키를 가로채는 방식이 아니라 이 테스트 영역에 한정됩니다.

휴대폰에서도 쓸 수 있나요?

블루투스·USB 등 물리 키보드를 연결하면 정상적으로 값이 잡힙니다. 다만 스마트폰 화면(가상) 키보드는 대부분의 브라우저에서 event.key가 'Unidentified', keyCode가 229로만 들어와 어떤 키를 눌렀는지 개별 구분이 되지 않는 한계가 있습니다. 이 도구를 포함한 모든 키 이벤트 뷰어에 공통되는 브라우저 제약입니다.

마지막 업데이트: 2026년 8월