make-fetch-happen 使用教程

make-fetch-happen 使用教程

make-fetch-happen making fetch happen for npm 项目地址: https://gitcode.com/gh_mirrors/mak/make-fetch-happen

1. 项目介绍

make-fetch-happen 是一个基于 Node.js 的库，它封装了 minipass-fetch 并添加了一些额外的特性，如 HTTP 缓存支持、请求池、代理、重试等。这个库旨在提供一个强大且易于使用的网络请求工具，特别适用于需要缓存和重试功能的场景。

2. 项目快速启动

在开始使用 make-fetch-happen 之前，请确保您的系统中已安装了 Node.js。

安装

通过 npm 安装 make-fetch-happen：

npm install --save make-fetch-happen

使用示例

以下是一个简单的使用 make-fetch-happen 发起网络请求并缓存结果的示例：

const fetch = require('make-fetch-happen').defaults({
  cachePath: './my-cache' // 设置缓存路径
});

fetch('https://registry.npmjs.org/make-fetch-happen')
  .then(res => res.json())
  .then(body => {
    console.log(`got ${body.name} from web`);
    return fetch('https://registry.npmjs.org/make-fetch-happen', {
      cache: 'no-cache' // 强制发起新的请求
    });
  })
  .then(res => {
    console.log(res.status); // 200 或 304，取决于缓存
    return res.json();
  })
  .then(body => {
    console.log(`got ${body.name} from cache`);
  })
  .catch(err => {
    console.error('Request failed:', err);
  });

3. 应用案例和最佳实践

缓存策略

使用 make-fetch-happen 可以很容易地实现缓存策略。例如，您可以在请求中设置 cache 选项为 'only-if-cached' 来实现离线模式，这样当设备处于离线状态时，如果缓存中有数据，就会直接使用缓存数据。

重试机制

make-fetch-happen 支持自动重试请求。通过设置 retry 选项，可以定义重试的最大次数和重试的条件。

fetch('https://example.com/data', {
  retry: {
    retries: 3, // 最大重试次数
    onRetry: (err, attempt) => {
      console.log(` retry ${attempt}`);
    }
  }
});

4. 典型生态项目

make-fetch-happen 可以与多个生态项目配合使用，例如：

• 使用 axios 替代内置的 fetch API，以便在 Node.js 和浏览器环境中提供一致的网络请求功能。
• 结合 puppeteer 或 selenium 实现自动化测试和爬虫功能。
• 集成 webpack 或 rollup 等打包工具，优化项目结构和性能。

通过以上介绍，您可以开始使用 make-fetch-happen 并探索其在各种场景下的应用潜力。

make-fetch-happen making fetch happen for npm 项目地址: https://gitcode.com/gh_mirrors/mak/make-fetch-happen