search
HomeWeb Front-endJS TutorialHow to Use Axios Interceptors to Handle API Error Responses

How to Use Axios Interceptors to Handle API Error Responses

When building modern web applications, handling API calls and their responses is a critical part of development. Axios, a popular JavaScript library, simplifies making HTTP requests, but it also comes with built-in features like interceptors that allow developers to manage responses and errors in a more streamlined and efficient manner.

In this article, we will focus on using Axios interceptors to handle API error responses effectively, allowing you to standardize error handling across your entire application.

What is Axios?

Axios is a promise-based HTTP client for JavaScript that supports the async/await syntax for making requests to APIs. It's popular because it's simple to use, and its capabilities can be easily extended with interceptors.

Axios Basics Example:

import axios from 'axios';

axios.get('/api/data')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error fetching data:', error);
  });

While this example demonstrates how to handle requests and errors with .then and .catch, using interceptors can make your code more efficient when you need to manage multiple API requests.

What are Axios Interceptors?

Axios interceptors are functions that allow you to intercept and handle both requests and responses before they are processed by .then or .catch. This is particularly useful when you need to apply common configurations to all requests or handle error responses in a uniform way.

There are two main types of interceptors:

  1. Request Interceptor: Used to modify or add headers, tokens, or other configurations to requests before they are sent.
  2. Response Interceptor: Used to handle responses or errors globally, including logging or retrying requests when necessary.

Why Use Response Interceptors?

When dealing with multiple API endpoints, each may return different types of error messages or status codes. Without interceptors, you would need to handle errors for each individual API call, which can lead to repetitive and unmaintainable code.

With a response interceptor, you can manage all error responses in a single place, ensuring a consistent approach to handling errors across your app.

Setting Up an Axios Response Interceptor

1. Install Axios

First, make sure you have Axios installed in your project:

npm install axios

2. Create an Axios Instance

To set up interceptors, it's best to create an Axios instance that can be reused throughout your app. This helps to standardize your request and response handling.

import axios from 'axios';

axios.get('/api/data')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error fetching data:', error);
  });

3. Add a Response Interceptor

You can add a response interceptor to catch and handle errors before they reach your .then or .catch blocks in your individual API calls.

npm install axios

4. Making API Calls

With the interceptor in place, you can now use apiClient for your API calls. If any error occurs, it will be automatically caught and handled by the interceptor.

import axios from 'axios';

const apiClient = axios.create({
  baseURL: 'https://api.example.com',  // Replace with your API base URL
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
});

In this setup, you don't need to write error-handling code for every single API call. The interceptor centralizes this logic and makes your API calls cleaner and easier to maintain.


Practical Use Cases for Axios Interceptors

1. Automatic Token Refresh

If your API uses authentication tokens (e.g., JWT), you may encounter a situation where the token expires, and you need to refresh it. Axios interceptors can be used to automatically refresh the token when a 401 Unauthorized response is received.

apiClient.interceptors.response.use(
  (response) => {
    // If the response is successful (status code 2xx), return the response data
    return response;
  },
  (error) => {
    // Handle errors globally
    if (error.response) {
      // Server responded with a status code out of 2xx range
      const statusCode = error.response.status;
      const errorMessage = error.response.data.message || 'An error occurred';

      // Handle different status codes accordingly
      if (statusCode === 401) {
        // Handle unauthorized error, for example by redirecting to login
        console.error('Unauthorized access - redirecting to login');
      } else if (statusCode === 500) {
        // Handle server errors
        console.error('Server error - try again later');
      } else {
        // Handle other types of errors
        console.error(`Error ${statusCode}: ${errorMessage}`);
      }
    } else if (error.request) {
      // No response received (network error, timeout, etc.)
      console.error('Network error - check your internet connection');
    } else {
      // Something else happened during the request
      console.error('Request error:', error.message);
    }

    // Optionally, return a rejected promise to ensure `.catch` is triggered in individual requests
    return Promise.reject(error);
  }
);

2. Handling Network Errors

If your app relies on external APIs, network issues can be a common problem. Axios interceptors can help provide user-friendly error messages in case of network failures.

// Example API call
apiClient.get('/users')
  .then(response => {
    console.log('User data:', response.data);
  })
  .catch(error => {
    // This will be triggered if the error isn't handled by the interceptor
    console.error('Error fetching users:', error);
  });

Benefits of Using Axios Interceptors

  1. Centralized Error Handling: Instead of writing error-handling code for every API call, you can handle errors in a single place.

  2. Cleaner Code: Since error handling is taken care of by the interceptor, your individual API calls will be cleaner and more concise.

  3. Improved Maintainability: Changes to error handling (e.g., adding new cases or refining error messages) can be done in one place, making the codebase easier to maintain.

  4. Consistency: Interceptors ensure a consistent approach to handling errors, so you don’t have to worry about missing edge cases or writing redundant code.


Conclusion

Using Axios interceptors for handling API error responses can greatly improve the structure, maintainability, and consistency of your code. By centralizing the error handling logic, you can make your API calls more efficient and reduce repetitive code across your application.

Interceptors are a powerful feature of Axios that can be used for a wide range of use cases, from managing token refreshes to displaying user-friendly error messages during network failures. Start leveraging Axios interceptors today to simplify error handling and improve your application's resilience!

