ky
Original：🇺🇸 English
Translated
Tiny and elegant HTTP client based on the Fetch API for modern browsers, Node.js, Bun, and Deno
1installs
Sourceono500/infra-ai
Added on
NPX Install
npx skill4agent add ono500/infra-ai kyTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →该 skill 基于 Ky v1.14.3，生成于 2026-02-04。
Ky is a tiny and elegant HTTP client based on the Fetch API. It provides a simpler and more powerful API than plain fetch with no dependencies, targeting modern browsers, Node.js 18+, Bun, and Deno.
Core References
| Topic | Description | Reference |
|---|---|---|
| Basic Usage | HTTP method shortcuts, response body methods, TypeScript support | core-usage |
| Core Options | json, searchParams, prefixUrl, timeout, method | core-options |
Features
Retry Mechanism
| Topic | Description | Reference |
|---|---|---|
| Automatic Retry | Configurable retry strategies, delays, jitter, custom logic | feature-retry |
Hooks System
| Topic | Description | Reference |
|---|---|---|
| Lifecycle Hooks | beforeRequest, beforeRetry, afterResponse, beforeError hooks | feature-hooks |
Instance Management
| Topic | Description | Reference |
|---|---|---|
| Custom Instances | ky.create(), ky.extend(), context for hooks | feature-instances |
Error Handling
| Topic | Description | Reference |
|---|---|---|
| Error Types | HTTPError, TimeoutError, ForceRetryError, type guards | feature-errors |
Advanced
| Topic | Description | Reference |
|---|---|---|
| Progress Tracking | Upload and download progress callbacks | advanced-progress |
| Customization | Custom JSON parsing/stringifying, custom fetch | advanced-customization |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| Form Data | multipart/form-data, URL-encoded forms, file upload | best-practices-form-data |
| Cancellation | AbortController for request cancellation | best-practices-cancellation |
| Node.js Features | Proxy support, HTTP/2, environment configuration | best-practices-nodejs |