---
title: "숫자 키 코드: 0–9 keyCode 48–57, event.key, event.code | DeviceTests"
description: "윗줄 숫자 키는 keyCode 48~57, event.code \"Digit0\"~\"Digit9\", event.key \"0\"~\"9\"를 보내요. 프랑스어 키보드에서 Shift가 필요한 이유와 숫자패드 쌍둥이 키까지."
url: https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/number-keys
language: ko
---

# 숫자 키 코드 (0–9)

글자 위의 숫자 키는 event.code로 "Digit0"\~"Digit9"를 보내요. event.key는 영문(US) 배열에서 "0"\~"9", keyCode는 48\~57이에요.

## 모든 값 한눈에 보기

| 키 | event.code | event.key | keyCode | event.location |
| - | - | - | - | - |
| 0 | `Digit0` | `0` | 48 | 0(일반) |
| 1 | `Digit1` | `1` | 49 | 0(일반) |
| 2 | `Digit2` | `2` | 50 | 0(일반) |
| 3 | `Digit3` | `3` | 51 | 0(일반) |
| 4 | `Digit4` | `4` | 52 | 0(일반) |
| 5 | `Digit5` | `5` | 53 | 0(일반) |
| 6 | `Digit6` | `6` | 54 | 0(일반) |
| 7 | `Digit7` | `7` | 55 | 0(일반) |
| 8 | `Digit8` | `8` | 56 | 0(일반) |
| 9 | `Digit9` | `9` | 57 | 0(일반) |

keyCode는 Windows의 Chrome과 Edge가 보내는 값이에요. Mac 열(Mac의 Chrome과 Safari)과 Firefox 열에는 값이 다를 때만 표시돼요. 일부 키는 운영체제에 따라서도 값이 달라요. 아래 설명을 참고하세요. event.which는 항상 keyCode와 같은 값이에요. event.key는 Shift 없는 미국 배열 기준이에요.

## 0 키에 반응하는 코드

권장: event.key로 구분

```
document.addEventListener('keydown', (event) => {
  if (event.key === '0') {
    // 여기에 내 코드
  }
});
```

키의 위치로 구분: event.code

```
document.addEventListener('keydown', (event) => {
  if (event.code === 'Digit0') {
    // 여기에 내 코드
  }
});
```

keyCode를 쓰는 예전 코드(사용 비권장)

```
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 48) {
    // 여기에 내 코드
  }
});
```

## 어떤 값을 쓸까요

입력한 숫자에 반응하려면 `event.key`를 확인하세요. `/^[0-9]$/.test(event.key)`처럼요. 숫자를 입력하는 모든 배열에서 윗줄과 숫자패드(Num Lock이 켜진 상태)를 모두 받아요.

게임에서 “1\~5를 눌러 슬롯 고르기”처럼 위치가 중요하면 `event.code`(`Digit1`)를 쓰세요. Shift 없이는 다른 글자가 입력되는 배열에서도 코드는 같아요.

윗줄 숫자 키의 `keyCode`는 48부터 57까지예요. 숫자패드는 같은 숫자에 96부터 105까지의 값을 보내서, 윗줄 범위만 확인하면 숫자패드 입력을 놓쳐요.

## 자주 막히는 부분

### 프랑스어 키보드에서 숫자가 오지 않아요

Windows의 프랑스어 AZERTY 키보드는 윗줄이 Shift 없이는 & é “ ’ ( - è \_ ç à를 입력해요. 숫자를 쓰려면 Shift가 필요해요. 그래서 `Digit2`를 누르면 `event.key`는 “é”이고, Windows의 Chrome과 Firefox에서 `keyCode`는 50이에요. 입력한 숫자는 입력란의 값이나 `event.key`로 읽으세요. “1 누르기” 같은 단축키는 `event.code`로 확인해야 프랑스 사용자가 Shift를 누르지 않아도 돼요.

### Shift+2가 어디서나 “@“는 아니에요

Shift + 숫자의 기호는 배열마다 달라요. Shift + 2는 US 키보드에서 “@”, 영국과 독일 키보드에서는 `"`예요. Shift + 3은 US에서 “#”, 영국에서 “£”, 독일에서 “§“예요. 기호를 잡으려면 `Digit2`와 `event.shiftKey`가 아니라 `event.key === '@'`를 확인하세요. keyCode 50과 Shift의 조합을 “@“로 처리하는 옛 코드는 이런 배열에서 실제 입력과 다른 문자를 처리해요.

### 숫자패드는 다른 코드를 보내요

숫자패드 숫자는 고유한 코드를 쓰고, 예를 들어 숫자패드의 1은 `event.code`가 `Numpad1`, `keyCode`가 97이에요. Num Lock이 켜져 있으면 `event.key`는 윗줄 1 키와 같은 “1”이고, Num Lock을 끄면 이 키의 `event.key`는 “End”예요. 숫자패드가 아예 없는 노트북이 많으니 꼭 필요하게 만들지 마세요. `event.key`를 확인하면 윗줄 숫자 키와 숫자패드의 숫자를 모두 처리할 수 있어요.

### 입력란에 숫자를 쓰는데 단축키가 실행돼요

1\~9 같은 한 키 단축키는 사용자가 입력란에 입력할 때도 실행돼요. 입력란을 향한 키는 건너뛰세요.

```
if (event.target.closest('input, textarea, select, [contenteditable]')) return;
```

## 관련 키

- [숫자패드 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/numpad)
- [글자 키 코드 (A–Z)](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/letter-keys)
- [Shift 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/shift)
- [문장 부호 키 코드 (186–222)](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/punctuation)
- [키코드 확인: 아무 키나 눌러 코드 보기](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8)
- [모든 키 코드 표](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8#key-codes)
