keyCode

Summary

Returns the Unicode value of a non-character key in a keypress event or any key in any other type of keyboard event.

For constants equivalent to these numeric codes, see KeyEvent.

Syntax

event.keyCode

Examples

var value = event.keyCode;
  • value is the Unicode value of the key that was pressed.
<!DOCTYPE html>
<html lang="en">
<head>
<title>keyCode example</title>

<script type="text/javascript">

function showKeyCode(e) {
	alert( "keyCode for the key pressed: " + e.keyCode + "\n" );
}

</script>
</head>

<body onkeydown="showKeyCode(event);">
<p>Press any key.</p>
</body>
</html>

Notes

In a keypress event, the Unicode value of the key pressed is stored in either the keyCode or charCode property, never both. If the key pressed generates a character (e.g. 'a'), charCode is set to the code of that character, respecting the letter case. (i.e. charCode takes into account whether the shift key is held down). Otherwise, the code of the pressed key is stored in keyCode.

keyCode is always set in the keydown and keyup events. In these cases, charCode is never set.

To get the code of the key regardless of whether it was stored in keyCode or charCode, query the which property.

Characters entered through an IME do not register through keyCode or charCode.

For a list of the keyCode values associated with particular keys, run the example in Example 7: Displaying Event Object Constants and view the resulting HTML table.

Specification

Not part of W3C DOM specification. See nsIDOMKeyEvent

Document Tags and Contributors

Last updated by: Dria,