Wraps the response in an envelope.
Description
The enveloping technique is used to work around browser/client compatibility issues. Essentially, it converts the full HTTP response to data instead.
Parameters
$response
WP_REST_Responserequired- Response object.
$embed
bool|string[]required- Whether to embed all links, a filtered list of link relations, or no links.
Source
public function envelope_response( $response, $embed ) { $envelope = array( 'body' => $this->response_to_data( $response, $embed ), 'status' => $response->get_status(), 'headers' => $response->get_headers(), ); /** * Filters the enveloped form of a REST API response. * * @since 4.4.0 * * @param array $envelope { * Envelope data. * * @type array $body Response data. * @type int $status The 3-digit HTTP status code. * @type array $headers Map of header name to header value. * } * @param WP_REST_Response $response Original response data. */ $envelope = apply_filters( 'rest_envelope_response', $envelope, $response ); // Ensure it's still a response and return. return rest_ensure_response( $envelope ); }
Hooks
- apply_filters( ‘rest_envelope_response’,
array $envelope ,WP_REST_Response $response ) Filters the enveloped form of a REST API response.
User Contributed Notes
You must log in before being able to contribute a note or feedback.