Jest: 文档和示例中的不一致

创建于 2017-04-09  ·  3评论  ·  资料来源: facebook/jest

PR #3172 更新了文档以包含新的.resolves.rejects关键字,用于在 Promise 上运行断言。

我注意到这个 PR 在https://github.com/facebook/jest/blob/master/docs/TutorialAsync.md的更新错误处理部分引入了一些不一致的地方

screen shot 2017-04-09 at 09 11 46

  1. 测试顶部的注释仍然引用try-catch ,这与代码片段中包含的代码不一致。
  2. PR 仅显示了.rejects的示例,该示例仅在 Jest 20+ 中可用。 这应该在文档中提到以避免混淆。
  3. 使用旧版本 Jest 的人将无法使用此文档。 我认为我们应该为使用 Jest 19 及以下版本的人添加关于使用try-catch来捕获 Promise 拒绝(在 PR #3172 中删除)的解释。 这可以使用.rejects与当前文档一起存在。
  4. 该示例中包含的链接examples/async链接测试像例子这样。 这些示例仍然使用try-catch机制,这与文档中当前包含的代码示例不一致。 这是我们应该在文档的这一部分重新添加使用try-catch的解释的另一个原因。

最有用的评论

我不确定 jest 20 何时会发布,但我希望很快:)

所有3条评论

是否可以为这些新关键字试用 jest 20.0.0+?

我不确定 jest 20 何时会发布,但我希望很快:)

我认为现在已通过 #3201 解决了这个问题。 如果您认为我们可以在这里做更多事情,请发送 PR :)

此页面是否有帮助?
0 / 5 - 0 等级