React + TypeScript: Image onLoad & onError Events

Updated: March 3, 2023 By: A Goodman Post a comment

The end-to-end example below shows you how to handle image events in a React app that uses TypeScript. There are 2 events that we are going to work with:

  • onLoad: This event occurs when an image has been loaded.
  • onError: This event is triggered if an error occurs while loading an image.


App Preview

The app we are going to build will display 2 images. The first image is faulty but the second one is not. With the error image, a replacement image takes its place (thanks to the onError event). Also, the URLs of the images will be printed out in the console when they have finished loading (thanks to the onLoad event).

Below is how our app works. If your internet speed is fast, go to Chrome DevTools > Network > Fast 3G (or slow 3G) to see the loading process more clearly.

The Code

1. Create a new project by running:

npx create-react-app --template typescript

2. Remove the boilerplate in src/App.tsx and add the following:

// App.tsx
import React from "react";
import "./App.css";

const IMAGE_1 = "";
const IMAGE_2 =

// This image will be used as the fallback for the error images

const App = () => {
  // This function is triggered when an image has been loaded
  const imageOnLoadHandler = (
    event: React.SyntheticEvent<HTMLImageElement, Event>
  ) => {
      `The image with url of ${event.currentTarget.src} has been loaded`
    if (event.currentTarget.className !== "error") {
      event.currentTarget.className = "success";

  // This function is triggered if an error occurs while loading an image
  const imageOnErrorHandler = (
    event: React.SyntheticEvent<HTMLImageElement, Event>
  ) => {
    event.currentTarget.src = FALLBACK_IMAGE;
    event.currentTarget.className = "error";

  return (
    <div className="container">


export default App;

3. Replace the unwanted CSS code in src/App.css with the following:


.container {
  box-sizing: border-box;
  margin: 30px auto;
  width: 700px;

  display: flex;
  align-items: start;

img {
  max-width: 340px;
  margin: 15px;

/* Non-error image */
.success {
  border: 5px solid blue;

/* Error image */
.error {
  border: 5px solid red;


We’ve gone through a complete example of handling image onLoad and onError events in React and TypeScript. If your project is large and has a lot of images, then it’s hard to guarantee that all of them will be loaded correctly. Therefore, understanding the onError event is important if you want to improve your user experience.

If you’d like to explore more about modern React and TypeScript, take a look at the following articles:

You can also check our React category page and React Native category page for the latest tutorials and examples.

Notify of
Inline Feedbacks
View all comments

Related Articles