---
title: "Ctrl 키 코드: keyCode 17, event.key \"Control\" (JavaScript)"
description: "JavaScript의 Ctrl 키: event.key \"Control\", keyCode 17, event.code \"ControlLeft\" 또는 \"ControlRight\". AltGr이 보내는 가짜 Ctrl, Mac의 Cmd, 막을 수 없는 단축키까지 정리했어요."
url: https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/control
language: ko
---

# Control 키 코드

두 Ctrl 키 모두 event.key "Control"과 keyCode 17을 보내요. 왼쪽과 오른쪽은 event.code와 event.location으로만 구분돼요.

## 모든 값 한눈에 보기

| 키 | event.code | event.key | keyCode | event.location |
| - | - | - | - | - |
| 왼쪽 Ctrl | `ControlLeft` | `Control` | 17 | 1(왼쪽) |
| 오른쪽 Ctrl | `ControlRight` | `Control` | 17 | 2(오른쪽) |

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

## 왼쪽 Ctrl 키에 반응하는 코드

권장: event.key로 구분

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

키의 위치로 구분: event.code

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

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

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

## 어떤 값을 쓸까요

단축키는 다른 키의 keydown에서 `event.ctrlKey`를 확인하세요. 어느 쪽 Ctrl이든 누르고 있으면 true라서 Ctrl 상태를 직접 추적할 필요가 없어요.

Ctrl 키 자체에 반응하려면 `event.key === 'Control'`을 확인하세요. 두 키 모두 keyCode 17과 함께 이 값을 보내요. 둘을 구분하려면 `event.code`(`ControlLeft` 또는 `ControlRight`)나 `event.location`(1은 왼쪽, 2는 오른쪽)을 쓰세요. 오른쪽 Ctrl이 아예 없는 노트북도 많아요.

Mac에서 control이라고 적힌 키도 같은 값을 보내요. 하지만 Mac의 단축키는 `ctrlKey`가 아니라 `metaKey`인 Cmd를 써요.

## 자주 막히는 부분

### 단축키가 Windows에서는 되는데 Mac에서는 안 돼요

Mac 사용자는 Ctrl + S가 아니라 Cmd + S를 눌러요. 둘 다 받으세요.

```
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
  event.preventDefault();
  save();
}
```

안내 문구도 맞게 보여 주세요. Windows와 Linux에서는 Ctrl + S, Mac에서는 Cmd + S 또는 ⌘S예요.

### AltGr로 @나 €를 입력할 때 Ctrl이 동작해요

Windows에서 AltGr은 Ctrl과 Alt를 함께 누른 것처럼 동작해요. Chrome과 Edge는 왼쪽 Control keydown을 먼저 보낸 뒤 오른쪽 Alt를 보내고, 입력된 키에서는 `ctrlKey`와 `altKey`가 모두 true예요. 그러면 폴란드어 사용자가 “ą”를, 독일어 사용자가 “@“를 입력할 때 Ctrl + Alt + 글자 단축키가 실행될 수 있어요. Ctrl + Alt 단축키는 피하거나, `event.key`가 예상한 글자가 아닌 다른 문자인 키는 건너뛰세요.

### Ctrl+W, Ctrl+T, Ctrl+N, Ctrl+Tab은 막을 수 없어요

브라우저가 가져가는 키예요. Windows에서는 Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page Up, Ctrl + Page Down이 해당돼요. Chrome과 Edge에서는 페이지에 keydown이 오지 않아요. Firefox는 keydown을 보낼 수도 있지만, 어느 쪽이든 `preventDefault()`로 브라우저를 막을 수 없어요. 다른 단축키를 고르세요. Ctrl + S, Ctrl + P, Ctrl + F는 페이지에 오고, `preventDefault()`로 브라우저 기본 동작을 막을 수 있어요.

### Mac에서 Ctrl+클릭하면 메뉴가 열려요

Mac에서 Control + 클릭은 오른쪽 클릭이에요. 브라우저가 `contextmenu`를 보내요. Mac에서는 “선택에 추가”에 Ctrl + 클릭을 쓰지 말고, Mac 앱처럼 Cmd + 클릭(`metaKey`)을 쓰세요.

### Ctrl+스크롤하면 페이지가 확대돼요

Ctrl을 누른 채 마우스 휠을 돌리면 페이지 배율이 바뀌고, 트랙패드에서 두 손가락을 모으거나 벌려도 마찬가지예요. Chrome, Edge, Firefox는 핀치를 Ctrl이 눌린 휠 이벤트로 보내요. `wheel` 리스너에서는 `ctrlKey`가 true로 보여요. 지도나 캔버스가 자체 확대를 구현할 때만 `preventDefault()`를 호출하고, 리스너를 `{ passive: false }`로 등록하세요.

## 관련 키

- [Alt 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/alt)
- [Meta 키 코드 (Windows 키와 Command)](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/meta)
- [Shift 키 코드](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/shift)
- [글자 키 코드 (A–Z)](https://devicetests.com/ko/%ED%82%A4%EC%BD%94%EB%93%9C-%ED%99%95%EC%9D%B8/letter-keys)
- [키코드 확인: 아무 키나 눌러 코드 보기](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)
