CKTIS / JavaScript
KeyboardEvent.key — значението на клавиша
KeyboardEvent.key е свойство от тип низ, което е само за четене и описва значението на клавиша. То отчита клавиатурната подредба и модификаторите; за разлика от code, не описва физическото положение на клавиша.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.keyKeyboardEvent.key, прочетено като event.key, връща низ, описващ значението на клавиша. При печатаемите знаци то отчита клавиатурната подредба и модификаторите, например "a" или "A". Свойството е само за четене.
UI Events групира именуваните стойности на клавишите в различни категории: "Enter" е сред клавишите, свързани с празни знаци, "Escape" е сред клавишите за потребителския интерфейс, а "ArrowDown" е сред клавишите за навигация. Интервалът има стойност " ", а не "Space". "Dead" обозначава мъртъв клавиш, използван за съставяне на знаци, а "Unidentified" означава, че клавишът не е могъл да бъде идентифициран. Сравненията на низове различават малки и главни букви.
Използвайте key, когато значението на клавиша е важно, и code, когато е важно физическото му положение. Не приемайте клавиатурните събития за пълен запис на въвеждането на текст; за редактиране обмислете събитията beforeinput и input.
Това е браузърно Web API, дефинирано в UI Events, а не функция на конкретно издание на ECMAScript. Наличието на Node 24 не доказва поддръжка. Примерът задава изрично key и code: конструкторът не изчислява key от code или shiftKey. Той проверява прочитането на стойностите, а не истинска клавиатура; поддръжката в целевите браузъри трябва да се провери отделно.
Примери
const events = [
new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];
console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));Резултат
a:KeyA A:KeyA Enter:Enter
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.