Postman gRPC 测试示例

您可以使用脚本为 gRPC 请求编写测试。根据逻辑和您希望如何获得结果，可以通过多种方式构建测试断言。本节将介绍一些最常见的断言编写方法，以及解释如何使用pm.* API编写测试的大量示例。

测试状态码

您可以使用pm.responsestatusCode上可用的属性来测试响应的状态代码。

pm.test('Status code is 0', () => {
  pm.response.to.have.statusCode(0);
});

您还可以使用pm.expect方法断言相同的内容。

pm.test('Status code is 0', () => {
  pm.expect(pm.response.statusCode).to.equal(0);
});

您可以使用pm.response.to.be.ok作为简写来测试状态代码是否为 0。

测试响应时间

对于具有一元方法的请求，您可以断言响应时间：

pm.test('Response time is below 200ms', () => {
  pm.response.to.have.responseTime.below(200);

  // or
  pm.response.to.have.responseTime.not.above(200);

  // Using pm.expect
  pm.expect(pm.response.responseTime).to.be.below(300);
});

对于使用流方法的请求，pm.response.responseTime表示该请求执行的总持续时间。

测试元数据

检查是否存在响应元数据：

pm.test('"content-type" is present in response metadata', () => {
  pm.response.to.have.metadata('content-type');

  // Using pm.expect
  pm.expect(pm.response.metadata.has('content-type')).to.be.true;
});

您还可以断言元数据的值：

pm.test('"content-type" response metadata is "application/grpc"', () => {
  pm.response.to.have.metadata('content-type', 'application/grpc');

  // Using pm.expect
  pm.expect(pm.response.metadata.get('content-type')).to.equal('application/grpc');
});

可以使用pm.request对象为请求元数据编写类似的断言。

测试响应预告片

检查是否存在响应预告片：

pm.test('"grpc-status-details-bin" is present in response trailers', () => {
  pm.response.to.have.trailer('grpc-status-details-bin');

  // Using pm.expect
  pm.expect(pm.response.trailers.has('grpc-status-details-bin')).to.be.true;
});

您还可以断言预告片的价值：

pm.test('"grpc-status-details-bin" response trailer is "dummy-value"', () => {
  pm.response.to.have.trailer('grpc-status-details-bin', 'dummy-value');

  // Using pm.expect
  pm.expect(pm.response.trailers.get('grpc-status-details-bin')).to.equal('dummy-value');
});

测试反应

在多响应消息的情况下（服务器请求或双向流方法），本节中的测试检查给定断言的所有消息。对于只有一个响应消息的一元或客户端流方法的请求，断言仅在该单个消息上进行测试。

此外，在使用 编写断言时pm.response.messages.to.*，您将对一组消息内容而不是完整的pm.response消息对象进行断言。

您可以使用对象测试本节中关于请求消息的断言pm.request。

测试消息的存在

要测试响应消息的存在（严格）：

pm.test('Correct user details are received', () => {
  pm.response.to.have.message({
    userId: '123',
    name: 'John Doe',
    email: 'john@example.com',
    phone: '+1-555-555-5555',
    age: 30,
    company: 'XYZ'
  });
});

测试具有特定属性的消息

您可以断言给定对象的属性是作为响应收到的任何消息的子集：

pm.test('User details are updated successfully', () => {
  pm.response.messages.to.include({
    action: 'update-user-details',
    status: 'success'
  });
});

默认情况下，pm.response.messages.to.include()已.deep应用于它。

测试所有消息的公共属性

检查所有接收到的消息中是否存在公共属性：

pm.test('All users have "company" in their profile', () => {
  pm.response.messages.to.have.property('isActive');
});

您也可以断言公共属性的值：

pm.test('All users are in same company', () => {
  pm.response.messages.to.have.property('company', 'XYZ');
});

默认情况下，pm.response.messages.to.have.property()已.deep应用于.nested它。

针对 JSON 模式测试消息

您可以断言接收到的消息与给定的 JSON 模式匹配：

const schema = {
  type: "object",
  properties: {
    username: {
      type: "string",
      pattern: "^[a-z0-9_-]{3,16}$"
    }
  }
};

pm.test('All response messages have correct username', () => {
  pm.response.messages.to.have.jsonSchema(schema);
});

pm.test('Assert on a specific message', () => {
  pm.expect(pm.response.messages.idx(10).data).to.have.jsonSchema(schema);
});

使用消息流

下面的示例展示了如何处理消息流并在其上编写断言。

pm.test('Should receive keep-alive message roughly every 5 seconds', () => {
  const keepAliveMessage = pm.response.messages.filter({
    data: {
      type: 'keep-alive'
    }
  });

  for (let i = 1; i < keepAliveMessage.length; i++) {
    const time1 = keepAliveMessage[i-1].timestamp;
    const time2 = keepAliveMessage[i].timestamp;

    pm.expect(time2-time1).to.be.within(4800, 5200);
  }
});

pm.test('Every request message should have a corresponding response message', () => {
  pm.request.messages.each((reqMsg) => {
    pm.response.messages.to.include({ id: reqMsg.data.id });
  });
});