feat: add pm.sendRequest() method for sending HTTP requests in pre-scripts

Author: lakernote

docs/SCRIPT_API_REFERENCE_zh.md

@@ -48,6 +48,7 @@
 | `pm.setGlobalVariable(key, value)` | 设置全局变量（实际存储在环境变量中） | `pm.setGlobalVariable('baseUrl', 'https://api.com')` |
 | `pm.getGlobalVariable(key)`        | 获取全局变量（实际从环境变量读取）  | `pm.getGlobalVariable('baseUrl')`                    |
 | `pm.getResponseCookie(name)`       | 获取响应中的 Cookie      | `pm.getResponseCookie('sessionId')`                  |
+| `pm.sendRequest(options, callback)` | 在脚本中发送额外 HTTP 请求 | `pm.sendRequest({ url: 'https://api.com' }, (err, resp) => {})` |
 
 ### 外部数据源对象
 
@@ -58,6 +59,43 @@
 | `pm.es` / `pm.elasticsearch` | Elasticsearch 请求与查询 | `request(options)`、`query(options)` |
 | `pm.influx` / `pm.influxdb` | InfluxDB Flux / InfluxQL 查询与写入 | `query(options)`、`write(options)`、`request(options)` |
 
+### pm.sendRequest()
+
+`pm.sendRequest()` 已支持在脚本中主动发起额外 HTTP 请求，适用于前置脚本里刷新 token、拉取签名、预热上下文数据等场景。
+
+回调函数签名为 `(err, response)`：
+
+- `err`：请求失败时返回错误对象，包含 `message`、`name`
+- `response`：成功时返回响应包装对象，可使用 `response.code`、`response.status`、`response.headers.get()`、`response.text()`、`response.json()`
+
+支持的请求格式：
+
+- 直接传 URL 字符串，默认 `GET`
+- 传对象：`url`、`method`、`header`、`body`
+- `body.mode` 当前支持 `raw`、`formdata`、`urlencoded`
+
+示例：
+
+```javascript
+pm.sendRequest({
+    url: 'https://httpbin.org/get?source=easy-postman&from=pre-script',
+    method: 'GET',
+    header: {
+        'X-Debug-Token': pm.environment.get('debugToken') || 'demo-token'
+    }
+}, function (err, response) {
+    if (err) {
+        console.error('请求失败:', err.message);
+        return;
+    }
+
+    const data = response.json();
+    pm.environment.set('lastHttpbinUrl', data.url || '');
+    pm.environment.set('lastHttpbinSource', data.args?.source || '');
+    console.log('httpbin args:', data.args);
+});
+```
+
 ---
 
 ## pm.environment - 环境变量
