TestResponse

class TestResponse (View source)

Traits

Macroable

Properties

static protected array $macros The registered string macros. from Macroable
Response $baseResponse The response to delegate to.

Methods

static void macro(string $name, callable $macro)

Register a custom macro.

 from Macroable
static bool hasMacro(string $name)

Checks if macro is registered.

 from Macroable
static mixed __callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

 from Macroable
mixed __call(string $method, array $args)

Handle dynamic calls into macros or pass missing methods to the base response.
void __construct(Response $response)

Create a new test response instance.
static TestResponse fromBaseResponse(Response $response)

Create a new TestResponse from another response.
$this assertSuccessful()

Assert that the response has a successful status code.
$this assertStatus(int $status)

Assert that the response has the given status code.
$this assertRedirect(string $uri = null)

Assert whether the response is redirecting to a given URI.
$this assertHeader(string $headerName, mixed $value = null)

Asserts that the response contains the given header and equals the optional value.
$this assertPlainCookie(string $cookieName, mixed $value = null)

Asserts that the response contains the given cookie and equals the optional value.
$this assertCookie(string $cookieName, mixed $value = null, bool $encrypted = true)

Asserts that the response contains the given cookie and equals the optional value.
Cookie|null getCookie(string $cookieName)

Get the given cookie from the response.
$this assertSee(string $value)

Assert that the given string is contained within the response.
$this assertSeeText(string $value)

Assert that the given string is contained within the response text.
$this assertDontSee(string $value)

Assert that the given string is not contained within the response.
$this assertDontSeeText(string $value)

Assert that the given string is not contained within the response text.
$this assertJson(array $data)

Assert that the response is a superset of the given JSON.
string assertJsonMessage(array $data)

Get the assertion message for assertJson.
$this assertExactJson(array $data)

Assert that the response has the exact given JSON.
$this assertJsonFragment(array $data)

Assert that the response contains the given JSON fragment.
$this assertJsonMissing(array $data)

Assert that the response does not contain the given JSON fragment.
$this assertJsonStructure(array $structure = null, array|null $responseData = null)

Assert that the response has a given JSON structure.
array decodeResponseJson()

Validate and return the decoded response JSON.
array json()

Validate and return the decoded response JSON.
$this assertViewIs(string $value)

Assert that the response view equals the given value.
$this assertViewHas(string|array $key, mixed $value = null)

Assert that the response view has a given piece of bound data.
$this assertViewHasAll(array $bindings)

Assert that the response view has a given list of bound data.
$this assertViewMissing(string $key)

Assert that the response view is missing a piece of bound data.
$this ensureResponseHasView()

Ensure that the response has a view as its original content.
$this assertSessionHas(string|array $key, mixed $value = null)

Assert that the session has a given value.
$this assertSessionHasAll(array $bindings)

Assert that the session has a given list of values.
$this assertSessionHasErrors(string|array $keys = [], mixed $format = null)

Assert that the session has the given errors.
$this assertSessionMissing(string|array $key)

Assert that the session does not have a given key.
Store session()

Get the current session store.
void dump()

Dump the content from the response.
mixed __get(string $key)

Dynamically access base response parameters.
mixed __isset(string $key)

Proxy isset() checks to the underlying base response.

Details

static void macro(string $name, callable $macro)

Register a custom macro.

Parameters

string $name
callable $macro

Return Value

void

static bool hasMacro(string $name)

Checks if macro is registered.

Parameters

string $name

Return Value

bool

static mixed __callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

mixed __call(string $method, array $args)

Handle dynamic calls into macros or pass missing methods to the base response.

Parameters

string $method
array $args

Return Value

mixed

void __construct(Response $response)

Create a new test response instance.

Parameters

Response $response

Return Value

void

static TestResponse fromBaseResponse(Response $response)

Create a new TestResponse from another response.

Parameters

Response $response

Return Value

TestResponse

$this assertSuccessful()

Assert that the response has a successful status code.

Return Value

$this

$this assertStatus(int $status)

