In addition to the familiar Hooks like useState
, useEffect
, useRef
…, React also allows us to create custom Hooks with unique features that extracts component logic into reusable functions. Let’s learn how to write a React Custom Hook for API call in Typescript through a simple useAxiosFetch
example.
More Practice:
– React Typescript File Upload example
– React Hook Form Typescript example with Validation
– React Typescript and Axios with API call example
– React Table example: CRUD App | react-table 7
– React Typescript Authentication example with Hooks
Javascript version: React Custom Hook tutorial with example
Contents
What are React Custom Hooks?
From version 16.8, React Hooks are officially added to React. Besides built-in Hooks such as: useState
, useEffect
, useCallback
…, we can define our own hooks to use state and other React features without writing a class.
A Custom Hook has following features:
- As a function, it takes input and returns output.
- Its name starts with
use
likeuseQuery
,useMedia
… - Unlike functional components, custom hooks return a normal, non-jsx data.
- Unlike normal functions, custom hooks can use other hooks such as
useState
,useRef
… and other custom hooks.
You can see that some libraries also provide hooks such as useForm
(React Hook Form), useMediaQuery
(MUI), useQuery (React Query).
Why and When to use React Custom Hooks
Custom hooks give us following benefits:
- Completely separate logic from user interface.
- Reusable in many different components with the same processing logic. Therefore, the logic only needs to be fixed in one place if it changes.
- Share logic between components.
- Hide code with complex logic in a component, make the component easier to read.
So, when to use React custom hook?
- When a piece of code (logic) is reused in many places (it’s easy to see when you copy a whole piece of code without editing anything, except for the parameter passed. Split like how you separate a function).
- When the logic is too long and complicated, you want to write it in another file, so that your component is shorter and easier to read because you don’t need to care about the logic of that hook anymore.
React Custom Hook Typescript example
Let’s say that we build a React Typescript application with the following 2 components:
– TutorialsList
: get a list of Tutorials from an API call (GET /tutorials) and display the list.
– Tutorial
: get a Tutorial’s details from an API call (GET /tutorials/:id) and display it, but the interface will be different.
import React from "react";
import { Routes, Route } from "react-router-dom";
import Tutorial from "./components/Tutorial";
import TutorialsList from "./components/TutorialsList";
const App: React.FC = () => {
return (
<div>
...
<div>
<Routes>
<Route path="/tutorials" element={<TutorialsList/>} />
<Route path="/tutorials/:id" element={<Tutorial/>} />
</Routes>
</div>
</div>
);
}
export default App;
You can find the complete tutorial and source code for the React App at:
React Typescript and Axios with API call example
When not using React Custom Hooks Typescript
Let’s see how we’ve made for simple API call from the components TutorialsList
and Tutorial
without using React Custom Hooks.
We set up axios base URL and headers first .
http-common.ts
import axios from "axios";
export default axios.create({
baseURL: "http://localhost:8080/api",
headers: {
"Content-type": "application/json"
}
});
Then we use axios.get()
to fetch data from API with response
result or error
.
components/TutorialsList.ts
...
import axios from "../http-common.ts";
const TutorialsList: React.FC = () => {
const [tutorials, setTutorials] = useState<Array<ITutorialData>>([]);
const [currentTutorial, setCurrentTutorial] = useState<ITutorialData | null>(null);
const [searchTitle, setSearchTitle] = useState<string>("");
useEffect(() => {
retrieveTutorials();
}, []);
const retrieveTutorials = () => {
axios.get<Array<ITutorialData>>("/tutorials")
.then((response: any) => {
setTutorials(response.data);
console.log(response.data);
})
.catch((e: Error) => {
console.log(e);
});
};
const findByTitle = () => {
axios.get<Array<ITutorialData>>(`/tutorials?title=${searchTitle}`)
.then((response: any) => {
setTutorials(response.data);
setCurrentTutorial(null);
setCurrentIndex(-1);
console.log(response.data);
})
.catch((e: Error) => {
console.log(e);
});
};
return (...);
};
export default TutorialsList;
components/Tutorial.ts
...
import axios from "../http-common.ts";
import { useParams } from 'react-router-dom';
const Tutorial: React.FC = () => {
const { id }= useParams();
const initialTutorialState = {
id: null,
title: "",
description: "",
published: false
};
const [currentTutorial, setCurrentTutorial] = useState<ITutorialData>(initialTutorialState);
const getTutorial = (id: string) => {
axios.get<ITutorialData>(`/tutorials/${id}`)
.then((response: any) => {
setCurrentTutorial(response.data);
console.log(response.data);
})
.catch((e: Error) => {
console.log(e);
});
};
useEffect(() => {
if (id)
getTutorial(id);
}, [id]);
return (...);
};
export default Tutorial;
Using React Custom Hook in Typescript
Look at the code above, you can see that both components above have a very similar logic. They all call API to get data, save the response data into the state to update again when the data is successfully retrieved. The only difference is that they render different UI and different URL when calling API.
axios.get<Type>(...)
.then(response => {
...
})
.catch(e => {
...
});
We can reduce the repetition by creating a custom hook useAxiosFetch()
for reuse as follows:
customer-hooks/useAxiosFetch.ts
import { useState, useEffect } from "react";
import axios, { AxiosRequestConfig } from "axios";
axios.defaults.baseURL = "http://localhost:8080/api";
export const useAxiosFetch = (url) => {
const [data, setData] = useState<any>(null);
const [error, setError] = useState<any>(null);
const [loading, setLoading] = useState<boolean>(true);
const fetchData = async (): Promise<void> => {
try {
const response = await axios.get<any>(url);
setData(response.data);
} catch (error) {
if (axios.isAxiosError(error)) {
setError("Axios Error with Message: " + error.message);
} else {
setError(error);
}
setLoading(false);
} finally {
setLoading(false);
}
};
useEffect(() => {
fetchData();
}, []);
return [data, error, loading] as const;
};
From now, in 2 components TutorialsList
and Tutorial
, we just need to use custom hook useAxiosFetch
without worrying too much about the logic inside it. Just know it receives url
and returns an array that contains 3 values as const: data
, loading
and error
.
We can make the custom hook more dynamic. For example, we want to pass more details of the request (method
, url
, params
, body
…) instead of only url
. Furthermore, we may need to call fetchData()
method outside the hook.
Let’s modify a few code like this.
useAxiosFetch.js
import { useState, useEffect } from "react";
import axios, { AxiosRequestConfig } from "axios";
axios.defaults.baseURL = "http://localhost:8080/api";
export const useAxiosFetch = (params: AxiosRequestConfig<any>) => {
const [data, setData] = useState<any>(null);
const [error, setError] = useState<any>(null);
const [loading, setLoading] = useState<boolean>(true);
const fetchData = async (): Promise<void> => {
try {
const response = await axios.request(params);
setData(response.data);
} catch (error) {
if (axios.isAxiosError(error)) {
setError("Axios Error with Message: " + error.message);
} else {
setError(error);
}
setLoading(false);
} finally {
setLoading(false);
}
};
useEffect(() => {
fetchData();
}, []);
return [data, error, loading, fetchData] as const;
};
Let’s use this React custom Hook in our components:
components/TutorialsList.js
import React, { useState, useEffect, ChangeEvent } from "react";
import { useAxiosFetch } from "../custom-hooks/useAxiosFetch";
import ITutorialData from '../types/Tutorial';
const TutorialsList: React.FC = () => {
const [tutorials, setTutorials] = useState<Array<ITutorialData>>([]);
const [searchTitle, setSearchTitle] = useState<string>("");
const [ data, error, loading, fetchData ] = useAxiosFetch({
method: "GET",
url: "/tutorials",
params: {
title: searchTitle,
},
});
useEffect(() => {
if (data) {
setTutorials(data);
console.log(data);
} else {
setTutorials([]);
}
}, [data]);
useEffect(() => {
if (error) {
console.log(error);
}
}, [error]);
useEffect(() => {
if (loading) {
console.log("retrieving tutorials...");
}
}, [loading]);
const onChangeSearchTitle = (e: ChangeEvent<HTMLInputElement>) => {
const searchTitle = e.target.value;
setSearchTitle(searchTitle);
};
const findByTitle = () => {
fetchData();
};
// ...
return (
<div>
<div>
<input
type="text"
placeholder="Search by title"
value={searchTitle}
onChange={onChangeSearchTitle}
/>
<button type="button" onClick={findByTitle} >
Search
</button>
</div>
<div>
<h4>Tutorials List</h4>
{loading && <p>loading...</p>}
<ul className="list-group">
{tutorials &&
tutorials.map((tutorial, index) => (
<li key={index} >
{tutorial.title}
</li>
))}
</ul>
</div>
</div>
);
};
export default TutorialsList;
components/Tutorial.js
import React, { useState, useEffect, ChangeEvent } from "react";
import { useParams, useNavigate } from 'react-router-dom';
import { useAxiosFetch } from "../custom-hooks/useAxiosFetch";
import ITutorialData from "../types/Tutorial";
const Tutorial: React.FC = () => {
const { id }= useParams();
const initialTutorialState = ...;
const [currentTutorial, setCurrentTutorial] = useState<ITutorialData>(initialTutorialState);
const [ data, error, loading ] = useAxiosFetch({
method: "GET",
url: "/tutorials/" + id,
});
useEffect(() => {
if (data) {
setCurrentTutorial(data);
console.log(data);
}
}, [data]);
useEffect(() => {
if (error) {
console.log(error);
}
}, [error]);
useEffect(() => {
if (loading) {
console.log("getting tutorial...");
}
}, [loading]);
const handleInputChange = (event: ChangeEvent<HTMLInputElement>) => {
const { name, value } = event.target;
setCurrentTutorial({ ...currentTutorial, [name]: value });
};
// ...
return (
<div>
{currentTutorial ? (
<div>
<h4>Tutorial</h4>
{ loading && <p>loading...</p>}
<form>
<div>
<label htmlFor="title">Title</label>
<input
type="text"
id="title"
name="title"
value={currentTutorial.title}
onChange={handleInputChange}
/>
</div>
<div>
<label htmlFor="description">Description</label>
<input
type="text"
id="description"
name="description"
value={currentTutorial.description}
onChange={handleInputChange}
/>
</div>
<div>
<label>
<strong>Status:</strong>
</label>
{currentTutorial.published ? "Published" : "Pending"}
</div>
</form>
...
</div>
) : (
<div>
<br />
<p>Please click on a Tutorial...</p>
</div>
)}
</div>
);
};
export default Tutorial;
Conclusion
In this tutorial, you’ve known what, why and when to use a React Custom Hook in Typescript example. You also implement the Custom Hook Typescript for API call using Axios with an example.
Further Reading
- React Hooks
- React Hook Form Typescript example with Validation
- React Typescript and Axios with API call example
- React Table example: CRUD App | react-table 7
- React Typescript File Upload example
- React Typescript Authentication example with Hooks