The keyup event is fired when a key is released.

Bubbles Yes
Cancelable Yes
Interface KeyboardEvent
Event handler property onkeyup

keydown and keyup provide a code indicating which key is pressed, while keypress indicates which character was entered. For example, a lowercase "a" will be reported as 65 by keydown and keyup, but as 97 by keypress. An uppercase "A" is reported as 65 by all events.

Since Firefox 65, the keyup and keydown events are now fired during IME composition, to improve cross-browser compatibility for CJKT users (bug 354358, also see keydown and keyup events are now fired during IME composition for more useful details). To ignore all keyup events that are part of composition, do something like this (229 is a special value set for a keyCode relating to an event that has been processed by an IME):

eventTarget.addEventListener("keyup", event => {
  if (event.isComposing || event.keyCode === 229) {
    return;
  }
  // do something
});

Examples

This example logs the KeyboardEvent.code value whenever you release a key inside the <input> element.

addEventListener keyup example

<p>Focus the IFrame first (e.g. by clicking in it), then try pressing some keys.</p>
<p id="log"></p>
const log = document.getElementById('log');

document.addEventListener('keyup', logKey);

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

onkeyup equivalent

document.onkeyup = logKey;

Specifications

Specification Status
UI Events Working Draft

Browser compatibility

No compatibility data found. Please contribute data for "api.Document.keyup_event" (depth: 1) to the MDN compatibility data repository.

See also

Document Tags and Contributors

Last updated by: chrisdavidmills,