sindresorhus/ky

Features

• Fetch-Based HTTP Clients - An HTTP client built on the Fetch API that simplifies requests with automatic error handling and retry logic.
• Fetch API Wrappers - Wraps the native Fetch API with a cleaner interface, adding automatic error handling and retry logic.
• Request Retries - Automatically retries failed requests with configurable limits, delays, backoff, and jitter.
• Automatic Retry Clients - Automatically retries failed requests with configurable limits, delays, and jitter.
• Configurable Retry Engines - Provides automatic retry of failed HTTP requests with configurable limits, delays, backoff, and jitter.
• Configurable Retry Engines - Ky controls retry behavior with configurable limits, status codes, delays, jitter, and timeout handling to automatically retry failed requests.
• HTTP Client Libraries - An HTTP client library built on the Fetch API for making requests with retries, timeouts, and error handling.
• Request Cancellations - Leverages the standard AbortController API to cancel in-flight HTTP requests.
• Client Instance Defaults - Builds reusable Ky instances with custom defaults supporting inheritance and option replacement.
• HTTP Lifecycle Hooks - Allows request and response interception through lifecycle hooks for customization and authentication.
• HTTP Retry Engines - Implements automatic retries with configurable limits, status codes, delays, jitter, and timeout handling.
• Per-Attempt Timeouts - Applies per-attempt and total timeouts to requests, throwing a timeout error if the limit is exceeded.
• Lightweight HTTP Clients - A minimal HTTP client for making requests with JSON handling, timeouts, and configurable retries.
• Pre-Configured HTTP Clients - Creates reusable HTTP clients with custom defaults using extend or create.
• HTTP Client Requests - Ky makes HTTP requests with a clean API, automatic error handling, retries, and timeouts for web and Node.js applications.
• HTTP Error Handling - Ky controls how non-2xx status codes are handled with selective error throwing and retry logic for failed requests.
• Request Cancellation - Ky aborts an in-flight request using the AbortController API, throwing an AbortError.
• Request Lifecycle Hooks - Exposes hooks at initialization, before request, before retry, before error, and after response stages.
• Base URL Mappers - Resolves relative request URLs against a specified base URL to simplify API endpoint configuration.
• Standard Schema Validators - Validates JSON response bodies against Standard Schema libraries like Zod, throwing a validation error on mismatch.
• JSON Request Serializers - Ky automatically serializes JavaScript objects to JSON and sets the appropriate Content-Type header for request bodies.
• Hook-Triggered Retries - Ky triggers a retry from an afterResponse hook based on response content, even for successful status codes.
• Bidirectional Progress Tracking - Ky reports progress of data transfer with percentage, bytes transferred, and chunk data for both uploads and downloads.
• Automatic Token Refreshes - Refreshes expired authentication tokens by intercepting 401 responses and retrying requests with fresh credentials.
• Hook-Based Token Refreshes - Retries requests with fresh authentication tokens when a 401 response is received, using before-retry hooks.
• Response Schema Validators - Validates JSON response bodies against a schema, throwing an error on mismatch.
• Fetch Function Mocking - Replaces the fetch function with a custom implementation to return predefined responses without network calls.
• AbortController-Based Clients - Uses the standard AbortController API for consistent request cancellation across environments.
• Schema-Based Response Validation - Parses JSON responses and validates them against a schema, throwing an error on mismatch.
• Standard Schema Response Validators - Validates JSON response bodies against Standard Schema libraries like Zod, throwing an error on mismatch.
• Fetch Overrides - Allows replacement of the default fetch implementation with a custom one for mocking or instrumentation.
• Custom Fetch Implementations - Provides a mechanism to replace the default fetch function for testing and instrumentation purposes.
• Form Data Submission - Ky submits FormData or URLSearchParams as request bodies, automatically setting the appropriate Content-Type header.
• Selective Status Code Filtering - Ky controls whether non-2xx status codes throw an error, with optional per-status-code filtering.
• Query Parameter Mergers - Ky merges query parameters into request URLs, combining them with any existing parameters already present in the input URL.
• General Utilities - Lightweight HTTP client based on Fetch API.

Star 历史