Bruno脚本执行实战指南：3步搞定跨阶段代码共享难题

Bruno脚本执行实战指南：3步搞定跨阶段代码共享难题

【免费下载链接】bruno开源的API探索与测试集成开发环境（作为Postman/Insomnia的轻量级替代方案）项目地址: https://gitcode.com/GitHub_Trending/br/bruno

你是否在Bruno中进行API测试时，发现相同的require()调用在不同阶段表现迥异？预请求阶段能正常加载本地脚本，到了后请求阶段却报"模块未找到"错误？本文将为你揭示背后的执行机制，并提供一套完整的解决方案。

问题根源：双环境执行架构

Bruno采用独特的双环境执行架构，这是导致require()行为差异的根本原因。通过深入分析源码，我们发现了两个完全不同的执行环境：

预请求阶段 - 主进程沙箱

• 执行权限：拥有完整文件系统访问权
• 路径解析：基于集合根目录的相对路径
• 典型应用：读取配置文件、生成动态参数

// 预请求阶段示例 - 可正常加载本地脚本 const userData = require('./data/users.json'); bru.setVar('authToken', userData.tokens[0]);

后请求阶段 - 渲染进程VM

• 安全限制：运行在严格的安全沙箱中
• 模块限制：仅允许加载内置模块
• 主要用途：响应数据验证、结果断言

// 后请求阶段示例 - 仅能使用内置模块 const _ = require('lodash'); const statusCode = _.get(bru.response, 'status');

核心差异对比：一张图看懂执行机制

• 工作目录：集合根目录 | 应用安装目录
• 主要任务：请求准备 | 响应处理
• 错误类型：路径错误 | 权限错误

实战解决方案：3步搞定跨阶段代码共享

第一步：预请求阶段数据预加载

将需要跨阶段使用的数据在预请求阶段完成加载和存储：

// 预请求阶段：读取并存储配置数据 const appConfig = require('./config/app.json'); bru.setVar('appSettings', appConfig); // 复杂数据处理也在此阶段完成 const dataProcessor = require('./scripts/data-processor.js'); const processedData = dataProcessor.transform(rawData); bru.setVar('finalData', processedData);

第二步：变量系统桥梁搭建

利用Bruno内置的变量系统作为数据传输通道：

// 后请求阶段：从变量系统获取数据 const config = bru.getVar('appSettings'); const result = bru.getVar('finalData');

第三步：内置模块策略应用

在后请求阶段优先使用Bruno提供的内置模块：

// 后请求阶段：使用内置模块处理响应 const _ = require('lodash'); const responseData = _.get(bru.response, 'data');

高级应用：构建可复用的脚本架构

模块化集合设计模式

将共享脚本组织为独立的模块化结构：

collection-root/ ├── scripts/ │ ├── validators.js // 数据验证函数 │ ├── formatters.js // 格式转换工具 │ └── constants.js // 常量定义 └── requests/ └── api-tests.bru

路径解析最佳实践

避免相对路径的不确定性，使用可靠的路径构建方式：

// 统一使用bru.cwd()获取集合根目录 const path = require('path'); const scriptPath = path.join(bru.cwd(), 'scripts', 'utils.js'); const utils = require(scriptPath);

常见问题快速排查指南

问题1：后请求阶段require本地脚本失败

症状：Error: Cannot find module './local-script.js'

原因：安全沙箱阻止文件系统访问

解决方案：

1. 将脚本加载移至预请求阶段
2. 通过bru.setVar()存储结果
3. 后请求阶段通过bru.getVar()获取

问题2：跨阶段数据格式不一致

症状：预请求阶段设置的数据在后请求阶段无法正确解析

修复：使用JSON序列化确保数据格式统一：

// 预请求阶段 bru.setVar('userList', JSON.stringify(users)); // 后请求阶段 const userData = JSON.parse(bru.getVar('userList'));

总结：Bruno脚本开发的黄金法则

1. 阶段分离原则：文件IO操作集中在预请求阶段
2. 数据桥梁策略：通过变量系统实现跨阶段数据传递
3. 内置模块优先：后请求阶段仅使用必要的内置功能
4. 路径标准化：统一使用bru.cwd()构建绝对路径

通过这套系统化的解决方案，你可以在Bruno中构建既安全又高效的API测试工作流，充分利用其本地优先和版本控制友好的特性。

【免费下载链接】bruno开源的API探索与测试集成开发环境（作为Postman/Insomnia的轻量级替代方案）项目地址: https://gitcode.com/GitHub_Trending/br/bruno