Assert that the response has the given status code.

Parameters

int $status

Return Value

$this

$this assertRedirect(string $uri = null)

Assert whether the response is redirecting to a given URI.

Parameters

string $uri

Return Value

$this

$this assertHeader(string $headerName, mixed $value = null)

Asserts that the response contains the given header and equals the optional value.

Parameters

string $headerName
mixed $value

Return Value

$this

$this assertPlainCookie(string $cookieName, mixed $value = null)

Asserts that the response contains the given cookie and equals the optional value.

Parameters

string $cookieName
mixed $value

Return Value

$this

$this assertCookie(string $cookieName, mixed $value = null, bool $encrypted = true)

Asserts that the response contains the given cookie and equals the optional value.

Parameters

string $cookieName
mixed $value
bool $encrypted

Return Value

$this

protected Cookie|null getCookie(string $cookieName)

Get the given cookie from the response.

Parameters

string $cookieName

Return Value

Cookie|null

$this assertSee(string $value)

Assert that the given string is contained within the response.

Parameters

string $value

Return Value

$this

$this assertSeeText(string $value)

Assert that the given string is contained within the response text.

Parameters

string $value

Return Value

$this

$this assertDontSee(string $value)

Assert that the given string is not contained within the response.

Parameters

string $value

Return Value

$this

$this assertDontSeeText(string $value)

Assert that the given string is not contained within the response text.

Parameters

string $value

Return Value

$this

$this assertJson(array $data)

Assert that the response is a superset of the given JSON.

Parameters

array $data

Return Value

$this

protected string assertJsonMessage(array $data)

Get the assertion message for assertJson.

Parameters

array $data

Return Value

string

$this assertExactJson(array $data)

Assert that the response has the exact given JSON.

Parameters

array $data

Return Value

$this

$this assertJsonFragment(array $data)

Assert that the response contains the given JSON fragment.

Parameters

array $data

Return Value

$this

$this assertJsonMissing(array $data)

Assert that the response does not contain the given JSON fragment.

Parameters

array $data

Return Value

$this

$this assertJsonStructure(array $structure = null, array|null $responseData = null)

Assert that the response has a given JSON structure.

Parameters

array $structure
array|null $responseData

Return Value

$this

array decodeResponseJson()

Validate and return the decoded response JSON.

Return Value

array

array json()

Validate and return the decoded response JSON.

Return Value

array

$this assertViewIs(string $value)

Assert that the response view equals the given value.

Parameters

string $value

Return Value

$this

$this assertViewHas(string|array $key, mixed $value = null)

Assert that the response view has a given piece of bound data.

Parameters

string|array $key
mixed $value

Return Value

$this

$this assertViewHasAll(array $bindings)

Assert that the response view has a given list of bound data.

Parameters

array $bindings

Return Value

$this

$this assertViewMissing(string $key)

Assert that the response view is missing a piece of bound data.

Parameters

string $key

Return Value

$this

protected $this ensureResponseHasView()

Ensure that the response has a view as its original content.

Return Value

$this

$this assertSessionHas(string|array $key, mixed $value = null)

Assert that the session has a given value.

Parameters

string|array $key
mixed $value

Return Value

$this

$this assertSessionHasAll(array $bindings)

Assert that the session has a given list of values.

Parameters

array $bindings

Return Value

$this

$this assertSessionHasErrors(string|array $keys = [], mixed $format = null)

Assert that the session has the given errors.

Parameters

string|array $keys
mixed $format

Return Value

$this

$this assertSessionMissing(string|array $key)

Assert that the session does not have a given key.

Parameters

string|array $key

Return Value

$this

protected Store session()

Get the current session store.

Return Value

Store

void dump()

Dump the content from the response.

Return Value

void

mixed __get(string $key)

Dynamically access base response parameters.

Parameters

string $key

Return Value

mixed

mixed __isset(string $key)

Proxy isset() checks to the underlying base response.

Parameters

string $key

Return Value

mixed

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.4/Illuminate/Foundation/Testing/TestResponse.html