---
title: "Kod klawisza Escape: keyCode 27, event.key \"Escape\" (JavaScript)"
description: "Esc w JavaScripcie wysyła event.key i event.code \"Escape\" oraz keyCode 27. Naciśnij, aby sprawdzić, i zobacz, czemu pełny ekran i okna dialogowe go przejmują."
url: https://devicetests.com/pl/kod-klawisza/escape
language: pl
---

# Kod klawisza Escape

Esc wysyła event.key "Escape", event.code "Escape" i keyCode 27.

## Wszystkie wartości w skrócie

| Klawisz | event.code | event.key | keyCode | event.location |
| - | - | - | - | - |
| Esc | `Escape` | `Escape` | 27 | 0 (Zwykły) |

keyCode tak, jak wysyłają go Chrome i Edge w systemie Windows. Kolumny Mac (Chrome i Safari na Macu) i Firefox pokazują tylko liczby, które się różnią. Niektóre klawisze różnią się też zależnie od systemu, jak opisano niżej. event.which to zawsze ta sama liczba co keyCode. event.key dotyczy układu US bez wciśniętego klawisza Shift.

## Kod, który reaguje na klawisz: Escape

Zalecane: dopasuj event.key

```
document.addEventListener('keydown', (event) => {
  if (event.key === 'Escape') {
    // Twój kod tutaj
  }
});
```

Rozpoznaj klawisz po jego położeniu: event.code

```
document.addEventListener('keydown', (event) => {
  if (event.code === 'Escape') {
    // Twój kod tutaj
  }
});
```

Stary kod, który nadal używa keyCode (jego używanie nie jest już zalecane)

```
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 27) {
    // Twój kod tutaj
  }
});
```

## Której wartości użyć

Sprawdzaj `event.key === 'Escape'`. Jest tylko jeden klawisz Esc i na każdym układzie wysyła tę samą wartość, więc `event.key` i `event.code` mówią tu to samo. `key` czyta się lepiej.

`keyCode` 27 nadal dociera w każdej przeglądarce, ale jest wycofywany.

Bardzo stare przeglądarki wysyłały zamiast tego `"Esc"`: Internet Explorer i Firefox 36 i starsze. Akceptuj obie wartości tylko wtedy, gdy nadal je obsługujesz.

## Co sprawia kłopoty

### Esc zamyka tryb pełnoekranowy mimo obsługi zdarzenia

W trybie pełnoekranowym (i przy zablokowanym wskaźniku) Esc należy do przeglądarki. Naciśnięcie Esc kończy tryb pełnoekranowy lub zwalnia blokadę wskaźnika. `preventDefault()` tego nie powstrzyma, a funkcja obsługująca klawiaturę może w ogóle nie otrzymać zdarzenia. Nasłuchuj `fullscreenchange`, aby wiedzieć, że to się stało. W Chromium gra może w trybie pełnoekranowym wywołać `navigator.keyboard.lock(['Escape'])`. Wtedy użytkownik musi przytrzymać Esc, aby wyjść.

### Okno dialogowe zamyka się mimo anulowania zdarzenia

Modalny element `<dialog>` sam zamyka się po Esc. Najpierw wywołuje zdarzenie `cancel`, które możesz zatrzymać:

```
dialog.addEventListener('cancel', (event) => event.preventDefault());
```

Chrome pozwala zapobiec zamknięciu okna tylko za pierwszym razem: naciśnij Esc ponownie, nie klikając niczego po drodze, a okno i tak się zamknie. Jeśli okno ma celowo pozostać otwarte, ustaw `closedby="none"` tam, gdzie jest to obsługiwane, i zapisuj pracę użytkownika po zdarzeniu `close`. Nie polegaj na zdarzeniu `cancel`.

### Esc zamyka dwie rzeczy naraz

Gdy w oknie dialogowym otwarte jest menu, oba elementy reagują na to samo naciśnięcie Esc. Zamknij tylko menu: obsłuż Esc w menu, potem wywołaj `event.stopPropagation()`, żeby kod okna się nie uruchomił, i `event.preventDefault()`, żeby natywny element `<dialog>` też się nie zamknął: jego zamknięcie to domyślna akcja przeglądarki, a nie obsługa zdarzenia.

### Esc w polu wyszukiwania czyści je

W Chrome i niektórych innych przeglądarkach Esc opróżnia `<input type="search">`. Jeśli Esc ma zamykać twoje pole wyszukiwania, wywołaj `preventDefault()` w keydown albo wyczyść i zamknij w jednym kroku.

### Klawiatura iPada nie ma klawisza Esc

Niektóre klawiatury iPada nie mają Esc, a telefony nigdy go nie mają. Zawsze dodaj też widoczny przycisk zamknięcia. Esc to skrót, a nie jedyna droga wyjścia.

## Esc jako droga wyjścia

Użytkownicy klawiatury oczekują, że Esc zamknie menu, wyskakujące okna i okna dialogowe oraz odda fokus przyciskowi, który je otworzył. Jeśli element przechwytuje każdy klawisz, jak edytor kodu albo pole w naszym narzędziu do sprawdzania kodów klawiszy, po naciśnięciu Esc zakończ przechwytywanie klawiszy, aby Tab znów przenosił fokus do kolejnego elementu. Dzięki temu użytkownicy klawiatury nie utkną.

## Powiązane klawisze

- [Kod klawisza Enter](https://devicetests.com/pl/kod-klawisza/enter)
- [Kod klawisza Tab](https://devicetests.com/pl/kod-klawisza/tab)
- [Kody klawiszy funkcyjnych (F1–F24)](https://devicetests.com/pl/kod-klawisza/function-keys)
- [Kod klawisza Meta (klawisz Windows i Command)](https://devicetests.com/pl/kod-klawisza/meta)
- [Kod klawisza: naciśnij dowolny klawisz, aby zobaczyć jego kody](https://devicetests.com/pl/kod-klawisza)
- [Wszystkie kody klawiszy w jednej tabeli](https://devicetests.com/pl/kod-klawisza#key-codes)
