sindresorhus/got
Got
Got is a promise-based HTTP request library for Node.js that supports HTTP/2 and streaming. It provides a system for making network requests with a focus on asynchronous control flow and type-safe API client development.
The library is distinguished by its middleware-based request lifecycle, which uses interceptors and plugins to modify request options and response data. It includes a configurable automatic retry mechanism with backoff strategies, a built-in HTTP response cache, and a cookie-jar system for maintaining persistent sessions.
Broad capabilities cover data handling through duplex streaming and automated API pagination, as well as network configuration including custom DNS resolution and Unix domain socket support. Security is handled via basic authentication and client SSL certificates, while request lifecycle management includes signal-based cancellation and diagnostic channel monitoring for observability.
Features
- Promise-Based HTTP Clients - Provides a promise-based API for sending network requests with support for HTTP/2 and streaming.
- Node.js Network Libraries - A high-performance promise-based HTTP request library specifically optimized for the Node.js runtime environment.
- Memory-Efficient Streaming - Processes request and response bodies as duplex streams to handle large datasets without memory exhaustion.
- Middleware-Based Request Pipelines - Provides modular chains of pluggable components that intercept and modify network requests and responses.
- Request Payloads - Supports transmitting request payloads via strings, buffers, streams, or generators with automatic length calculation.
- Body Parsers - Processes response data as text, JSON, or raw buffers with support for custom encodings.
- JSON Serialization - Provides built-in support for serializing objects to JSON for requests and parsing response bodies.
- Network Data Streaming - Handles network data as a duplex stream to pipe request bodies or stream responses efficiently.
- Client Instance Defaults - Supports creating pre-configured request instances with shared base URLs, headers, and authentication settings.
- Promise-Based Flow Control - Wraps network operations in promises to handle asynchronous request-response cycles with linear control flow.
- Client Session Persistence - Maintains client-level state, cookies, and connection settings across multiple requests.
- Cookie Management - Automates the storage, retrieval, and transmission of session cookies across network requests via a cookie jar.
- Retry Strategies - Implements configurable retry strategies with backoff policies for network operations.
- Hook-Based Plugin Systems - Allows extending core functionality by registering custom logic into lifecycle events and interceptors.
- Payload Streaming - Processes large request and response bodies as duplex streams to minimize memory consumption.
- HTTP Request Interceptors - Implements a middleware-based system for intercepting and modifying outgoing HTTP requests.
- Request Interception Middleware - Provides a middleware system for intercepting and modifying network requests and responses globally.
- Request Lifecycle Hooks - Implements lifecycle hooks to execute custom functions at specific stages of the request process.
- Type-Safe API Clients - Enables wrapping network requests in typed classes to ensure response bodies and options adhere to specific schemas.
- API Response Caching - Includes a built-in HTTP response cache for retrieving previously fetched API responses.
- Request Retries - Automatically resends failed requests using configurable backoff strategies based on error types.
- Stream Retries - Resets data streams and restarts requests automatically when network errors occur during streaming.
- Request Timeout Configurations - Provides precise timeout configurations for different request stages to prevent hanging connections.
- Redirection Managers - Provides tools for tracking and controlling automatic HTTP location following behavior and redirect limits.
- Request Configurations - Allows the definition of shared configurations and base settings to be reused across multiple requests.
- Cookie Management - Provides a cookie jar system for automatically storing and sending cookies across network requests.
- DNS Resolution - Allows for customizable DNS server, caching, and filtering configurations to control IP resolution.
- Network Connectivity Configurations - Provides controls for DNS resolution logic and IP versioning for managing remote server connections.
- Request Cancellations - Enables termination of active network operations using signals to release system resources.
- Network Request Tools - Provides utilities for configuring and executing network requests with complex workflows and retries.
- Request Header Configuration - Provides capabilities to set custom HTTP headers and copy headers from piped streams.
- Unix Domain Socket Support - Allows communicating with local services using Unix Domain Sockets instead of traditional TCP/IP networking.
- HTTP Request Caching - Implements an HTTP response caching system to reduce redundant network requests.
- Automated Retry Strategies - Provides an automatic retry mechanism with configurable backoff strategies to recover from transient network errors.
- API Pagination - Implements a mechanism for retrieving multiple pages of API results by following links or updating parameters.
- Response Streaming - Implements incremental delivery of large HTTP response bodies to optimize memory usage.
- REST APIs - Facilitates programmatic interaction with REST web services using standard HTTP methods and JSON payloads.
- 开发工具 - Simplified HTTP request library.
- HTTP Clients - Human-friendly, feature-rich HTTP request library.
