특정 키가 작동하지 않나요?
키가 입력되지 않으면 브라우저가 keydown과 keyup 이벤트를 받는지 확인하세요. 이벤트 누락은 초점, 자판 배열, OS 단축키, 접근성 설정, 연결 문제 또는 물리 스위치에서 비롯될 수 있습니다.
키보드 테스트 열기 →흔한 원인
잘못된 입력 언어, Num Lock·Fn 기능, 키 재지정 프로그램, 브라우저 단축키, 무선 배터리 문제, 이물질, 스위치 손상이 키 동작을 바꿀 수 있습니다. 일부 시스템·미디어 키는 웹페이지에 전달되기 전에 처리됩니다.
반복해서 따라 할 수 있는 단일 키 예제
화면 용어를 쉽게 읽기
- key — 현재 키가 뜻하는 문자·동작
- 미국 영어 배열에서 A 키를 누르면 보통
a가 입력됩니다. Shift와 함께 누르면A가 입력될 수 있습니다. - code — 눌린 키의 위치
- A 위치의 키는 Shift로 문자가 달라져도
KeyA라는 code 값을 보고합니다. 다른 자판 배열에서는 같은 위치의 키가 다른 문자를 입력할 수 있습니다. - 현재 눌림 — 아직 놓지 않은 키 수
- A 하나를 누르고 있으면 1, 놓으면 0입니다. 누른 총 횟수가 아닙니다.
- 테스트한 키 — 지금까지 관찰한 서로 다른 위치
- A를 두 번 눌렀다 놓아도 1입니다. 두 번째 누름을 새 키로 세지 않습니다.
key는 현재 자판 배열에서 Chrome이 보고하는 문자나 동작을 뜻합니다. code는 KeyA처럼 물리적인 키 위치를 나타내는 식별자입니다. 둘은 서로 바꿔 쓸 수 없습니다. 자판 배열이나 Shift 상태에 따라 key가 달라져도 code는 그대로일 수 있습니다.
- 키보드 테스트를 열고 입력란이나 언어 선택기가 아닌 페이지 영역을 클릭하세요. 입력란·텍스트 영역·선택기에 초점이 있으면 키 이벤트는 테스트 처리에서 제외됩니다.
- 초기화를 눌러 테스트한 키 수와 현재 눌림을 0으로 맞추세요. 미국 영어 배열에서 Shift를 누르지 않은 채 A를 누르고 있으세요.
key=a,code=KeyA가 표시되고 해당 키가 강조되며 현재 눌림: 1이 보여야 합니다. - A를 놓으면 keyup 이벤트가 기록되고 현재 눌림: 0이 표시되는지 확인하세요. 테스트한 키 수는 1로 남아야 합니다. A를 다시 눌러도 서로 다른 키 위치는 여전히 1개이므로 이 값은 누른 횟수와 다릅니다.
- 사용 중인 앱에서 실패하는 특정 키로 반복하세요. 정확한 key/code와 누름·놓기 이벤트가 모두 오는지 기록하세요. 일반 텍스트 편집기로 별도 비교한 뒤 필요하면 다른 포트나 정상 키보드와 비교하세요.
- 다른 키보드나 자판 배열을 비교하기 전에 초기화를 누르세요. 진단 페이지에는 암호나 개인 문장을 입력하지 마세요.
관찰 결과 해석
- 다른 문자가 표시됨: 입력 언어·Shift·Caps Lock·키 재지정을 먼저 확인하세요. 재지정 도구를 사용 중인 경우에만 잠시 해제하고 다시 검사하세요. key 값이 다르다는 이유만으로 스위치 고장을 확정할 수 없습니다.
- 이벤트가 나타나지 않음: 페이지에 다시 초점을 맞추세요. OS 단축키와 일부 미디어 키는 브라우저에 전달되지 않을 수 있습니다. 일반 입력·다른 앱과 비교하고, 포트·장치를 비교하기 전에 키보드 재연결과 무선 배터리를 확인하세요.
- 계속 눌린 상태로 표시됨: 모든 키를 놓고 초점을 되돌리거나 초기화하세요. 창 전환이 놓기 이벤트를 끊을 수 있으므로 하드웨어 문제를 의심하기 전에 재현하세요.
- 여러 키 조합에서만 실패함: 동시 입력 가이드 (EN)를 참고하세요. 단일 키 검사만으로는 키보드가 지원하는 모든 조합의 한계를 알 수 없습니다.
자주 묻는 질문
테스트한 키 수가 누른 횟수인가요?
아닙니다. 이번 세션에서 관찰한 서로 다른 키 위치 수입니다. 키를 누르고 있으면 반복 이벤트가 생겨도 새로운 키가 추가되지는 않습니다.
브라우저가 스위치 고장을 확정할 수 있나요?
아닙니다. 페이지에 도달한 이벤트를 보고합니다. 펌웨어·배열·OS 선처리·초점·연결을 따로 고려해야 합니다. 자동 키 이벤트는 화면 표시 경로를 검증할 뿐 물리 스위치를 검증하지 않습니다.
브라우저 테스트로 확인할 수 있는 것
브라우저 키 이벤트, 검사한 키 강조, 반복·누락된 놓기 이벤트를 볼 수 있습니다. OS 전용 키를 관찰하거나 스위치를 인증하거나 전기적 바운스를 직접 측정하거나 모든 펌웨어 문제를 구분하지는 못합니다.
한계와 개인정보
키 이벤트는 페이지 안에 머물며 Device Check 테스트 엔진이 업로드하지 않습니다.
브라우저 결과가 성공했다는 것은 검사 중 예상 이벤트나 스트림이 이 페이지에 도달했다는 뜻입니다. 유용한 근거지만 수리·교정·보증·제조사 인증은 아닙니다.
관련 가이드
결과를 확인할 준비가 됐나요?
위 단계를 마친 뒤 해당 Device Check 도구를 실행하세요.
키보드 테스트 열기 →