JavaScript 中怎么 Mock 动态导入 import() 失败场景-js教程-PHP中文网

mock import() 失败需拦截模块加载并让 promise 拒绝：jest 中用 jest.mock() 配合 mockrejectedvalue；非 jest 环境可覆盖 globalthis.import；注意路径匹配、esm 限制及推荐网络层拦截。

javascript 中怎么 mock 动态导入 import() 失败场景

在 JavaScript 单元测试中，Mock import() 失败（即动态导入抛出异常）的关键是拦截模块加载过程，并让 Promise 拒绝。由于 import() 返回的是原生 Promise，不能直接用普通函数替换，需借助测试框架能力或运行时劫持。

使用 Jest 的 jest.mock() 模拟失败

Jest 支持对动态导入目标模块进行自动 mock，但要触发“失败”，需在 mock 实现中主动 throw 错误：

确保被 import 的模块路径可被 Jest 识别（如相对路径或已配置的别名）
调用 jest.mock('./module') 后，用 jest.mocked(...).mockRejectedValue(...) 让其返回拒绝的 Promise
注意：必须在 import() 调用前完成 mock，推荐放在 beforeEach 或测试顶部

示例：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

// utils.js
export const loadData = async () => {
  try {
    const mod = await import('./heavy-module');
    return mod.default();
  } catch (err) {
    return 'fallback';
  }
};

// utils.test.js
import { loadData } from './utils';

// Mock 模块本身（路径必须和 import() 中一致）
jest.mock('./heavy-module');

test('import() 失败时返回 fallback', async () => {
  // 让 mock 模块的默认导出 Promise 拒绝
  const mockImport = jest.requireActual('./heavy-module');
  jest.mocked(import('./heavy-module')).mockRejectedValue(new Error('Network failed'));

  const result = await loadData();
  expect(result).toBe('fallback');
});

手动替换 globalThis.import（适用于非 Jest 环境）

在 Vitest、JSDOM 或自定义测试环境里，可临时覆盖全局 import 函数：

保存原始 import 供后续恢复
用 vi.fn()（Vitest）或 jest.fn() 替换，返回 Promise.reject(...)
注意：该方式会影响所有 import()，建议只在单个测试中作用域内修改并清理

Vitest 示例：

test('import fails with network error', async () => {
  const originalImport = globalThis.import;
  globalThis.import = vi.fn().mockRejectedValue(new TypeError('Failed to fetch'));

  await expect(async () => {
    await import('./missing.js');
  }).rejects.toThrow('Failed to fetch');

  // 恢复原始 import（可选，vi.resetMocks() 通常已处理）
  globalThis.import = originalImport;
});

避免常见陷阱

路径必须完全匹配：jest.mock('./a') 不会拦截 import('./a.js')（.js 后缀影响解析）
不能 mock 未声明的模块：若 import() 路径含变量（如 import(`./${name}.js`)），Jest 无法静态分析，需改用全局 import 替换
ESM 环境限制：Node.js 原生 ESM 不允许重写 import，此时只能通过构建时插件（如 vite-plugin-mock-import）或改用 CommonJS 测试环境