V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
brookshi
V2EX  ›  程序员

强大的 API 测试工具 Hitchhiker v0.9 基于 UI 的断言测试,回顾 2017

  •  1
     
  •   brookshi · 2018-02-06 22:45:42 +08:00 · 2435 次点击
    这是一个创建于 2480 天前的主题,其中的信息可能已经有所发展或是发生改变。

    v0.9 是 Hitchhiker 在 2017 农历年的最后一个版本,而起点正是刚过完 2016 农历年,农历 2018 即将到来,一年轮回,今天写点东西稍微回顾下 hitchhiker 的 2017。

    先还是说 v0.9,这次版本发布主要带来一个新的辅助测试功能:免脚本的断言测试,这是一个携程的朋友提出来的需求。

    之前 Hitchhiker 支持在 test 脚本里写 tests['assert'] = value 这样来断言,但很多 QA 其实并不会编程,或者会其他语言但对 js 不熟,这样断言写起来就不太方便,所以这次应朋友的需求加了这个功能:

    上面动图已经展示了功能和用法,具体就不多说了。

    回头看下 Hitchhiker 的 2017,一年过来,对这个项目来说结果还不错,大小版本发了 14 个,github 上有了 1k+的 star,我也因此认识了一些朋友,对技术上有也不少提升,总体看对我来说是成功了。

    https://github.com/brookshi/Hitchhiker

    起初,大概是 2016 年年中,我开始负责公司一个 API 项目,因为是金融公司,对数据准确性要求很高,所以产生想法,做一个工具来辅助这个 API 项目的测试,减少沟通成本以及 QA 做 regression 时的压力。后面准备了下,在 2016 年农历年后,也就是 17 年的 3 月份,正式开始编码实现功能。

    由于不懂设计,所以 UI 上参考了比较熟悉的一个成名已久的测试工具:Postman,这也导致:即使后来除了 UI 外,实现了很多 Postman 没有的功能也还是摆脱不了 Postman 的影子,不少人一看跟 Postman 一样,觉得没有意义,在这点上算是一个败笔。不过也因为类 Postman UI 的易用性,让使用 Hitchhiker 的人很容易上手,这又是一大优势,算是两者抵消吧。

    当时,想要通过这个工具解决的问题只有 2 个:

    1. 减少开发的沟通成本,原因是我们的 API 是面向用户的,依赖公司其他 Team 的众多 API,我们写一个接口可能要调用公司好几个 API 才能整合出想要的数据,这就需要开发去和好几个 team 打交道,沟通成本很大。而如果要所有开发都做一遍同样的事情,浪费的时间可想而知。

    2. 减少浪费 QA 人力做无聊的数据对比,这个算是自动化的一部分,上面说了,金融数据的准确性是非常关键的,我们的产品又是直面用户的,有问题第一个找到我们头上,所以 QA 在这方面也非常头痛,以往都是依赖人眼去对比线上和 UAT 两个版本的报表是否匹配,容易疏忽不说,时间有效的情况下,覆盖率也很难达到要求,且对 QA 来说,这类事情是最应该自动化的。

    解决这 2 个问题的方案是:

    1. 很多工具需要互相 share,有更新就 share 的话也很麻烦。Hitchhiker 支持多人同时在线维护同一份 API,支持实时更新,一个开发在完成沟通后,把依赖的 API 都整理在一起,写好 case,其他开发就可以直接借鉴使用了,只花一个人的时间,成果所有开发共享。

    2. 使用 Schedule 来实现 Case 的自动化运行,以及用脚本做断言来判断数据是否正确,但金融数据上经常有动态值,比如求上个月的回报,对今天来说,上个月是 1 月,但过一个月后,上个月就是 2 月了,数据很可能就不一样了,所以对这类动态值用断言方式很难解决,Hitchhiker 支持在做自动化测试时对比不同环境的数据,我们以线上的数据为准的话就可以知道没上线环境的 API 运行是否正常了。

    这两个功能在 17 年 7 月左右先后实现,我的 API 项目的接口测试也陆续加了进去,基本上满足了需求。

    由于项目的 API 的并发量比较大,在服务器有限的情况下,需要尽量提前优化来提高吞吐,避免上线后出问题,所以需要在测试阶段给到服务器压力,然后在 10 月份时用 Go 语言为 Hitchhiker 实现了压力测试。

    在 0.5 版本时用 gitbook 重写了文档: Hitchhiker 使用文档

    接下来的一个版本又大幅加强了脚本功能,支持 require,支持上传脚本库和数据文件,标志着 NPM 里几十万的 js 库尽可以拿来用了。

    不过可惜的是基于 Go 语言写的压力测试由于对 js 支持有限,不得不放弃,转而使用 Node 重写了一份压力测试的功能并在 v0.6 版本上线。

    其实到这时为止,Hitchhiker 已经满足我的 API 项目的需求了,但随着使用者越来越多,需求不断出现,后续的版本基本都在实现这些需求了:

    v0.7:支持自定义 smtp,为请求生成各种语言的 code,schedule 数据不同时的 diff 展示

    v0.8: 自动化测试结果统计

    v0.9: 基于 UI 的断言测试

    还有很多功能想要实现,文档,Mock,管理平台等等,将会在接下来的 2018 里陆续实现。

    在线体验: http://www.hitchhiker-api.com/, 可以用 try without login 来免登录使用 (在线演示不支持压力测试和上传 js 库,虚拟机单核的,撑不住)。

    9 条回复    2018-02-08 21:12:12 +08:00
    prasanta
        1
    prasanta  
       2018-02-07 08:30:29 +08:00 via Android   ❤️ 1
    支持
    ebony0319
        2
    ebony0319  
       2018-02-07 08:36:31 +08:00 via Android
    好像 postman
    ebony0319
        3
    ebony0319  
       2018-02-07 08:37:35 +08:00 via Android   ❤️ 1
    sorry,理解错了。
    wzw
        4
    wzw  
       2018-02-07 08:46:23 +08:00   ❤️ 1
    是不是可以本机虚拟机搭建用来压力测试?
    raofeng
        5
    raofeng  
       2018-02-07 15:55:47 +08:00   ❤️ 1
    不支持 emoji 吗?
    save record failed, Error: Internal Server Error, Retry 7th time after 128000s
    raofeng
        6
    raofeng  
       2018-02-07 15:57:21 +08:00
    SYNCING 的任务不能取消吗?点击没反应。
    brookshi
        7
    brookshi  
    OP
       2018-02-07 21:13:07 +08:00
    emoji 应该是数据库没设置 utf8 吧,SYNCING 只是一个状态,不能取消
    raofeng
        8
    raofeng  
       2018-02-08 15:38:22 +08:00
    如果能设置在某个时间段持续每隔几秒执行就完美了。
    brookshi
        9
    brookshi  
    OP
       2018-02-08 21:12:12 +08:00
    @raofeng 这个比较特殊,可能加一个自定义脚本来设置执行时间会比较通用
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2802 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 14:18 · PVG 22:18 · LAX 06:18 · JFK 09:18
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.