---
name: ky
description: Tiny and elegant HTTP client based on the Fetch API for modern browsers, Node.js, Bun, and Deno
metadata:
  author: Generated by Ky Skills Generator
  version: "2026.02.04"
  source: Generated from https://github.com/sindresorhus/ky, scripts located at https://github.com/antfu/skills
---

> 该 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](references/core-usage.md) |
| Core Options | json, searchParams, prefixUrl, timeout, method | [core-options](references/core-options.md) |

## Features

### Retry Mechanism

| Topic | Description | Reference |
|-------|-------------|-----------|
| Automatic Retry | Configurable retry strategies, delays, jitter, custom logic | [feature-retry](references/feature-retry.md) |

### Hooks System

| Topic | Description | Reference |
|-------|-------------|-----------|
| Lifecycle Hooks | beforeRequest, beforeRetry, afterResponse, beforeError hooks | [feature-hooks](references/feature-hooks.md) |

### Instance Management

| Topic | Description | Reference |
|-------|-------------|-----------|
| Custom Instances | ky.create(), ky.extend(), context for hooks | [feature-instances](references/feature-instances.md) |

### Error Handling

| Topic | Description | Reference |
|-------|-------------|-----------|
| Error Types | HTTPError, TimeoutError, ForceRetryError, type guards | [feature-errors](references/feature-errors.md) |

## Advanced

| Topic | Description | Reference |
|-------|-------------|-----------|
| Progress Tracking | Upload and download progress callbacks | [advanced-progress](references/advanced-progress.md) |
| Customization | Custom JSON parsing/stringifying, custom fetch | [advanced-customization](references/advanced-customization.md) |

## Best Practices

| Topic | Description | Reference |
|-------|-------------|-----------|
| Form Data | multipart/form-data, URL-encoded forms, file upload | [best-practices-form-data](references/best-practices-form-data.md) |
| Cancellation | AbortController for request cancellation | [best-practices-cancellation](references/best-practices-cancellation.md) |
| Node.js Features | Proxy support, HTTP/2, environment configuration | [best-practices-nodejs](references/best-practices-nodejs.md) |