写了一本开源小书《Jest 实践指南》

2022-05-20 09:35:27 +08:00
 Haixiang

哈喽,大家好,我是海怪。

前段时间一直在给公司项目引入 Jest ,这过程中学到了不少东西,也查了很多相关资料。最后编写了一本小书《 Jest 实践指南》, 希望能帮助到想了解和学习前端测试的朋友。

测试难点

Jest 看似很简单,就像很多博客写的那样:

expect(sum(1, 1)).toEqual(2)

然而在真实业务中,写出一个好测试的难度并不低。我总结了一下写测试的几个难点:

不会配置。 Jest 的上手文档非常简单,甚至不需要配置。但真实情况是只要一个配置没配好,所有测试都跑不起来。测试不像开发,代码有问题可以慢慢调, 而是一个 0 - 1 游戏,不是成功就是失败,挫败感非常强。

不知道要怎么 Mock 。 这个绝对是经典中的经典。虽然官方文档有教程,但是真实的业务往往不是那么理想,远比文档要复杂得多。

不会构造测试用例。 刚接触测试时,很容易把做业务那套 “实现 XXX 功能” 的想法代入测试。但测试的重点不在于实现功能,而是构造用例。

没有测试策略。 上面是 “技” 的难点,测试还有 “术” 的难点。闷着头肝测试并不高效,使用合适的测试策略远比写 10 个测试用例重要。

上面这些问题很容易让人写出难以维护和复杂的测试。只要业务一改,不仅要维护业务代码还要维护测试代码。 这时,你不禁感叹:“测试真浪费时间”,最终放弃写测试,直接开摆。

好的测试会让你获得很高的代码信心,而不好的测试则会严重拖垮项目开发。所以,大家所厌恶的不应该是测试本身,而是那些维护性差的测试。

社区现状

目前国内关于前端测试的内容非常糟糕,在我查找资料过程中就没有一次是不坎坷的。首先是 Jest 的官网就不给力:

先不说翻译的正确性如何,单看这中文的内容就让人没有想看下去的欲望,真希望 Jest 能找稍微专业一点的人来做翻译。 由于官网的中文翻译做的实在太烂,遇到问题几乎在中文社区是找不到的。

再来说国内关于测试的文章,我总结有三类:

  1. 入门类。 安装 Jest ,外加 expect(1 + 1).toEqual(2) 小例子
  2. API 说明书类。 类似于把 Jest 官网抄了一遍
  3. 理论类。 详细说了测试是什么、为什么、测试理论等,但最重要的 “怎么做” 没有说

不是说这些文章不好,只是这些文章大多数停留在最初级,看完还是不会怎么写测试。就现状来看国内测试社区是有进步的,至少有不少人在写第三类了,要知道以前基本只有第一类文章。

教程诞生

终于,我看到了 React Testing Library 作者 Kent C. Dodds 的 博客

他写了很多关于测试思路的文章,每一篇都非常精彩。受他的启发,我觉得有必要把这些思想和技巧分享出来,最终形成了这本小书。这本小书要解决的就是 “怎么做” 这一步。

内容

此次教程主要分享测试的思路为主,虽然以 React 为主要技术栈,但使用其它技术栈的读者依然可以流畅阅读。

本教程是我结合了自身实践、Kent C. Dodds 文章、StackOverflow 、Github Issue 以及别的博客最终总结出来的一套实践指南。

小书包含 3 部分:

最后

我知道很多人看到这个贴子依然对测试嗤之以鼻,可能觉得写测试就是扯淡、浪费时间的,也可能你已经对国内的 “短平快” 失望了,这个我完全能理解。

但我相信总有人愿意写测试的,我希望在他们学习如何写测试时能给一个方向和引导。

4465 次点击
所在节点    程序员
51 条回复
Terry05
2022-05-20 14:13:32 +08:00
很棒的书!
varzy
2022-05-20 14:15:00 +08:00
正好需要,感谢分享!
huajieyu
2022-05-20 14:15:33 +08:00
感谢分享
s5s5
2022-05-20 14:55:17 +08:00
非常感谢,楼主辛苦了,Star 送上
Haixiang
2022-05-20 15:13:15 +08:00
@palxie 嘻嘻,谢谢支持~
Haixiang
2022-05-20 15:13:26 +08:00
@s5s5 感谢支持~~~
Haixiang
2022-05-20 15:13:42 +08:00
@a90120411 记得五星好评哦
Hilong
2022-05-20 15:25:47 +08:00
点赞👍
s5s5
2022-05-20 15:59:17 +08:00
@Haixiang 你个人网站有些链接错了,报告到你的 me 项目的 issues 里了
hamsterbase
2022-05-20 16:12:28 +08:00
可以试试看 vitest 。

1. API 和 jest 几乎一样,迁移不需要改原先的代码
2. 自带 ts 支持,不需要 ts-jest
3. 速度快好几倍
v23xowen
2022-05-20 16:27:04 +08:00
支持~
yazoox
2022-05-20 16:55:04 +08:00
@hamsterbase 这么牛 B 么?支持度怎么样?不会过几年没有维护吧?
jest 好像是 facebook 支持的?
hamsterbase
2022-05-20 17:15:26 +08:00
@yazoox facebook 不想维护已经跑路了

vitest 是 vue 社区维护的。
wxrbw555
2022-05-20 17:59:30 +08:00
“这里我们还不忘搞点花里胡哨,引入了 src/components/AuthButton/styles.less:”
“好,现在我们一个一个问题来看。写完上面的代码后,TS 首先受不了报错:”

这两句话在"Less 的引入问题"附近,太像了😂
liugezhou
2022-05-20 18:08:04 +08:00
先码后看,最近也是在搞 jest
zhw2590582
2022-05-20 20:37:46 +08:00
一旦涉及到 dom 的,都不好写测试用例
Haixiang
2022-05-20 20:51:04 +08:00
@s5s5 感谢~ thx
Haixiang
2022-05-20 20:52:25 +08:00
@hamsterbase 可以,可以尝试点新的
Haixiang
2022-05-20 20:53:33 +08:00
@wxrbw555 你们是要笑死我,到底从哪看出我是 08 粉的,哈哈哈哈
Haixiang
2022-05-20 20:54:27 +08:00
@zhw2590582 对的,最好用更贴近用户的真实行为来做测试

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/854074

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX