【接口测试】如何在 Eolink Apilkit 中使用 cookie ?

发布时间 2023-10-10 17:33:20作者: 小Kit

Cookie是一种在网站之间传递的小型文本文件,用于存储用户的个人信息和偏好设置。当您访问一个网站时,网站会将Cookie存储在您的浏览器中,并在您下次访问该网站时读取该Cookie。这样,网站可以记住您的登录状态、购物车内容以及其他个性化设置。

在编写接口自动化测试用例或其他脚本的过程中,经常会遇到需要绕过用户名/密码或验证码登录,去请求接口的情况,一是因为有时验证码会比较复杂,比如有些图形验证码,难以通过接口的方式去处理;再者,每次请求接口前如果都需要先去登录一次,这样不仅效率低,还耗费资源。

有些网站是使用cookie辨别用户身份的,此时我们便可以先登录一次,拿到登录成功后的cookie,后续请求时在请求头中加入该cookie,便可保持登录状态直接请求。

cookie绕过登录其实是登录状态保持,而不是真的不需要登录。


项目地址:https://www.eolink.com/apikit

我们调试时会经常试用cookie值,除了可以在请求头中直接输入cookie外,也可以通过cookie管理工具把cookie值保存起来。后续测试时可针对不同的域名调用不用的cookie值。

  1. 选择某个文档进入测试TAB,点击最右侧的cookie按钮,即可打开cookie管理工具。

image

  1. 在cookie管理工具中,可输入需要存储cookie的域名及编辑对应的cookie值。

image


当您想对cookie的值进行自定义时,可以通过 Eolink 的函数做到;

//设置cookie值
eo.cookieStorage.set("hostname",[])

//获取 cookie 存储对象,返回为 object
eo.cookieStorage.all()

//获取某个域名的 cookie 存储,传参为 hostname:域名,返回为 array
eo.cookieStorage.get("hostname")

//删除某个域名下的cookie字段
eo.cookieStorage.remove("hostname")

⚠️注意:hostname示例格式:www.eolink.com,前面不需要加http://或https://

  1. 如下图所示,步骤一与步骤二的域名相同,在Eolink中,步骤一API的返回头会返回set-cookie,步骤二的请求头会自动带上这个cookie。

image

  1. 测试后如下图报告所示,步骤一响应头返回set-cookie,步骤二继承步骤一的cookie信息

image

image


在步骤一的后置脚本中通过eo.cookieStorage.set()改变cookie的值,以下为具体示例:

var tmp_host="域名" //需要改变cookie值的域名

eo.cookieStorage.set(tmp_host,["123456"])//修改tmp_host的cookie为123456

  1. 在步骤一的后置脚本中修改cookie的值:

image

  1. 步骤一修改后,步骤二中继承的是修改后的cookie值,如下图报告所示:

image


可以用eo.cookieStorage.all()函数来获取当前步骤的域名以及cookie值,如下图所示:用eo.cookieStorage.all()获取域名,并输出cookie的值

image

image


可以用 eo.cookieStorage.get()函数获取指定域名下的cookie值,如下图所示:

image

测试后,报告中输出该域名的 cookie 值:

image


可以使用eo.cookieStorage.remove("域名")函数清除某个域名的cookie值,如下图所示,在步骤一的后置脚本中清除域名的cookie:

image

在步骤2中不会再带上步骤一请求返回的cookie

image


Eolink Apikit = API 管理 + Mock + 自动化测试 + 异常监控 + 团队协作,是一个强大的跨平台(Windows、Mac、Linux、Browsers...)的 API 开发测试工具,支持 REST、Websocket、gRPC、TCP、UDP、SOAP等协议,结合 API 设计、文档管理、自动化测试、监控、研发管理和团队协作的一站式 API 生产平台。