FetchRequestor

基于 Fetch API 的请求器实现。

安装

npm install @ureq/core @ureq/impl-fetch

基础用法

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

const request = new Request(new FetchRequestor());

配置选项

FetchRequestorConfig

interface FetchRequestorConfig {
  baseURL?: string;
  headers?: Record<string, string>;
  timeout?: number;
}

baseURL

API 基础 URL。

const requestor = new FetchRequestor({
  baseURL: 'https://jsonplaceholder.typicode.com/todos/1'
});

headers

默认请求头。

const requestor = new FetchRequestor({
  headers: {
    'Content-Type': 'application/json',
    'X-Custom-Header': 'value'
  }
});

timeout

请求超时时间（毫秒）。

const requestor = new FetchRequestor({
  timeout: 5000  // 5 秒超时
});

响应类型

支持多种响应类型，通过 responseType 选项指定：

// JSON（默认）
const jsonRes = await request.get<User>('/api/user/1');

// 文本
const textRes = await request.get<string>('/robots.txt', {
  responseType: 'text',
});

// Blob
const blobRes = await request.get<Blob>('/api/image.png', {
  responseType: 'blob',
});

// ArrayBuffer
const bufferRes = await request.get<ArrayBuffer>('/api/file', {
  responseType: 'arraybuffer',
});

// FormData
const formRes = await request.get<FormData>('/api/form', {
  responseType: 'formData',
});

自定义响应转换

使用 responseTransformer 自定义响应解析：

const res = await request.get<User>('/api/user/1', {
  responseTransformer: async (response: Response) => {
    const json = await response.json();
    return json.data.user;
  },
});

详细用法请参考 响应类型与转换。

完整示例

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

const request = new Request(
  new FetchRequestor({
    baseURL: 'https://jsonplaceholder.typicode.com/todos/1',
    headers: {
      'Content-Type': 'application/json'
    },
    timeout: 10000
  }),
  {
    retry: { maxRetries: 3 },
    cache: { ttl: 60000 }
  }
);

// 使用
const users = await request.get('/users');

特性

• ✅ 轻量级，无额外依赖
• ✅ 支持现代浏览器和 Node.js 18+
• ✅ 原生 Promise 支持
• ✅ 支持 AbortController
• ✅ 完整的 TypeScript 类型
• ✅ 多种响应类型支持
• ✅ 自定义响应转换器

浏览器兼容性

• Chrome 42+
• Firefox 39+
• Safari 10.1+
• Edge 14+
• Node.js 18+

相关

• AxiosRequestor
• Requestor API
• 响应类型与转换
• 快速开始