@ureq

Appearance

@ureqUniversal Request Library

模块化、可扩展的现代 HTTP 请求库 | A modern, modular, and extensible HTTP request library

快速开始 | Get Started
查看示例 | View Examples
GitHub
@ureq logo
🎯

多种实现 | Multiple Implementations

支持 Fetch 和 Axios 两种实现，可根据需求自由切换。Supports both Fetch and Axios implementations, switch freely based on your needs.

🔄

智能重试 | Smart Retry

内置指数退避重试策略，自动处理临时性错误。Built-in exponential backoff retry strategy, automatically handles transient errors.

💾

请求缓存 | Request Caching

支持内存缓存和自定义存储，提升应用性能。Supports memory cache and custom storage for better performance.

🚦

拦截器 | Interceptors

灵活的请求和响应拦截器，轻松实现认证、日志等功能。Flexible request and response interceptors for auth, logging, and more.

⚡

并发控制 | Concurrency Control

智能管理并发请求数量，避免资源耗尽。Intelligently manages concurrent requests to avoid resource exhaustion.

🔒

幂等性保证 | Idempotency

自动去重相同请求，防止重复提交。Automatically deduplicates identical requests to prevent duplicate submissions.

⏱️

超时控制 | Timeout Control

灵活的超时配置，避免请求长时间挂起。Flexible timeout configuration to avoid long-hanging requests.

🛡️

错误处理 | Error Handling

完善的错误类型和处理机制，便于调试和监控。Comprehensive error types and handling for easy debugging and monitoring.

📝

TypeScript | TypeScript

完整的类型定义，提供出色的开发体验。Full type definitions for excellent developer experience.

快速安装 | Quick Installation ​

bash
npm install @ureq/core @ureq/impl-fetch
bash
pnpm add @ureq/core @ureq/impl-fetch
bash
yarn add @ureq/core @ureq/impl-fetch

简单示例 | Simple Example ​

typescript
import { Request } from '@ureq/core';
import { FetchRequestor } from '@ureq/impl-fetch';

// 创建请求实例
const request = new Request(new FetchRequestor({
  baseURL: 'https://api.example.com'
}));

// 发起请求
const data = await request.get('/users/1');
console.log(data);

为什么选择 @ureq? | Why @ureq? ​

🎨 模块化设计 ​

核心功能与具体实现分离，按需引入所需模块，保持应用轻量。

🔧 高度可扩展 ​

轻松添加自定义请求器、拦截器和功能模块。

🚀 开箱即用 ​

内置常用功能如重试、缓存、超时等，无需额外配置。

💪 类型安全 ​

完整的 TypeScript 支持，享受智能提示和类型检查。

Released under the MIT License.

Copyright © 2024-present @ureq