HTTP 客户端参考

client 对象包含 HTTP 客户端会话元数据（例如，全局变量列表）并允许您 测试 HTTP 响应和 日志 输出中的文本。 HTTP 客户端会话在 IntelliJ IDEA 启动时开始，并在 IntelliJ IDEA 关闭时结束。在 IntelliJ IDEA 重启之间，值不会被保留。

client 对象提供对 global 嵌套对象的访问，该对象用作变量存储。

方法

测试

创建一个名称为 testName 且内容为 func 的测试。所有测试在响应处理程序脚本之后执行。测试结果显示在测试选项卡的服务工具窗口。

形参	类型	描述
testName	String	测试名称
func	function	JavaScript 函数用于测试 HTTP 响应

assert

检查指定的 条件 是否为 true ；否则抛出异常。可选的 message 参数充当异常消息。

形参	类型	描述
条件	布尔	检查响应中的条件
message	String	如果条件评估为假，则返回的可选消息。

日志

将 text 输出到响应处理程序或预请求脚本的输出中，然后终止该行。

形参	类型	描述
text	String	在响应处理程序或预请求脚本的输出中打印的文本。

退出

终止响应处理程序脚本的执行。

属性

全局

用于设置和移除全局变量和头信息的全局变量存储。

一旦您为全局变量 (client.global.set(VariableName, VariableValue)) 分配了一个值，您可以在随后的 HTTP 请求中以 {{VariableName}} 访问它，或在响应处理程序脚本和预请求脚本中使用 client.global.get("VariableName") 访问它。请参阅使用全局变量以获取更详细的示例。

全局变量和头信息

全局 对象允许您执行以下操作：

设置和获取全局变量。这些变量是全局的，因为一旦设置，它们可以从任何 HTTP 请求访问。
设置全局头信息。一旦设置，它们将应用于所有 HTTP 请求。

集合

将变量与 varName 名称一起保存到存储中，并将其值设置为 varValue。请参阅使用全局变量以获取更详细的示例。

形参	类型	描述
varName	String	要保存到全局存储的变量名称。
varValue	String	要保存到全局存储的变量值。

获取

返回 varName 变量的值。

形参	类型	描述
varName	String	要返回的变量名称。

isEmpty

检查 全局 对象是否未定义变量。

很明显

将 varName 变量从变量存储中移除。

形参	类型	描述
varName	String	要删除的变量名称。

清除所有

从变量存储中移除所有变量。

headers.set

使用 client.global.headers.set(headerName, headerValue) 添加 headerName 头信息及其 headerValue。例如：

client.global.headers.set("X-Our-Header-1", "value1")

在响应处理脚本中使用时，该头信息将应用于所有后续的 HTTP 请求。在预请求脚本中使用时，该头信息将应用于当前 HTTP 请求及所有后续请求。

形参	类型	描述
headerName	String	在 HTTP 请求中使用的头信息名称。
headerValue	String	头信息的值。

要移除头信息，请使用 null 作为值：

client.global.headers.clear(headerName, null))

最后修改日期： 2025年 4月 24日