Postman中文文档——沙盒(Sandbox)

Postman沙盒

Postman Sandbox是一个JavaScript执行环境,您可以在编写预请求脚本和测试脚本(在Postman和Newman中)时可用。在这个沙箱中执行您在预请求/测试脚本部分中写入的代码。


常用的库和实用程序

  • Lodash:JS实用程序库
  • cheerio:一个快速,精简的核心jQuery API实现(版本4.6.0及更高版本)
  • BackboneJS 已弃用:提供简单的模型,视图和集合。这将在以后版本的沙箱中删除。
  • SugarJS 已弃用:使用有用的方法扩展本机JS对象。将在以后版本的沙箱中删除。
  • tv4 JSON模式验证器:根据json-schema草案的v4验证JSON对象
  • CryptoJS:标准和安全的加密算法。支持的算法:AES,DES,EvpKDF,HMAC-MD5,HMAC-SHA1 / 3/256/512,MD5,PBKDF2,Rabbit,SHA1 / 3/224/256/512,TripleDES
  • xml2Json(xmlString):这个函数在Newman和Postman中是一样的
  • xmlToJson(xmlString) 已弃用:此功能在Newman和Postman中的行为不相同
  • postman.getResponseHeader(headerName) Test-only:返回名称为“headerName”的响应头(如果存在)。如果没有这样的头存在,则返回null。 注意:根据W3C规范,头名不区分大小写。这个方法是照顾这个。 postman.getResponseHeader("Content-type") 并且 postman.getResponseHeader("content-Type") 将返回相同的值。

注意:自4.6.0版本以来,jQuery支持已经停用,支持 cheerio。


环境和全局变量

  • postman.setEnvironmentVariable(variableName, variableValue):设置一个环境变量“variableName”,并为其分配字符串“variableValue”。您必须为此方法选择一个环境才能工作。 注意:只能存储字符串。存储其他类型的数据将导致意外的行为。
  • postman.getEnvironmentVariable(variableName):返回环境变量“variableName”的值,用于预请求和测试脚本。您必须为此方法选择一个环境才能工作。
  • postman.setGlobalVariable(variableName, variableValue):设置一个全局变量“variableName”,并为其分配字符串“variableValue”。 注意:只能存储字符串。存储其他类型的数据将导致意外的行为。
  • postman.getGlobalVariable(variableName):返回全局变量“variableName”的值,用于预请求和测试脚本。
  • postman.clearEnvironmentVariable(variableName):清除名为“variableName”的环境变量。您必须为此方法选择一个环境才能工作。
  • postman.clearGlobalVariable(variableName):清除名为“variableName”的全局变量。
  • postman.clearEnvironmentVariables():清除所有环境变量。您必须为此方法选择一个环境才能工作。
  • postman.clearGlobalVariables():清除所有全局变量。
  • environment:当前环境中的变量字典。使用 environment["foo"] 访问“foo”的环境变量的值。注意:这只能用来读取变量。使用 setEnvironmentVariable() 设置值。
  • globals全球变量字典使用 globals["bar"] 访问“栏中的”全局变量的值。注意:这只能用来读取变量。使用 setGlobalVariable() 设置值

动态变量

Postman还有一些动态变量,您可以在您的请求中使用。这主要是一个实验性功能。更多功能将很快添加。请注意,在沙箱中不能使用动态变量。您只能 以请求URL / headers / body 中的格式使用它们 。{{..}}

  • {{$guid}}:添加v4风格的guid
  • {{$timestamp}}:添加当前时间戳。
  • {{$randomInt}}:添加0到1000之间的随机整数

Cookies

  • responseCookies {array} Postman-only:获取为域设置的所有Cookie。您将需要启用Interceptor才能工作。
  • postman.getResponseCookie(cookieName) Postman-only:获取具有给定名称的响应cookie。您将需要启用拦截器才能工作。查看 博客文章。

请求/响应相关属性

  • request {object}:Postman在写脚本时使请求对象可用。该对象是只读的。更改此对象的属性将不起作用。注意:变量不会在请求对象中解析。请求对象由以下内容组成:
    • data {object} - 这是请求的表单数据字典。(request.data[“key”]==”value”
    • headers {object} - 这是请求的标题字典(request.headers[“key”]==”value”
    • method {string} - GET / POST / PUT等
    • url {string} - 请求的url。
  • responseHeaders {object} 已弃用仅测试:这是响应头的映射。这是区分大小写的,不应该使用。检查postman.getResponseHeader() 上面列出的方法。
  • responseBody {string} 仅测试:包含原始响应正文文本的字符串。您可以将其用作JSON.parse或xml2Json的输入。
  • responseTime {number} 仅测试:响应时间(以毫秒为单位)
  • responseCode {object} Test-only:包含三个属性:
    • code {number}:响应代码(200为OK,404为未找到等)
    • name {string}:状态码文本
    • detail {string}:响应代码的解释
  • tests {object} 仅测试:此对象是为您填充。Postman将将此对象的每个属性作为布尔测试。
  • iteration {number}:仅在Collection Runner和Newman中可用。表示当前的测试运行索引。从0开始。

仅测试:此对象仅在测试脚本部分可用。在预请求的脚本中使用它会引发错误。


数据文件

如果您 在Collection Runner或Newman中使用 数据文件,则可以访问 data 对象,该对象是当前测试运行中数据值的字典。


pm。* API

查看 Postman Sandbox API参考。

你可能感兴趣的:(Postman中文文档——沙盒(Sandbox))