HTTP 客户端参考
client 对象包含 HTTP 客户端 会话元数据（例如，全局变量列表）并允许您 测试 HTTP 响应和 日志 输出中的文本。 HTTP 客户端会话在 GoLand 启动时开始，并在 GoLand 关闭时结束。 在 GoLand 重启之间，值不会被保留。
client 对象提供对 global 嵌套对象的访问，该对象用作变量存储。
方法
test
创建一个名称为 testName 且内容为 func 的测试。 所有测试在响应处理程序脚本之后执行。 测试结果显示在 测试 选项卡的 服务 工具窗口。
形参 | 类型 | 描述 |
|---|---|---|
testName | 字符串 | 测试名称 |
func | 函数 | JavaScript 函数用于测试 HTTP 响应 |
断言
检查指定的 condition 是否为 true ；否则抛出异常。 可选的 message 参数充当异常消息。
参数 | 类型 | 描述 |
|---|---|---|
条件 | boolean | 检查响应中的条件 |
消息 | 字符串 | 如果条件评估为假，则返回的可选消息。 |
日志
将 text 输出到响应处理程序或预请求脚本的输出中，然后终止该行。
形参 | 类型 | Description |
|---|---|---|
文本 | String | 在响应处理程序或预请求脚本的输出中打印的文本。 |
退出
终止响应处理程序脚本的执行。
属性
全局
全局变量存储 ，用于设置和移除全局变量和头信息。
一旦您为全局变量 (client.global.set(VariableName, VariableValue)) 分配了一个值，您可以在随后的 HTTP 请求中以 {{VariableName}} 访问它，或在响应处理程序脚本和预请求脚本中使用 client.global.get("VariableName") 访问它。 请参阅 使用全局变量 以获取更详细的示例。
全局变量和头信息
global 对象允许您执行以下操作：
设置和获取全局变量。 这些变量是全局的，因为一旦设置，它们可以从任何 HTTP 请求访问。
设置全局头信息。 一旦设置，它们将应用于所有 HTTP 请求。
集合
将变量与 varName 名称一起保存到存储中，并将其值设置为 varValue。 请参阅 使用全局变量 以获取更详细的示例。
形参 | 类型 | 描述 |
|---|---|---|
varName | 字符串 | 要保存到全局存储的变量名称。 |
varValue | 字符串 | 要保存到全局存储的变量值。 |
get
返回 varName 变量的值。
参数 | 类型 | 描述 |
|---|---|---|
varName | 字符串 | 要返回的变量名称。 |
isEmpty
检查 global 对象是否未定义变量。
清除
将 varName 变量从变量存储中移除。
形参 | 类型 | Description |
|---|---|---|
varName | String | 要删除的变量名称。 |
清除所有
从变量存储中移除所有变量。
headers.set
使用 client.global.headers.set(headerName, headerValue) 添加带有 headerName 和 headerValue 的头信息。 例如：
当在响应处理脚本中使用时，该头信息将应用于所有后续的 HTTP 请求。 当在预请求脚本中使用时，该头信息将应用于当前 HTTP 请求及所有后续请求。
形参 | 类型 | 描述 |
|---|---|---|
headerName | 字符串 | 要在 HTTP 请求中使用的头信息名称。 |
headerValue | 字符串 | 头信息的值。 |
要移除头信息，请将值设置为 null：