키코드 확인

아무 키나 눌러 이름과 브라우저가 받는 모든 코드를 확인하세요.

아무 키나 누르면 코드가 나와요.

아무 키나 누르세요

event.key키로 입력하는 글자나 하는 동작
…
event.code어떤 키인지: 키보드에서의 위치
…
event.keyCode예전 숫자 코드(권장되지 않지만 아직 전송됨)
…

화면 키보드나 입력기가 무엇을 보내는지 보려면 여기에 입력하세요.

이벤트 상세 정보

event.which
…keyCode와 같은 숫자예요. 이 속성도 사용을 권장하지 않아요.
event.location
…왼쪽, 오른쪽, 숫자패드처럼 둘 이상 있는 키를 구분해요.
조합 키
…이 키를 누를 때 함께 누른 키: ctrlKey, shiftKey, altKey, metaKey.
event.repeat
…키를 누르고 있어서 반복 중이면 true예요.
event.isComposing
…입력기가 글자를 조합하는 중(한국어, 중국어, 일본어)이면 true예요.
내 배열에서
…Shift 없이 이 키가 내 키보드 배열에서 입력하는 글자예요(Keyboard Map API). 지금 쓰는 배열이 아니라 기본 배열이 나올 수 있어요.
getModifierState()
…브라우저가 알려 주는 모든 조합 키와 잠금 키예요. 꺼짐은 브라우저가 알려 주지 않는다는 뜻일 수도 있어요.

사용할 코드

키를 구분하는 기준

어떤 키보드 배열에서도 같은 키예요. 게임과 단축키에 좋아요.

키를 누르면 코드가 여기에 나와요.

이벤트 로그(아직 없음)

키를 누르면 이벤트가 여기에 나와요.

키보드만 쓰나요? Esc를 누른 뒤 Tab을 눌러 키 상자에서 나오세요.

빠른 시작

  1. 아무 키나 누르세요. 휴대폰에서는 먼저 텍스트 상자를 탭하세요.
  2. 키의 이름, event.key, event.code, event.keyCode를 확인하세요.
  3. 값 옆의 복사 버튼이나 코드 예시의 코드 복사 버튼을 누르세요.

결과 보는 법

보이는 모습 뜻
큰 키 누른 키의 이름이에요. 함께 누른 조합 키도 나와요. 왼쪽 Shift, Ctrl + S, 숫자패드 Enter 같은 식이에요.
event.key 키가 입력하는 문자나 키의 기능이에요. 예를 들어 “a”, Shift와 함께 누르면 “A”, Enter나 위쪽 방향키는 “Enter”나 “ArrowUp”으로 표시돼요. 키보드 배열과 Shift 상태에 따라 달라져요.
event.code 어떤 키인지, 즉 키보드에서의 위치예요. “KeyA”, “ShiftRight” 같아요. 어떤 배열에서도 같아요.
event.keyCode 예전 방식의 숫자 코드예요. 예를 들어 A 키는 65예요. 새 코드에는 권장하지 않지만 브라우저는 지금도 보내요.
event.location 대부분의 키는 0, 왼쪽 키는 1, 오른쪽 키는 2, 숫자패드는 3이에요.
조합 키 Ctrl, Shift, Alt, Meta(Windows 키 또는 Cmd) 중 눌려 있던 키예요.
내 배열에서 Shift 없이 이 키가 내 키보드 배열에서 입력하는 글자예요. 컴퓨터의 Chrome과 Edge만 알 수 있어요.
getModifierState() Caps Lock, Num Lock처럼 브라우저가 알려 주는 모든 조합 키와 잠금 키의 켜짐과 꺼짐이에요.
이벤트 로그 모든 keydown, keyup, 텍스트 이벤트예요. 최신순이에요.