The above is the detailed content of How to Use Axios Interceptors to Handle API Error Responses. For more information, please follow other related articles on the PHP Chinese website!

Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
JavaScript and the Web: Core Functionality and Use CasesJavaScript and the Web: Core Functionality and Use CasesApr 18, 2025 am 12:19 AM

The main uses of JavaScript in web development include client interaction, form verification and asynchronous communication. 1) Dynamic content update and user interaction through DOM operations; 2) Client verification is carried out before the user submits data to improve the user experience; 3) Refreshless communication with the server is achieved through AJAX technology.

Understanding the JavaScript Engine: Implementation DetailsUnderstanding the JavaScript Engine: Implementation DetailsApr 17, 2025 am 12:05 AM

Understanding how JavaScript engine works internally is important to developers because it helps write more efficient code and understand performance bottlenecks and optimization strategies. 1) The engine's workflow includes three stages: parsing, compiling and execution; 2) During the execution process, the engine will perform dynamic optimization, such as inline cache and hidden classes; 3) Best practices include avoiding global variables, optimizing loops, using const and lets, and avoiding excessive use of closures.

Python vs. JavaScript: The Learning Curve and Ease of UsePython vs. JavaScript: The Learning Curve and Ease of UseApr 16, 2025 am 12:12 AM

Python is more suitable for beginners, with a smooth learning curve and concise syntax; JavaScript is suitable for front-end development, with a steep learning curve and flexible syntax. 1. Python syntax is intuitive and suitable for data science and back-end development. 2. JavaScript is flexible and widely used in front-end and server-side programming.

Python vs. JavaScript: Community, Libraries, and ResourcesPython vs. JavaScript: Community, Libraries, and ResourcesApr 15, 2025 am 12:16 AM

Python and JavaScript have their own advantages and disadvantages in terms of community, libraries and resources. 1) The Python community is friendly and suitable for beginners, but the front-end development resources are not as rich as JavaScript. 2) Python is powerful in data science and machine learning libraries, while JavaScript is better in front-end development libraries and frameworks. 3) Both have rich learning resources, but Python is suitable for starting with official documents, while JavaScript is better with MDNWebDocs. The choice should be based on project needs and personal interests.

From C/C   to JavaScript: How It All WorksFrom C/C to JavaScript: How It All WorksApr 14, 2025 am 12:05 AM

The shift from C/C to JavaScript requires adapting to dynamic typing, garbage collection and asynchronous programming. 1) C/C is a statically typed language that requires manual memory management, while JavaScript is dynamically typed and garbage collection is automatically processed. 2) C/C needs to be compiled into machine code, while JavaScript is an interpreted language. 3) JavaScript introduces concepts such as closures, prototype chains and Promise, which enhances flexibility and asynchronous programming capabilities.

JavaScript Engines: Comparing ImplementationsJavaScript Engines: Comparing ImplementationsApr 13, 2025 am 12:05 AM

Different JavaScript engines have different effects when parsing and executing JavaScript code, because the implementation principles and optimization strategies of each engine differ. 1. Lexical analysis: convert source code into lexical unit. 2. Grammar analysis: Generate an abstract syntax tree. 3. Optimization and compilation: Generate machine code through the JIT compiler. 4. Execute: Run the machine code. V8 engine optimizes through instant compilation and hidden class, SpiderMonkey uses a type inference system, resulting in different performance performance on the same code.

Beyond the Browser: JavaScript in the Real WorldBeyond the Browser: JavaScript in the Real WorldApr 12, 2025 am 12:06 AM

JavaScript's applications in the real world include server-side programming, mobile application development and Internet of Things control: 1. Server-side programming is realized through Node.js, suitable for high concurrent request processing. 2. Mobile application development is carried out through ReactNative and supports cross-platform deployment. 3. Used for IoT device control through Johnny-Five library, suitable for hardware interaction.

Building a Multi-Tenant SaaS Application with Next.js (Backend Integration)Building a Multi-Tenant SaaS Application with Next.js (Backend Integration)Apr 11, 2025 am 08:23 AM

I built a functional multi-tenant SaaS application (an EdTech app) with your everyday tech tool and you can do the same. First, what’s a multi-tenant SaaS application? Multi-tenant SaaS applications let you serve multiple customers from a sing

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

AI Hentai Generator

AI Hentai Generator

Generate AI Hentai for free.

Hot Article

R.E.P.O. Energy Crystals Explained and What They Do (Yellow Crystal)
1 months agoBy尊渡假赌尊渡假赌尊渡假赌
R.E.P.O. Best Graphic Settings
1 months agoBy尊渡假赌尊渡假赌尊渡假赌
Will R.E.P.O. Have Crossplay?
1 months agoBy尊渡假赌尊渡假赌尊渡假赌

Hot Tools

MinGW - Minimalist GNU for Windows

MinGW - Minimalist GNU for Windows

This project is in the process of being migrated to osdn.net/projects/mingw, you can continue to follow us there. MinGW: A native Windows port of the GNU Compiler Collection (GCC), freely distributable import libraries and header files for building native Windows applications; includes extensions to the MSVC runtime to support C99 functionality. All MinGW software can run on 64-bit Windows platforms.

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

WebStorm Mac version

WebStorm Mac version

Useful JavaScript development tools

Dreamweaver Mac version

Dreamweaver Mac version

Visual web development tools

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)