mzabriskie/axios
Axios
Axios is a promise-based HTTP client used to make asynchronous network requests in both browser and Node.js environments. It functions as a multi-environment network adapter that abstracts the transport layer to ensure consistent behavior across different runtimes.
The project distinguishes itself through a request lifecycle management system that allows for the cancellation of active requests, the setting of timeouts, and the monitoring of upload and download transfer progress. It includes a mechanism for intercepting network traffic, enabling the transformation of outgoing requests and incoming responses through a pipeline of functions.
The library covers broad capability areas including data serialization for JSON and multipart form submissions, unified HTTP error handling with custom status code validation, and the creation of reusable request instances with predefined configurations. Security and traffic management features include CSRF protection, response body size limits, and transfer rate throttling.
Features
- Asynchronous HTTP Clients - Provides a promise-based interface for making asynchronous HTTP requests across browser and Node.js environments.
- Promise-Based HTTP Clients - Functions as a promise-based HTTP client for asynchronous network communication in browser and Node.js environments.
- Data Serialization - Implements automatic serialization of JavaScript objects into JSON, multipart form data, or URL-encoded formats for transmission.
- Application-Level Traffic Interception - Runs custom logic to transform requests or responses before they reach the application logic.
- HTTP Abstraction Layers - Provides an abstraction layer that unifies network requests across different JavaScript runtimes.
- HTTP Request Dispatchers - Executes asynchronous HTTP requests to remote servers across browser and Node.js environments.
- Network Adapters - Abstracts the transport layer to switch between different network implementations like XHR and Node.js HTTP modules.
- Application-Level Request Interceptors - Allows running custom logic to transform outgoing requests and incoming responses through a pipeline of functions.
- Client Instance Defaults - Allows the creation of reusable client instances with shared base URLs and default headers.
- HTTP Client Instance Configuration - Enables the generation of reusable client instances with predefined base URLs and custom headers.
- HTTP Error Normalization - Normalizes various network failures and HTTP status codes into a structured error object for consistent handling.
- HTTP Client Requests - Provides a comprehensive interface for sending asynchronous HTTP requests and receiving responses.
- HTTP Error Handling - Rejects requests based on status codes and provides detailed error objects for debugging.
- HTTP Request Interceptors - Provides middleware hooks to modify, log, or authenticate outgoing HTTP requests and incoming responses.
- Request Lifecycle Managers - Implements a system to manage the progression of network traffic, including timeouts, cancellations, and progress monitoring.
- Request-Response Interceptors - Implements a pipeline of interceptors to transform outgoing requests and incoming responses.
- Payload Serialization - Automatically serializes JavaScript objects into JSON or multipart form data for transmission.
- Query Parameter Encoders - Recursively converts JavaScript objects into URL-encoded query strings for API requests.
- Request Cancellations - Provides mechanisms to abort active network requests and free up system resources.
- Bidirectional Progress Tracking - Monitors both upload and download progress to provide real-time bytes transferred and completion percentages.
- Request Timeouts - Allows setting a maximum duration for requests to prevent hanging connections.
- Client Default Configurations - Allows defining global base URLs, timeouts, and headers for reusable request instances.
- API Response Transformations - Provides mechanisms to transform raw server response data before it reaches the application logic.
- HTTP Header Manipulators - Offers a map-like interface to set, get, and merge HTTP request and response headers.
- Multipart Uploads - Provides client-side encoding for multipart/form-data bodies to support file uploads and complex form submissions.
- Request Data Transformation - Allows modifying request payloads and headers through interceptors before transmission.
- Response Validation - Allows users to define custom validation functions to determine which HTTP status codes resolve as successful.
- URL Encoding Libraries - Converts JavaScript objects into URL-encoded strings for submission as request payloads.
- HTTP Clients - Promise-based HTTP client for the browser and Node.
- Ajax模块 - Listed in the “Ajax模块” section of the Awesome Frontend awesome list.
