Insomnia支持通过JavaScript测试断言自动验证API响应，包括状态码、JSON结构、字段值、环境变量比对、WebSocket消息及自定义错误提示。
如果您在使用Insomnia调试API时需要自动验证响应内容是否符合预期，则可借助其内置的JavaScript测试断言功能。以下是针对响应数据进行断言验证的具体操作步骤：
一、在请求中启用Tests标签页并编写基础断言
Insomnia的Tests功能允许您在每次请求发送后立即运行JavaScript脚本，对响应状态码、JSON结构、字段值等进行校验。该机制基于Chai断言库语法，支持链式调用和语义化表达。
1、选中目标请求，在右侧面板中点击Tests标签页。
2、在编辑区输入以下标准断言示例：
expect(response.status).toBe(200);
expect(response.body).toContain('id');
expect(response.body.id).toBeDefined();
3、点击右上角Send按钮执行请求，断言结果将在下方Console区域实时输出。
二、验证JSON响应字段与嵌套结构
当API返回复杂嵌套JSON时，需通过点符号或方括号访问深层属性。Insomnia会自动将response.body解析为JavaScript对象，支持直接读取和断言。
1、确保响应Content-Type为application/json且响应体为合法JSON格式。
2、在Tests标签页中编写如下断言：
const data = response.body;
expect(data).toHaveProperty('user.name');
expect(data.user.email).toMatch(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
expect(data.items).toBeInstanceOf(Array);
expect(data.items.length).toBeGreaterThan(0);
三、使用环境变量与动态值进行断言比对
当需要将响应字段与预设环境变量或前序请求结果比对时，可通过Insomnia变量系统实现跨请求验证逻辑。
1、在当前请求的Tests脚本中获取环境变量值：
const expectedId = insomnia.getEnvironmentVariable('expected_user_id');
2、提取响应中的对应字段并比对：
const actualId = response.body.id;
expect(actualId).toEqual(expectedId);
3、若需保存响应字段供后续请求使用，可调用：
insomnia.setEnvironmentVariable('fetched_token', response.body.token);
四、处理异步响应与延迟断言
对于WebSocket或SSE等流式响应场景，Insomnia支持在Tests中监听消息事件，并对特定消息内容执行断言。该能力依赖于协议专用的上下文对象（如websocket）。
1、切换请求类型为WebSocket，填写有效WebSocket URL并建立连接。
2、在Tests标签页中编写事件监听断言：
websocket.onmessage = (event) => {
const msg = JSON.parse(event.data);
expect(msg.type).toBe('ack');
expect(msg.timestamp).toBeDefined();
};
3、发送触发消息后，控制台将显示匹配成功的断言结果。
五、集成自定义错误提示与条件跳过
为提升调试效率，可在断言失败时输出明确的错误描述；也可根据响应特征跳过不适用的断言块，避免误报。
1、使用fail()方法抛出自定义错误信息：
if (!response.body.success) {
fail('API返回非success状态，实际值为：' + response.body.status);
}
2、添加前置判断以跳过空响应断言：
if (response.body && typeof response.body === 'object') {
expect(response.body).toHaveProperty('data');
}