어떤 값을 쓸까요?

  • 위치가 중요한 키는 event.code를 쓰세요. 게임 조작(WASD), 단축키, 키보드로 치는 피아노 같은 경우예요.
  • 의미가 중요한 키는 event.key를 쓰세요. Enter, Escape, 방향키처럼 기능이 있는 키나 “?“처럼 입력되는 문자를 구분할 때 쓰세요.
  • 새 코드에는 keyCode나 which를 쓰지 마세요. 사용을 권장하지 않는 값이고, 브라우저마다 달라요.

팁: 사용할 코드에서는 방금 누른 키와 함께 누른 조합 키에 맞는 JavaScript를 만들어 줘요.

키 코드 표

미국 키보드 배열의 키 코드와 Windows 키 이름이에요. 다른 배열에서는 문장 부호 키의 keyCode가 다를 수 있어요.
키event.codeevent.keykeyCodeFirefox의 keyCode
BackspaceBackspaceBackspace8
TabTabTab9
EnterEnterEnter13
숫자패드 EnterNumpadEnterEnter13
왼쪽 ShiftShiftLeftShift16
오른쪽 ShiftShiftRightShift16
왼쪽 CtrlControlLeftControl17
오른쪽 CtrlControlRightControl17
왼쪽 AltAltLeftAlt18
오른쪽 AltAltRightAlt18
PausePausePause19
Caps LockCapsLockCapsLock20
EscEscapeEscape27
SpaceSpace" "32
Page UpPageUpPageUp33
Page DownPageDownPageDown34
EndEndEnd35
HomeHomeHome36
왼쪽 화살표ArrowLeftArrowLeft37
위쪽 화살표ArrowUpArrowUp38
오른쪽 화살표ArrowRightArrowRight39
아래쪽 화살표ArrowDownArrowDown40
Print ScreenPrintScreenPrintScreen44
InsertInsertInsert45
DeleteDeleteDelete46
0~9Digit0~Digit90~948~57
A~ZKeyA~KeyZa~z65~90
왼쪽 WindowsMetaLeftMeta91
메뉴ContextMenuContextMenu93
숫자패드 0~숫자패드 9Numpad0~Numpad90~996~105
숫자패드 곱하기NumpadMultiply*106
숫자패드 더하기NumpadAdd+107
숫자패드 빼기NumpadSubtract-109
숫자패드 소수점NumpadDecimal.110
숫자패드 나누기NumpadDivide/111
F1~F12F1~F12F1~F12112~123
Num LockNumLockNumLock144
Scroll LockScrollLockScrollLock145
음소거AudioVolumeMuteAudioVolumeMute173181
볼륨 낮추기AudioVolumeDownAudioVolumeDown174182
볼륨 높이기AudioVolumeUpAudioVolumeUp175183
세미콜론Semicolon;18659
등호Equal=18761
쉼표Comma,188
마이너스Minus-189173
마침표Period.190
슬래시Slash/191
백틱Backquote`192
왼쪽 대괄호BracketLeft[219
백슬래시Backslash\220
오른쪽 대괄호BracketRight]221
따옴표Quote'222

키 기능 바꾸기

키 매핑 앱은 자체 키 이름을 써서 이 값을 그대로 붙여 넣지 않아요. 큰 키의 이름과 event.code로 어떤 키인지 확인한 뒤 앱에서 그 키를 고르세요. PowerToys 키보드 관리자와 Karabiner-Elements에서는 키를 눌러서 고를 수 있어요.

문제가 있나요?

키를 눌러도 아무것도 안 나와요

먼저 키 상자를 클릭하세요. 페이지 자체에서 누른 키도 세지만, 키 상자가 화면에 보일 때만 그래요. 메뉴 검색이나 다른 입력란에 입력한 키는 세지 않아요.

어떤 키는 전혀 안 나와요

키보드나 컴퓨터가 일부 키를 자기 몫으로 가져가서 브라우저가 받지 못해요. Fn, 밝기 키, 많은 미디어 키가 그래요. 어떤 웹사이트도 이 키들은 볼 수 없어요.

Windows에서 Print Screen은 keyup만 보내서 키를 뗄 때 나와요.

단축키가 탭을 닫거나 창을 열었어요

브라우저가 가져가는 단축키가 있어요. Windows에서는 Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page Up, Ctrl + Page Down, Ctrl + 1~Ctrl + 9, Mac에서는 Cmd + N, Cmd + T, Cmd + W, Cmd + Q예요. Alt + F4, Windows + L, Ctrl + Alt + Del처럼 컴퓨터가 가져가는 것도 있어요. Windows 키만 누르면 시작 메뉴가 열려요. 페이지는 이 키들을 받지 못해요. Ctrl + S나 F5 같은 다른 단축키는 아무 동작 없이 키 상자에 나와요.

안드로이드 휴대폰에서 키가 “Unidentified”이고 keyCode가 229예요

화면 키보드는 웹사이트에 어떤 키를 탭했는지 알려 주지 않고 글자만 보내요. 이벤트 로그에서 input 이벤트를 보세요. data에 입력한 내용이 나와요(지울 때는 data가 비어 있고 inputType이 무슨 일이 일어났는지 알려 줘요). 실제 키 코드를 보려면 Bluetooth나 USB 키보드를 연결하세요.

아이폰은 보통 실제 키와 keyCode를 보내지만 event.code는 비어 있는 경우가 많아요.

한국어, 중국어, 일본어를 입력하면 keyCode 229가 나와요

입력기가 여러 키로 글자 하나를 조합해서 키마다 keyCode 229나 key “Process”가 나오고, 조합 중에는 isComposing이 true예요. 첫 키와 마지막 키는 브라우저마다 달라요. 완성된 텍스트는 compositionend나 input 이벤트에서 읽으세요. 자세한 내용은 keyCode 229와 “Unidentified” 키에 있어요.

키가 “Dead”로 나와요

데드 키예요. 다음에 누르는 키에 악센트를 붙이려고 기다려요. ´ 다음에 e를 눌러 é를 만드는 식이에요. 악센트가 있는 배열에 있어요. 키 상자에 어떤 키인지 나와요. 악센트가 붙은 글자를 보려면 텍스트 상자에 두 키를 입력하세요.

AltGr이 Ctrl과 Alt도 켜요

Windows에서 AltGr은 Ctrl과 Alt를 함께 누른 것처럼 작동해요. Chrome과 Edge는 먼저 Left Control의 keydown을 보내고 그다음 Right Alt를 보내요. ctrlKey와 altKey가 모두 true예요. getModifierState(“AltGraph”)도 true지만, Ctrl + Alt도 AltGr로 셀 수 있어서 항상 구분되지는 않아요.

키가 엉뚱한 글자를 입력해요

event.code는 맞는데 event.key가 틀리다면 컴퓨터가 다른 키보드 배열을 쓰는 거예요. 컴퓨터의 언어나 키보드 설정에서 바꾸세요. event.code도 틀리다면 키보드를 바꿔 매핑하는 앱이나 키보드 자체 소프트웨어가 키를 바꾸고 있는 거예요.

Mac에서 Cmd를 누른 채 누른 키는 keyup이 안 나와요

macOS는 Cmd를 누른 채 누른 키의 keyup을 보내지 않아서 브라우저가 항상 알려 줄 수는 없어요.

다른 브라우저에서는 keyCode가 달라요

Firefox는 몇몇 키에서 다른 숫자를 보내요. 미국 키보드에서 ; 키는 Chrome이 186을 보내지만 Firefox는 보통 59예요. 문장 부호 키는 키보드 배열에 따라서도 달라져요. event.code나 event.key를 쓰세요.

작동 방식

키를 누르면 브라우저가 페이지에 keydown 이벤트를 보내고, 뗄 때는 keyup 이벤트를 보내요. 도구는 브라우저가 보낸 값을 그대로 보여 줘요. 바꾸거나 추측하지 않고, 키 이름만 event.code로 알아내요.

키 상자 안에서는 키의 원래 동작을 막아서 F5나 Ctrl + S를 눌러도 새로고침이나 저장 대신 코드가 나와요. 키 상자에서 나오려면 Esc를 누른 뒤 Tab을 누르세요.

텍스트 상자는 화면 키보드나 입력기가 보내는 값을 보여 줘요. 거기서는 텍스트가 평소처럼 입력되고, 이벤트 로그에는 beforeinput, input, composition 이벤트도 나와요.

도구로 볼 수 있는 것

  • 브라우저가 페이지에 전달하는 모든 키와 그 값.
  • 컴퓨터의 Chrome과 Edge에서는 이 키가 내 배열에서 입력하는 글자(Keyboard Map API). 지금 쓰는 배열이 아니라 기본 배열이 나올 수 있어요.

볼 수 없는 것

  • Fn처럼 키보드나 컴퓨터가 자기 몫으로 가져가는 키.
  • Ctrl + W나 Alt + F4처럼 브라우저나 컴퓨터가 가져가는 단축키.
  • 스캔 코드와 Windows 가상 키 코드.

테스트의 판정 기준이 어디서 왔는지, 브라우저가 재지 못하는 것이 무엇인지는 키보드 테스트 방식에서 보세요.

자주 묻는 질문

키코드가 뭔가요?

키코드는 웹사이트에 어떤 키를 눌렀는지 알려 주는 값이에요. 키를 누를 때마다 브라우저가 이 값을 웹사이트에 보내요. 예를 들어 Enter는 13, A는 65예요.

브라우저는 키를 세 가지 값으로 나타내요. event.key는 입력한 문자나 키의 기능을, event.code는 키보드에서 키의 위치를 나타내요. event.keyCode는 예전 숫자 코드예요. 지금도 전달되지만 새 코드에는 권장하지 않아요.

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

event.code는 키보드에서의 위치예요. 예를 들어 KeyQ는 Tab 오른쪽 키예요. 어떤 배열에서도 같아서 게임(WASD)과 단축키에 알맞아요.

event.key는 키가 입력하는 글자예요. 미국 키보드에서는 "q", 프랑스 키보드에서는 "a", Shift를 누르면 "Q"예요. 글자가 중요할 때 쓰세요.

keyCode는 이제 권장하지 않나요? 대신 무엇을 써야 하나요?

네. keyCode, which, charCode는 이제 사용을 권장하지 않아요. 브라우저가 지금도 보내서 예전 코드는 계속 돌아가지만, 브라우저와 키보드 배열마다 숫자가 달라요. 새 코드에는 event.key나 event.code를 쓰세요.

keyCode 229가 나오는 이유는 뭔가요?

229는 입력기나 화면 키보드가 키를 가져갔다는 뜻이에요. 안드로이드 키보드는 거의 모든 키에서 event.key "Unidentified"와 함께 229를 보내요. 아이폰은 보통 실제 키를 보내요. 한국어, 중국어, 일본어를 입력할 때는 글자를 조합하는 동안 229가 나와요. 대신 input 이벤트에서 텍스트를 읽으세요.

지금 누르는 키가 뭔가요?

키 상자에서 눌러 보세요. 큰 키 모양에 오른쪽 Alt나 숫자패드 Enter 같은 이름이 나와요. 옆의 event.code 값은 정확한 키를 알려 주고, 어떤 키보드 배열에서도 같아요.

키의 스캔 코드도 볼 수 있나요?

아니요. 브라우저는 웹사이트에 스캔 코드나 Windows 가상 키 코드를 주지 않아요. Windows에서는 AutoHotkey의 Key History 창에서 둘 다 볼 수 있어요.

이 사이트가 입력한 내용을 기록하나요?

아니요. 이 페이지는 키 입력을 화면에만 보여 주고, 저장하거나 보내지 않아요.