Question

处理传出响应的规则。

route.options.response.disconnectStatusCode

Default value: 499 .

默认 HTTP 状态代码，用于在完全传输响应之前关闭或中止请求时设置响应错误。值可以是大于或等于 400 的任何整数。 默认值 499 基于非标准 nginx "CLIENT CLOSED REQUEST" 错误。该值仅用于请求已结束的日志记录。

route.options.response.emptyStatusCode

默认值: 200 .

当有 payload 为空时的默认 HTTP 状态代码。值可以是 200 或 204 。注意，仅在响应传输时将 200 状态代码转换为 204 （除非手动设置，否则响应状态代码将在整个请求生命周期内保持为 200 ）。

route.options.response.failAction

默认值: 'error' (返回一个 Internal Server Error (500) 错误响应).

一个 failAction value ，它定义了响应失败有 payload 验证时要执行的操作。

route.options.response.modify

默认值: false .

如果为 true ，则将验证规则更改应用于响应有效内容。

route.options.response.options

默认值: none.

joi 选项对象传递给验证函数.用于设置全局选项，例如 stripUnknown 或 abortEarly (完整的列表如下 here ). 如果通过 schema 或 status 定义自定义验证函数，则 options 可以是任意对象 传递给这个函数作为第二个参数。

route.options.response.ranges

默认值: true .

如果为“false”，则禁用 payload range 支持。

route.options.response.sample

默认值: 100 (all responses).

验证响应有效负载的百分比 (0 - 100). 设置为 0 以禁用所有验证。

route.options.response.schema

默认值: true (no validation).

默认响应 payload 验证规则（针对所有非错误响应）表示为以下之一：

• true - 允许的任何 payload（无验证）。

• false - 不允许 payload。

• 一个 joi 验证对象. options 以及请求上下文（ ( { headers, params, query, payload, state, app, auth } ) 被传递给验证函数。

• 使用签名 async function(value, options) 的验证函数，其中：

  • value - 挂起的响应 payload。

  • options - The options 以及请求上下文 ( { headers, params, query, payload, state, app, auth } ).

  • 如果函数返回一个值并且 modify 为 true ，该值用作新响应。 如果原始响应是错误的，返回值用于覆盖原始错误 output.payload 。如果抛出错误， 根据 failAction 处理错误。

route.options.response.status

默认值: none.

特定 HTTP 状态代码的验证模式。 使用默认的 schema 验证与列出的状态代码不匹配的响应（不包括错误）。

status 设置为一个对象，其中每个键是一个 3 位 HTTP 状态代码，该值与 schema . 具有相同的定义。