class TestResponse (View source)

Traits

Properties

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

Methods

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

Register a custom macro.

from Macroable
static void
mixin(object $mixin)

Mix another object into the class.

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
assertOk()

Assert that the response has a 200 status code.

$this
assertNotFound()

Assert that the response has a not found status code.

$this
assertForbidden()

Assert that the response has a forbidden 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
assertHeaderMissing(string $headerName)

Asserts that the response does not contains the given header.

$this
assertLocation(string $uri)

Assert that the current location header matches the given URI.

$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, bool $unserialize = false)

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

$this
assertCookieExpired(string $cookieName)

Asserts that the response contains the given cookie and is expired.

$this
assertCookieNotExpired(string $cookieName)

Asserts that the response contains the given cookie and is not expired.

$this
assertCookieMissing(string $cookieName)

Asserts that the response does not contains the given cookie.

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
assertSeeInOrder(array $values)

Assert that the given strings are contained in order within the response.

$this
assertSeeText(string $value)

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

$this
assertSeeTextInOrder(array $values)

Assert that the given strings are contained in order 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, bool $strict = false)

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, bool $exact = false)

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

$this
assertJsonMissingExact(array $data)

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

array
jsonSearchStrings(string $key, string $value)

Get the strings we need to search for when examining the JSON.

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

Assert that the response has a given JSON structure.

$this
assertJsonCount(int $count, string|null $key = null)

Assert that the response JSON has the expected count of items at the given key.

$this
assertJsonValidationErrors(string|array $keys)

Assert that the response has the given JSON validation errors for the given keys.

$this
assertJsonMissingValidationErrors(string|array $keys)

Assert that the response has no JSON validation errors for the given keys.

mixed
decodeResponseJson(string|null $key = null)

Validate and return the decoded response JSON.

mixed
json(string|null $key = null)

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, string $errorBag = 'default')

Assert that the session has the given errors.

$this
assertSessionHasNoErrors()

Assert that the session has no errors.

$this
assertSessionHasErrorsIn(string $errorBag, 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.

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, object|callable $macro)

Register a custom macro.

Parameters

string $name
object|callable $macro

Return Value

void

static void mixin(object $mixin)

Mix another object into the class.

Parameters

object $mixin

Return Value

void

Exceptions

ReflectionException

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 assertOk()

Assert that the response has a 200 status code.

Return Value

$this

$this assertNotFound()

Assert that the response has a not found status code.

Return Value

$this

$this assertForbidden()

Assert that the response has a forbidden 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 assertHeaderMissing(string $headerName)

Asserts that the response does not contains the given header.

Parameters

string $headerName

Return Value

$this

$this assertLocation(string $uri)

Assert that the current location header matches the given URI.

Parameters

string $uri

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, bool $unserialize = false)

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

Parameters

string $cookieName
mixed $value
bool $encrypted
bool $unserialize

Return Value

$this

$this assertCookieExpired(string $cookieName)

Asserts that the response contains the given cookie and is expired.

Parameters

string $cookieName

Return Value

$this

$this assertCookieNotExpired(string $cookieName)

Asserts that the response contains the given cookie and is not expired.

Parameters

string $cookieName

Return Value

$this

$this assertCookieMissing(string $cookieName)

Asserts that the response does not contains the given cookie.

Parameters

string $cookieName

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 assertSeeInOrder(array $values)

Assert that the given strings are contained in order within the response.

Parameters

array $values

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 assertSeeTextInOrder(array $values)

Assert that the given strings are contained in order within the response text.

Parameters

array $values

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, bool $strict = false)

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

Parameters

array $data
bool $strict

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, bool $exact = false)

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

Parameters

array $data
bool $exact

Return Value

$this

$this assertJsonMissingExact(array $data)

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

Parameters

array $data

Return Value

$this

protected array jsonSearchStrings(string $key, string $value)

Get the strings we need to search for when examining the JSON.

Parameters

string $key
string $value

Return Value

array

$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

$this assertJsonCount(int $count, string|null $key = null)

Assert that the response JSON has the expected count of items at the given key.

Parameters

int $count
string|null $key

Return Value

$this

$this assertJsonValidationErrors(string|array $keys)

Assert that the response has the given JSON validation errors for the given keys.

Parameters

string|array $keys

Return Value

$this

$this assertJsonMissingValidationErrors(string|array $keys)

Assert that the response has no JSON validation errors for the given keys.

Parameters

string|array $keys

Return Value

$this

mixed decodeResponseJson(string|null $key = null)

Validate and return the decoded response JSON.

Parameters

string|null $key

Return Value

mixed

mixed json(string|null $key = null)

Validate and return the decoded response JSON.

Parameters

string|null $key

Return Value

mixed

$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, string $errorBag = 'default')

Assert that the session has the given errors.

Parameters

string|array $keys
mixed $format
string $errorBag

Return Value

$this

$this assertSessionHasNoErrors()

Assert that the session has no errors.

Return Value

$this

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

Assert that the session has the given errors.

Parameters

string $errorBag
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