在jsdom中自定义fetch实现的方法

2025-05-10 12:22:31作者：温艾琴Wonderful

jsdom

项目地址：https://gitcode.com/gh_mirrors/jsd/jsdom

jsdom是一个流行的Node.js库，它实现了Web标准的许多功能，包括DOM、HTML解析等。在实际使用中，开发者有时需要自定义fetch行为来满足测试需求。本文将详细介绍如何在jsdom中实现自定义fetch功能。

jsdom中的网络请求实现现状

jsdom默认实现了XMLHttpRequest接口，但并未原生实现fetch API。这意味着在jsdom环境中：

XMLHttpRequest可以直接使用
fetch默认是undefined状态

这种设计给了开发者更大的灵活性，可以根据需要自行实现或模拟fetch行为。

自定义fetch的实现方法

在jsdom中自定义fetch非常简单，只需直接覆盖window对象的fetch属性即可：

const { JSDOM } = require('jsdom');

// 创建自定义fetch实现
const customFetch = (url, options) => {
  if (url === 'https://api.example.com/data') {
    return Promise.resolve({
      json: () => Promise.resolve({ data: 'mock response' }),
      status: 200
    });
  }
  return Promise.reject(new Error('Not found'));
};

// 创建jsdom实例并覆盖fetch
const dom = new JSDOM(`<!DOCTYPE html><p>Hello world</p>`, {
  runScripts: "dangerously"
});

// 设置自定义fetch
dom.window.fetch = customFetch;

高级应用场景

并发测试支持

对于需要并发运行的测试场景，可以为每个jsdom实例创建独立的fetch模拟器：

function createMockEnvironment() {
  const dom = new JSDOM(``, { runScripts: "dangerously" });
  
  // 每个实例有独立的mock状态
  const mockState = {
    calls: 0
  };
  
  dom.window.fetch = (url) => {
    mockState.calls++;
    return Promise.resolve({
      json: () => Promise.resolve({ callCount: mockState.calls }),
      status: 200
    });
  };
  
  return dom;
}

完整的Response对象模拟

如果需要更真实的模拟，可以创建完整的Response对象：

dom.window.fetch = (url) => {
  const response = new dom.window.Response(JSON.stringify({ data: 'test' }), {
    status: 200,
    headers: {
      'Content-type': 'application/json'
    }
  });
  return Promise.resolve(response);
};