@@ -2244,8 +2282,35 @@ const currentTime = Date.now();
 // 检查 token 是否过期（提前5分钟刷新）
 if (!tokenExpireTime || currentTime > (parseInt(tokenExpireTime) - 300000)) {
     console.log('Token 即将过期或已过期，需要刷新');
-    // 在实际环境中，这里应该触发刷新 token 的逻辑
-    // 由于不支持 pm.sendRequest，建议在测试流程中手动添加刷新 token 的请求
+    pm.sendRequest({
+        url: pm.environment.get('authUrl'),
+        method: 'POST',
+        header: {
+            'Content-Type': 'application/json'
+        },
+        body: {
+            mode: 'raw',
+            raw: JSON.stringify({
+                refreshToken: pm.environment.get('refreshToken')
+            })
+        }
+    }, function (err, response) {
+        if (err) {
+            console.error('刷新 token 失败:', err.message);
+            return;
+        }
+
+        const data = response.json();
+        const token = data.accessToken || data.token;
+        if (token) {
+            pm.environment.set('authToken', token);
+            pm.request.headers.upsert({
+                key: 'Authorization',
+                value: 'Bearer ' + token
+            });
+            console.log('✓ Token 刷新成功，已更新认证头');
+        }
+    });
 } else {
     const token = pm.environment.get('authToken');
     if (token) {
@@ -2981,7 +3046,6 @@ pm.environment.set('performanceStats', JSON.stringify(stats));
     - 库代码会被缓存，重复加载不会影响性能
 
 8. **不支持的功能**
-    - ❌ `pm.sendRequest()` - 不支持在脚本中发送 HTTP 请求
     - ❌ `pm.iterationData` - 不支持迭代数据（但支持 CSV 数据驱动）
     - ❌ `pm.info` - 不支持请求元信息访问
     - ❌ 完整的 Chai.js 断言库

docs/SCRIPT_SNIPPETS_QUICK_REFERENCE.md

@@ -11,6 +11,7 @@
 - [获取时间戳](#获取时间戳)
 - [添加请求头](#添加请求头)
 - [添加查询参数](#添加查询参数)
+- [前置脚本发送 HTTP 请求](#前置脚本发送-http-请求)
 
 ### 认证相关
 - [Bearer Token 认证](#bearer-token-认证)
@@ -126,6 +127,29 @@ pm.request.params.add({
 });
 ```
 
+### 前置脚本发送 HTTP 请求
+```javascript
+// Pre-request Script
+pm.sendRequest({
+    url: 'https://httpbin.org/get?source=easy-postman&from=pre-script',
+    method: 'GET',
+    header: {
+        'X-Debug-Token': pm.environment.get('debugToken') || 'demo-token'
+    }
+}, function (err, response) {
+    if (err) {
+        console.error('请求失败:', err.message);
+        return;
+    }
+
+    const data = response.json();
+    pm.environment.set('lastHttpbinUrl', data.url || '');
+    pm.environment.set('lastHttpbinSource', data.args?.source || '');
+    console.log('响应状态:', response.code, response.status);
+    console.log('httpbin args:', data.args);
+});
+```
+
 ---
 
 ## 认证相关
@@ -205,7 +229,34 @@ const tokenExpireTime = pm.environment.get('tokenExpireTime');
 const currentTime = Date.now();
 
 if (!tokenExpireTime || currentTime > (parseInt(tokenExpireTime) - 300000)) {
-    console.warn('⚠ Token 即将过期，请手动刷新');
+    pm.sendRequest({
+        url: pm.environment.get('authUrl'),
+        method: 'POST',
+        header: {
+            'Content-Type': 'application/json'
+        },
+        body: {
+            mode: 'raw',
+            raw: JSON.stringify({
+                refreshToken: pm.environment.get('refreshToken')
+            })
+        }
+    }, function (err, response) {
+        if (err) {
+            console.error('刷新失败:', err.message);
+            return;
+        }
+
+        const data = response.json();
+        const token = data.accessToken || data.token;
+        if (token) {
+            pm.environment.set('authToken', token);
+            pm.request.headers.upsert({
+                key: 'Authorization',
+                value: 'Bearer ' + token
+            });
+        }
+    });
 } else {
     const token = pm.environment.get('authToken');
     pm.request.headers.upsert({

easy-postman-app/src/main/java/com/laker/postman/model/SnippetType.java

@@ -15,6 +15,7 @@ public enum SnippetType {
     DYNAMIC_MODIFY_HEADER(Category.PRE_SCRIPT, "snippet.dynamicModifyHeader.title", "snippet.dynamicModifyHeader.desc", "// Get and modify request headers\nif (pm.request && pm.request.headers) {\n    // Add custom request header\n    pm.request.headers.add({\n        key: 'X-Custom-Header',\n        value: 'Custom-Value-' + Date.now()\n    });\n    \n    // Add authentication info\n    pm.request.headers.add({\n        key: 'Authorization',\n        value: 'Bearer ' + pm.environment.get('token')\n    });\n    \n    console.log('Dynamically added request headers');\n}\n"),
     DYNAMIC_MODIFY_BODY(Category.PRE_SCRIPT, "snippet.dynamicModifyBody.title", "snippet.dynamicModifyBody.desc", "// Dynamically modify formData, urlencoded, formFiles, params\nif (pm.request.formData) {\n    pm.request.formData.add({ key: 'extraField', value: 'extraValue' });\n    console.log('Added formData field');\n}\nif (pm.request.urlencoded) {\n    pm.request.urlencoded.add({ key: 'token', value: pm.environment.get('token') });\n    console.log('Added urlencoded field');\n}\nif (pm.request.formFiles) {\n    pm.request.formFiles.add({ key: 'file', value: '/path/to/file' });\n    console.log('Added formFiles field');\n}\n\n// Note: You need to use related variables or fields in the actual request body/params for it to take effect"),
     DYNAMIC_MODIFY_PARAM(Category.PRE_SCRIPT, "snippet.dynamicModifyParam.title", "snippet.dynamicModifyParam.desc", "// Dynamically add to params\n pm.request.params.add({ key: 'timestamp', value: Date.now() });\n "),
+    SEND_HTTP_REQUEST(Category.PRE_SCRIPT, "snippet.sendHttpRequest.title", "snippet.sendHttpRequest.desc", "// 前置脚本里发送一个可直接测试的 HTTP 请求\npm.sendRequest({\n    url: 'https://httpbin.org/get?source=easy-postman&from=pre-script',\n    method: 'GET',\n    header: {\n        'X-Debug-Token': pm.environment.get('debugToken') || 'demo-token'\n    }\n}, function (err, response) {\n    if (err) {\n        console.error('请求失败:', err.message);\n        return;\n    }\n\n    pm.test('httpbin 请求返回 200', function () {\n        pm.expect(response.code).to.equal(200);\n    });\n\n    var data = response.json();\n    pm.environment.set('lastHttpbinUrl', data.url || '');\n    pm.environment.set('lastHttpbinSource', data.args && data.args.source ? data.args.source : '');\n\n    console.log('响应状态:', response.code, response.status);\n    console.log('httpbin url:', data.url);\n    console.log('httpbin args:', JSON.stringify(data.args));\n});"),
 
     // Assertion category
     ASSERT_STATUS_200(Category.ASSERT, "snippet.assertStatus200.title", "snippet.assertStatus200.desc", "pm.test('Status code is 200', function () {\n    pm.response.to.have.status(200);\n});"),

easy-postman-app/src/main/resources/messages_en.properties

@@ -1282,6 +1282,8 @@ snippet.dynamicModifyBody.title=Pre-Script: Dynamic Modify Body
 snippet.dynamicModifyBody.desc=Dynamically modify request body and all parameters (formData, urlencoded, formFiles)
 snippet.dynamicModifyParam.title=Pre-Script: Dynamic Modify Param
 snippet.dynamicModifyParam.desc=Dynamically add signature, timestamp, etc. to request URL and parameters
+snippet.sendHttpRequest.title=Pre-Script: Send HTTP Request
+snippet.sendHttpRequest.desc=Send an auxiliary HTTP request in pre-script and process the response
 snippet.assertStatus200.title=Assert: Status Code 200
 snippet.assertStatus200.desc=Assert response status code is 200
 snippet.assertBodyContains.title=Assert: Body Contains String

easy-postman-app/src/main/resources/messages_zh.properties

@@ -1337,6 +1337,8 @@ snippet.dynamicModifyBody.title=前置-动态修改请求体
 snippet.dynamicModifyBody.desc=动态修改请求体和所有参数（formData、urlencoded、formFiles）
 snippet.dynamicModifyParam.title=前置-动态修改请求参数
 snippet.dynamicModifyParam.desc=为请求URL和参数动态添加签名、时间戳等字段
+snippet.sendHttpRequest.title=前置-发送HTTP请求
+snippet.sendHttpRequest.desc=在前置脚本中发送辅助HTTP请求并处理响应
 snippet.assertStatus200.title=断言-状态码为200
 snippet.assertStatus200.desc=断言响应状态码为200
 snippet.assertBodyContains.title=断言-Body包含字符串