如何用Jest.js测试导入函数的内部闭包函数是否被调用？

我太懂这种明明问题看似简单却卡半天的感觉了！闭包里的私有函数确实是Jest测试中的一个常见坑——因为spyOn本质上需要能拿到要监听的函数的外部引用，而闭包把内部函数完全封装在了外部函数的作用域里，外部根本碰不到它，直接用spyOn当然没用。

为什么spyOn在这里失效？ #

jest.spyOn(obj, methodName)的工作逻辑是替换对象上的某个方法并监听调用，但闭包内部的函数既不属于任何全局对象，也没有被导出到外部作用域，所以你根本找不到一个能传给spyOn的合法引用。

可行的解决方案 #

1. 重构代码，给内部函数一个可访问的引用 #

如果你的代码结构允许调整，最简单的方式就是把内部函数暴露出来——不用对外公开，只要测试能拿到就行。比如：

// 原闭包代码（无法直接测试innerFunction）
function outerFunction() {
  function innerFunction() {
    console.log("内部函数被调用了");
  }
  innerFunction();
}

// 重构后：把内部函数挂载到外部函数的属性上（仅测试环境暴露）
function outerFunction() {
  function innerFunction() {
    console.log("内部函数被调用了");
  }
  // 生产环境会自动忽略这段代码
  if (process.env.NODE_ENV === "test") {
    outerFunction._innerFunction = innerFunction;
  }
  innerFunction();
}

// 测试代码
test("调用外部函数时内部函数会被执行", () => {
  // 监听暴露出来的内部函数
  const innerSpy = jest.spyOn(outerFunction, "_innerFunction");
  outerFunction();
  expect(innerSpy).toHaveBeenCalled();
  // 测试完清除spy，避免影响其他测试用例
  innerSpy.mockRestore();
});

如果是ES模块，也可以用私有导出的方式（用下划线标记私有，不对外文档化）：

// myModule.js
// 私有导出，仅用于测试
export function _innerFunction() {
  console.log("内部函数被调用了");
}

export function outerFunction() {
  _innerFunction();
}

// 测试文件
import * as myModule from "./myModule";

test("外部函数触发内部函数执行", () => {
  const spy = jest.spyOn(myModule, "_innerFunction");
  myModule.outerFunction();
  expect(spy).toHaveBeenCalled();
});

2. 测试内部函数的副作用（不修改原代码） #

如果完全不能改动原代码结构，那可以换个思路：不去直接测试内部函数是否被调用，而是测试它执行后产生的可观测副作用。比如内部函数是否调用了某个外部API、是否修改了某个全局变量、是否更新了DOM等等。

举个例子，如果内部函数调用了外部工具函数：

// 原代码
import utils from "./utils";

function outerFunction() {
  function innerFunction() {
    utils.log("内部函数执行");
  }
  innerFunction();
}

// 测试代码
import * as utils from "./utils";

test("内部函数会调用utils.log", () => {
  // 监听外部工具函数的调用
  const logSpy = jest.spyOn(utils, "log");
  outerFunction();
  expect(logSpy).toHaveBeenCalledWith("内部函数执行");
});

3. 用Babel插件访问私有函数（终极方案） #

如果上面两种方法都不适用，还可以用babel-plugin-rewire这类工具，它能让你在测试中访问模块内部的私有变量和函数。不过这种方法属于“黑魔法”，尽量少用——它会依赖编译工具，而且破坏了代码的封装性。

配置好插件后，测试代码可以这样写：

import { outerFunction } from "./myModule";

test("测试内部函数调用", () => {
  // 获取内部函数的引用
  const innerFunction = outerFunction.__get__("innerFunction");
  const spy = jest.fn(innerFunction);
  // 替换原内部函数为spy
  outerFunction.__set__("innerFunction", spy);
  
  outerFunction();
  expect(spy).toHaveBeenCalled();
  
  // 测试完恢复原函数
  outerFunction.__set__("innerFunction", innerFunction);
});

总结 #

闭包内部函数的测试核心难点就是外部无法获取引用，所以优先推荐重构代码让测试能拿到引用（这也是写出测试友好代码的好习惯），其次通过副作用间接测试，最后才考虑用工具突破封装。

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