如何在 JavaScript 中运行（类 Python）文档测试？

Question

是否有任何 JavaScript 测试框架提供与 Python 的 doctest 大致等价的功能？

function add(a, b) {
  /**
  Returns the sum of `a` and `b`:

    > add(1, 3)
    4

  Add coerces types to numeric values where possible:

    > add('51' + 3)
    54
  */
  return (a - 0) + (b - 0);
}

Answer 1

我无法理解 Ian Bicking 的软件包 doctestjs 的意义。他只是为我们提供了一种不同的方式来编写普通的外部测试，而不是真正的文档测试。

我使用了很多 python doctests，它们对我来说非常重要，我不知道 doctestjs 有什么用，但我发现了一些用这个项目实现的真正的 doctests：https://github.com/davidchambers/doctest。

即使这不是最流行的 javascript doctest 项目，我也非常喜欢它。

---

更新：自从得到这个答案一年多之后，我有机会为 David Chambers 的项目做出贡献，它写得非常好。我还在使用require.js 的复杂应用程序中使用它，为此我们添加了对 AMD 模块的支持。我认为他也添加了对 Common JS 模块的支持。因此我只能确认我的观点。

Answer 2

不知道我昨天抽了什么。苏里。

doctestjs (doctestjs on github) 是正确的链接，它似乎也在积极开发中。

虽然它与 python doctest 的工作方式略有不同，但使用 doctestjs 您可以在 HTML 文件中声明测试以便运行它们。

但我想应该可以在代码中声明内联测试。然后在构建过程中执行预处理步骤以提取测试并从中自动创建一个 test-html

例如使用 ant 时，我想象一个应用复制文件、replaceregexp、concat。 例如复制 js 文件，替换所有不是评论的内容以及所有看起来不像 doctestjs 测试的 cmets。然后 concat htmlhead+tests+headfooter 完成。