⌨️
키보드 테스트 프로그램

키를 누르면 화면의 키보드가 실시간으로 반응합니다. 일반 키 입력뿐 아니라 좌우 조합키, 숫자패드, 동시 입력, 자동 반복, 잠금키 상태, 빠른 중복 입력 의심 기록까지 한 번에 확인할 수 있습니다.

키보드 테스트 프로그램은 실제 키를 누를 때 브라우저가 어떤 키 입력 이벤트를 받는지 확인하는 도구입니다. 새 키보드를 구매했을 때 모든 키가 정상 작동하는지 확인하거나, 특정 키가 눌리지 않는 문제, 한 번 눌렀는데 두 번 입력되는 현상, 좌우 Shift·Ctrl·Alt 구분, 숫자패드 인식 여부를 점검할 때 사용할 수 있습니다.

이 페이지는 별도의 프로그램 설치 없이 웹 브라우저에서 작동합니다. 입력한 키 이벤트와 문자 테스트 내용은 현재 브라우저 화면에서 처리되며, 이 코드에서는 키 입력 기록을 서버로 전송하거나 자동 저장하지 않습니다.

브라우저의 키보드 이벤트에는 대표적으로 key와 code가 있습니다. key는 현재 키보드 언어, 배열, Shift 같은 조합키 상태를 반영한 실제 입력값입니다. 같은 물리 키라도 한글·영문 배열이나 Shift 상태에 따라 값이 달라질 수 있습니다.

반면 code는 키보드에서의 물리적인 위치를 나타냅니다. 예를 들어 영문 Q 위치의 키는 현재 입력 언어와 관계없이 일반적으로 KeyQ로 식별됩니다. 따라서 키 고장 위치를 찾거나 게임 조작키처럼 물리 위치가 중요한 경우에는 code가 유용합니다.

KeyboardEvent.location 값은 키 위치를 구분하는 데 사용됩니다. 일반 키는 0, 왼쪽 조합키는 1, 오른쪽 조합키는 2, 숫자패드는 3으로 표시될 수 있습니다. 이 페이지는 같은 Enter, Shift, Ctrl, Alt라도 위치 정보를 함께 표시해 좌우 키와 숫자패드 인식 문제를 확인할 수 있도록 했습니다.

키보드의 동시 입력은 여러 키를 함께 눌렀을 때 각각의 키가 빠짐없이 인식되는지를 의미합니다. 게임, 리듬 게임, 단축키, 빠른 타이핑에서는 세 개 이상의 키를 동시에 누르는 상황이 자주 발생합니다. 테스트 영역에서 여러 키를 누른 상태로 유지하면 현재 동시 입력 수와 이번 테스트의 최대 동시 입력 수를 확인할 수 있습니다.

단, 브라우저나 운영체제가 예약한 조합은 웹페이지에 전달되기 전에 처리될 수 있습니다. 따라서 화면에 나타나지 않는 특정 조합이 반드시 키보드 하드웨어 문제라는 뜻은 아닙니다.

키보드 채터링은 키를 한 번 눌렀는데 접점 문제 등으로 여러 번 입력되는 것처럼 보이는 현상을 말합니다. 이 도구는 키를 뗀 직후 설정한 시간 안에 같은 키가 다시 눌리면 빠른 중복 입력으로 기록합니다. 기본값은 70ms이며 슬라이더로 민감도를 조절할 수 있습니다.

이 수치는 진단 보조용입니다. 빠르게 연타하거나 키를 떨면서 누른 경우에도 의심 횟수가 증가할 수 있으며, 운영체제의 키 반복 설정이나 키보드 펌웨어 특성에 따라서도 결과가 달라질 수 있습니다. 같은 키를 일정한 간격으로 천천히 눌러 재현되는지 확인하는 것이 중요합니다.

키를 길게 누르면 운영체제 설정에 따라 같은 keydown 이벤트가 반복해서 발생할 수 있습니다. 이때 브라우저는 repeat 값을 제공하며, 이 페이지에서는 입력 기록에 ‘자동 반복’으로 표시합니다. 따라서 길게 눌러 발생한 정상 반복과, 키를 뗐다가 매우 빠르게 다시 눌린 입력을 구분하는 데 도움이 됩니다.