Font Awesome light宏类型错误：Jest单元测试如何mock该函数？

在Jest单元测试中使用Font Awesome 6的图标导入宏时，会因为Jest不支持宏语法抛出TypeError: (0 , import_macro_1.light) is not a function错误，以下是几种可行的mock方案：

方案一：在测试文件中直接Mock模块 #

如果你的light函数是从@fortawesome/fontawesome-svg-core/import.macro导入的，直接在测试文件顶部添加mock代码：

jest.mock('@fortawesome/fontawesome-svg-core/import.macro', () => ({
  // 返回简单模拟值，保证FontAwesomeIcon组件能正常渲染即可
  light: () => 'mock-light-icon',
}));

如果需要验证light函数的调用参数，可改用带jest.fn的版本：

jest.mock('@fortawesome/fontawesome-svg-core/import.macro', () => ({
  light: jest.fn(() => 'mock-light-icon'),
}));

// 在测试用例中断言调用情况
import { light } from '@fortawesome/fontawesome-svg-core/import.macro';

test('正确调用light图标函数', () => {
  // 渲染目标组件
  expect(light).toHaveBeenCalledWith('play');
});

方案二：使用全局Mock文件 #

如果多个测试文件都需要用到这个mock，可在项目根目录创建__mocks__目录，添加对应路径的mock文件：

1. 创建路径：__mocks__/@fortawesome/fontawesome-svg-core/import.macro.js
2. 文件内容：

module.exports = {
  light: (iconName) => `mock-light-${iconName}`,
};

Jest会自动识别并使用这个全局mock，无需在每个测试文件中重复编写代码。

内容的提问来源于stack exchange，提问作者user1162910