Type the onKeyPress event in React (TypeScript)

Type the onKeyPress event in React (TypeScript) #

Use the React.KeyboardEvent<HTMLElement> type to type the onKeyPress event in React. The KeyboardEvent interface is used for onKeyPress events. You can access the value of the key pressed by the user as event.key.

Copied!
import React from 'react';

const App = () => {
  const handleKeyPress = (event: React.KeyboardEvent<HTMLElement>) => {
    console.log(event.key);
  };

  return (
    <div>
      <input
        type="text"
        id="message"
        name="message"
        defaultValue=""
        onKeyPress={handleKeyPress}
      />
    </div>
  );
};

export default App;

We typed the event as React.KeyboardEvent<HTMLElement> because the KeyboardEvent type is used for onKeyPress events in React.

However, we could have been more specific when typing the event.

Copied!
const App = () => {
  // 👇️ onKeyPress event is written inline
  // hover over the `event` parameter with your mouse
  return (
    <div>
      <input
        type="text"
        id="message"
        name="message"
        defaultValue=""
        onKeyPress={event => console.log(event)}
      />
    </div>
  );
};

export default App;

TypeScript is able to infer the type of the event when it's written inline.

This is very useful because it works with all events. Simply write a "mock" implementation of your event handler inline and hover over the event parameter to get its type.

Now that we know that the correct type for the onKeyPress event in the example is React.KeyboardEvent<HTMLInputElement>, we can extract our handler function.

Copied!
import React from 'react';

const App = () => {
  // ✅ type event correctly
  const handleKeyPress = (event: React.KeyboardEvent<HTMLInputElement>) => {
    console.log(event.key);
  };

  return (
    <div>
      <input
        type="text"
        id="message"
        name="message"
        defaultValue=""
        onKeyPress={handleKeyPress}
      />
    </div>
  );
};

export default App;

The type we passed to the KeyboardEvent generic is HTMLInputElement because we attached the onKeyPress event to an input element, however you could be attaching the event to a different element.

Some commonly used types are: HTMLInputElement, HTMLButtonElement, HTMLAnchorElement, HTMLImageElement, HTMLTextAreaElement, HTMLSelectElement, etc.

As long as you write the event handler function inline and hover over the event parameter, TypeScript will be able to infer the event's type.