How do I cancel a request in Axios?

Use the modern AbortController API by passing a signal in the request config. Axios also supports the deprecated CancelToken, but AbortController is recommended for new projects to avoid legacy issues.

Axios vs fetch: which is better for my project?

Axios is better for complex applications needing interceptors, automatic JSON handling, and cross-platform consistency. Fetch is lighter and built-in, suitable for simple requests where bundle size is critical.

How to handle errors with Axios in async/await?

Wrap axios calls in try-catch blocks; errors include response data, status codes, and config details. Use axios.isAxiosError() to distinguish Axios errors from other exceptions for precise handling.

Can I use Axios with TypeScript without extra setup?

Yes, Axios has built-in TypeScript definitions, providing full type support for requests, responses, and configurations out of the box, including generics for response data typing.

How to upload files using Axios in a browser?

Create a FormData object, append the file, and send it via POST. Axios automatically sets the Content-Type to multipart/form-data when FormData is used, simplifying file upload implementations.

What's the best way to set up authentication interceptors?

Use axios.interceptors.request.use() to add tokens to headers globally. For dynamic tokens, store them in a closure or state and update the interceptor logic as needed for secure API calls.

Open-Awesome

axios

MITJavaScriptv1.17.0

Promise-based HTTP client for making requests in browsers and Node.js with interceptors, cancellation, and automatic JSON handling.

Visit Website GitHub

109.1k stars11.7k forks0 contributors

What is axios?

Axios is a promise-based HTTP client library for JavaScript that allows developers to make HTTP requests from both browser and Node.js environments. It simplifies asynchronous network operations by providing a clean, consistent API with features like interceptors, automatic JSON transformation, and request cancellation. It solves the problem of handling HTTP communications in a standardized, efficient way across different JavaScript runtimes.

Target Audience

JavaScript developers building web applications, REST API clients, or Node.js services that require reliable HTTP communication. It's particularly useful for frontend developers working with frameworks like React, Vue, or Angular, and backend developers needing a robust HTTP client in Node.js.

Value Proposition

Developers choose Axios for its intuitive promise-based API, excellent cross-platform support, and rich feature set including interceptors, automatic JSON handling, and request cancellation. Its widespread adoption, strong community support, and comprehensive documentation make it a reliable, production-ready solution compared to native fetch or other HTTP libraries.

Overview

Promise based HTTP client for the browser and node.js

Use Cases

Best For

Making REST API calls from React, Vue, or Angular applications
Building Node.js services that consume external APIs
Handling authentication tokens globally with request interceptors
Implementing request cancellation for improved user experience
Automatically serializing form data for file uploads
Creating reusable API client instances with custom configurations

Not Ideal For

Performance-critical web applications where minimizing JavaScript bundle size is essential and native fetch meets all requirements
Projects exclusively using server-side runtimes with optimized built-in HTTP clients that don't require browser compatibility
Environments requiring stable, full-featured HTTP/2 or other advanced protocol support beyond Axios's experimental implementations

Pros & Cons

Pros

Cross-Platform Consistency

Provides a unified API for both browser XMLHttpRequests and Node.js HTTP modules, eliminating environment-specific code and simplifying development across stacks.

Advanced Interceptor System

Enables global modification of requests and responses through interceptors, ideal for adding authentication tokens, logging, or error handling across an application.

Automatic Data Handling

Serializes JavaScript objects to JSON and form data automatically, reducing boilerplate code for common API interactions like POST requests with JSON payloads.

Comprehensive Configuration

Offers extensive config options for timeouts, headers, and adapters, with support for custom instances via axios.create() for reusable API client setups.

Cons

Bundle Size Overhead

Adds significant size (around 4KB minified+gzipped) compared to native fetch, which can impact performance in bundle-sensitive applications like PWAs or mobile web apps.

Legacy API Clutter

Maintains deprecated features like CancelToken alongside modern AbortController, leading to confusion and inconsistent codebases as developers transition between APIs.

Unstable Advanced Features

HTTP/2 support is labeled as experimental in the README and may not work consistently across all Node.js versions, limiting its use in production environments requiring HTTP/2.

Frequently Asked Questions

Related Projects

React Query

🤖 Powerful asynchronous state management, server-state utilities and data fetching for the web. TS/JS, React Query, Solid Query, Svelte Query and Vue Query.

Stars49,671

Forks3,872

Last commit23 hours ago

swr

React Hooks for Data Fetching

Stars32,399

Forks1,343

Last commit4 days ago

superagent

Ajax for Node.js and browsers (JS HTTP client). Maintained for @forwardemail, @ladjs, @spamscanner, @breejs, @cabinjs, and @lassjs.

Stars16,648

Forks1,321

Last commit5 months ago

got

🌐 Human-friendly and powerful HTTP request library for Node.js

Stars14,913

Forks989

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub