Código de la tecla Esc (Escape)

Esc envía event.key "Escape", event.code "Escape" y keyCode 27.

Todos los valores de un vistazo

Valores de Esc
Teclaevent.codeevent.keykeyCodeevent.location
EscEscapeEscape270 (Normal)

keyCode tal como lo envían Chrome y Edge en Windows. La columna de Mac (Chrome y Safari en un Mac) y la de Firefox solo muestran los números que cambian; algunas teclas también cambian según el sistema, como explica el texto de abajo. event.which es siempre el mismo número que keyCode. event.key corresponde a un teclado inglés (US) sin pulsar Mayús.

Púlsala aquí

Haz clic aquí y pulsa Esc

¿Usas solo el teclado? Pulsa Esc y luego Tab para salir del cuadro de teclas.

Código para reaccionar a Esc

Recomendado: reconocer por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Escape') {
    // Tu código aquí
  }
});
Reconocer el lugar de la tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Escape') {
    // Tu código aquí
  }
});
Código antiguo que aún usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 27) {
    // Tu código aquí
  }
});

Qué valor usar

Comprueba event.key === 'Escape'. Solo hay una tecla Esc, y envía el mismo valor en todas las distribuciones, así que aquí event.key y event.code dicen lo mismo. key se lee mejor.

keyCode 27 sigue llegando en todos los navegadores, pero está obsoleto.

Los navegadores muy antiguos enviaban "Esc" en su lugar: Internet Explorer y Firefox 36 y anteriores. Acepta los dos solo si aún das soporte a esos navegadores.

Qué suele salir mal

Esc sale de la pantalla completa y mi controlador no puede evitarlo

En pantalla completa (y con el puntero bloqueado), Esc es del navegador. Siempre sale, y preventDefault() no sirve; puede que tu controlador ni siquiera vea ese Esc. Escucha fullscreenchange para saber cuándo ha ocurrido. En Chromium, un juego puede llamar a navigator.keyboard.lock(['Escape']) en pantalla completa; entonces la persona mantiene pulsada Esc para salir.

El diálogo se cierra aunque lo haya cancelado

Al pulsar Esc, el navegador cierra automáticamente un <dialog> modal. Primero dispara un evento cancel, que puedes detener:

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

Chrome te deja detenerlo solo una vez: pulsa Esc otra vez sin hacer clic en nada entre medias y se cierra igualmente. Para mantener un diálogo abierto a propósito, pon closedby="none" donde se admita, y guarda los cambios cuando se produzca el evento close en vez de confiar en cancel.

Esc cierra dos cosas a la vez

Cuando hay un menú abierto dentro de un diálogo, los dos oyen el mismo Esc. Cierra solo lo más interior: maneja Esc en el menú y luego llama a event.stopPropagation() para que no se ejecute el código de tu diálogo, y a event.preventDefault() para que un <dialog> nativo no se cierre también: cerrarlo es la acción por defecto del navegador, no de un controlador.

Esc en un campo de búsqueda lo vacía

En Chrome y en algunos otros navegadores, Esc vacía un <input type="search">. Si Esc debe cerrar tu cuadro de búsqueda, llama a preventDefault() en keydown, o vacía y cierra en un solo paso.

Los teclados de iPad pueden no tener tecla Esc

Algunos teclados de iPad no tienen tecla Esc, y los móviles nunca la tienen. Ofrece siempre también un botón de cerrar visible. Esc es un atajo, no la única salida.

Esc como salida

Quien usa el teclado espera que Esc cierre menús, ventanas emergentes y diálogos, y que devuelva el foco al botón que los abrió. Si un componente se queda con todas las teclas, como un editor de código o el cuadro del buscador de keycodes, deja que Esc lo suelte, para que Tab vuelva a avanzar. Así nadie se queda atascado con el teclado.