ConfigsApr 11, 2026·1 min read

axios — Promise-Based HTTP Client for Browser & Node.js

axios is the most popular HTTP client for JavaScript — promise-based, isomorphic (browser + Node), with request/response interceptors, automatic JSON transforms, CSRF protection, and built-in cancellation. Battle-tested since 2014.

AI
AI Open Source · Community
Quick Use

Use it first, then decide how deep to go

This block should tell both the user and the agent what to copy, install, and apply first.

npm i axios
import axios from "axios";

// GET
const { data } = await axios.get("https://api.github.com/users/williamwangai");

// POST with JSON body
await axios.post("/api/users", { name: "William", email: "w@example.com" });

// Create instance with defaults
const api = axios.create({
  baseURL: "https://api.tokrepo.com",
  headers: { Authorization: `Bearer ${token}` },
  timeout: 10000,
});

api.interceptors.response.use(
  (res) => res,
  (err) => {
    if (err.response?.status === 401) location.href = "/login";
    return Promise.reject(err);
  }
);
Intro

axios is the most popular HTTP client for JavaScript — promise-based, isomorphic (works in browser and Node.js with the same API), battle-tested since 2014. Despite the modern fetch() API being available everywhere, axios still ships in 100M+ weekly npm installs for its superior DX.

What axios Does

  • Promise API — async/await friendly
  • Isomorphic — same code browser + Node.js
  • Interceptors — transform requests/responses globally
  • Auto JSON — serializes request body, parses response
  • Timeouts — timeout option
  • Cancellation — AbortController support
  • Progress events — upload/download progress
  • XSRF protection — cookie-based CSRF token
  • Instance config — axios.create({ baseURL, headers })

Architecture

Wraps XMLHttpRequest in browsers and http/https modules in Node.js. Request goes through interceptor chain → adapter → transformer → promise. Error is a normal rejected promise with err.response/err.request for inspection.

Self-Hosting

Client library only.

Key Features

  • Isomorphic (browser + Node)
  • Request/response interceptors
  • Automatic JSON transforms
  • Form data & multipart support
  • Streaming in Node.js
  • Cancellation via AbortController
  • Progress events (uploads)
  • TypeScript types built in
  • AbortController and signal support

Comparison

Client Isomorphic Interceptors Auto JSON Bundle
axios Yes Yes Yes ~14KB
fetch Yes (modern) No (manual) No (manual) 0
ky Yes (modern) Yes Yes ~5KB
ofetch Yes Limited Yes ~4KB
got Node only Yes Yes ~40KB

常见问题 FAQ

Q: fetch 已经够用了，为什么还要 axios？ A: fetch 不自动 JSON parse、不自动 throw HTTP 错误、没有 interceptors、Node 老版本不支持。axios 开箱即用省时。

Q: 如何取消请求？ A: const controller = new AbortController(); axios.get(url, { signal: controller.signal }); controller.abort();

Q: 怎么处理 CSRF？ A: axios 默认读 XSRF-TOKEN cookie 并放到 X-XSRF-TOKEN header，配合 Rails/Laravel 的 CSRF 机制。

来源与致谢 Sources

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Socket.IO — Bidirectional Realtime Event-Based Communication

Socket.IO is a library that enables low-latency, bidirectional, event-based communication between a client and server. Built on WebSocket with fallbacks, automatic reconnection, room-based broadcast, and first-class Node.js support.

AI Open Source

Lucide — Beautiful & Consistent Icon Toolkit

Lucide is a beautiful and consistent icon toolkit made by the community — a fork of Feather Icons with 1500+ crisp, minimalist SVG icons. First-class React, Vue, Svelte, Solid, Angular, and Web Component libraries.

AI Open Source

Chakra UI — Accessible Component System for React

Chakra UI is a simple, modular, and accessible component system for building React applications. Every component follows WAI-ARIA guidelines with dark mode support out of the box and a themeable design token system.

AI Open Source
◈Home🔍Search👤Me