class Assert

Assertion test helpers.

Constants

private EPSILON

used by equal() for comparing floats

Properties

static $patterns

used by match(); in values, each $ followed by number is backreference

static callable $onFailure
static int $counter

Methods

static void
same($expected, $actual, string $description = null)

Asserts that two values are equal and have the same type and identity of objects.

static void
notSame($expected, $actual, string $description = null)

Asserts that two values are not equal or do not have the same type and identity of objects.

static void
equal($expected, $actual, string $description = null)

Asserts that two values are equal and checks expectations. The identity of objects, the order of keys in the arrays and marginally different floats are ignored.

static void
notEqual($expected, $actual, string $description = null)

Asserts that two values are not equal and checks expectations. The identity of objects, the order of keys in the arrays and marginally different floats are ignored.

static void
contains(mixed $needle, array|string $actual, string $description = null)

Asserts that a haystack (string or array) contains an expected needle.

static void
notContains(mixed $needle, array|string $actual, string $description = null)

Asserts that a haystack (string or array) does not contain an expected needle.

static void
true(mixed $actual, string $description = null)

Asserts that a value is true.

static void
false(mixed $actual, string $description = null)

Asserts that a value is false.

static void
null(mixed $actual, string $description = null)

Asserts that a value is null.

static void
notNull(mixed $actual, string $description = null)

Asserts that a value is not null.

static void
nan(mixed $actual, string $description = null)

Asserts that a value is Not a Number.

static void
truthy(mixed $actual, string $description = null)

Asserts that a value is truthy.

static void
falsey(mixed $actual, string $description = null)

Asserts that a value is falsey.

static void
count(int $count, array|Countable $value, string $description = null)

Asserts the number of items in an array or Countable.

static void
type(string|object $type, mixed $value, string $description = null)

Asserts that a value is of given class, interface or built-in type.

static Throwable|null
exception(callable $function, string $class, string $message = null, $code = null)

Asserts that a function throws exception of given type and its message matches given pattern.

static Throwable|null
throws(callable $function, string $class, string $message = null, $code = null)

Asserts that a function throws exception of given type and its message matches given pattern. Alias for exception().

static Throwable|null
error(callable $function, int|string|array $expectedType, string $expectedMessage = null)

Asserts that a function generates one or more PHP errors or throws exceptions.

static void
noError(callable $function)

Asserts that a function does not generate PHP errors and does not throw exceptions.

static void
match(string $pattern, $actual, string $description = null)

Asserts that a string matches a given pattern.

static void
matchFile(string $file, $actual, string $description = null)

Asserts that a string matches a given pattern stored in file.

static void
fail(string $message, $actual = null, $expected = null, Throwable $previous = null)

Assertion that fails.

static 
with($objectOrClass, Closure $closure)

Executes function that can access private and protected members of given object via $this.

static bool
isMatching(string $pattern, $actual, bool $strict = false)

Compares using mask.

static array
expandMatchingPatterns(string $pattern, $actual)

No description

Details

at line 53
static void same($expected, $actual, string $description = null)

Asserts that two values are equal and have the same type and identity of objects.

Parameters

$expected
$actual
string $description

Return Value

void

at line 65
static void notSame($expected, $actual, string $description = null)

Asserts that two values are not equal or do not have the same type and identity of objects.

Parameters

$expected
$actual
string $description

Return Value

void

at line 78
static void equal($expected, $actual, string $description = null)

Asserts that two values are equal and checks expectations. The identity of objects, the order of keys in the arrays and marginally different floats are ignored.

Parameters

$expected
$actual
string $description

Return Value

void

at line 91
static void notEqual($expected, $actual, string $description = null)

Asserts that two values are not equal and checks expectations. The identity of objects, the order of keys in the arrays and marginally different floats are ignored.

Parameters

$expected
$actual
string $description

Return Value

void

at line 109
static void contains(mixed $needle, array|string $actual, string $description = null)

Asserts that a haystack (string or array) contains an expected needle.

Parameters

mixed $needle
array|string $actual
string $description

Return Value

void

at line 134
static void notContains(mixed $needle, array|string $actual, string $description = null)

Asserts that a haystack (string or array) does not contain an expected needle.

Parameters

mixed $needle
array|string $actual
string $description

Return Value

void

at line 158
static void true(mixed $actual, string $description = null)

Asserts that a value is true.

Parameters

mixed $actual
string $description

Return Value

void

at line 171
static void false(mixed $actual, string $description = null)

Asserts that a value is false.

Parameters

mixed $actual
string $description

Return Value

void

at line 184
static void null(mixed $actual, string $description = null)

Asserts that a value is null.

Parameters

mixed $actual
string $description

Return Value

void

at line 197
static void notNull(mixed $actual, string $description = null)

Asserts that a value is not null.

Parameters

mixed $actual
string $description

Return Value

void

at line 210
static void nan(mixed $actual, string $description = null)

Asserts that a value is Not a Number.

Parameters

mixed $actual
string $description

Return Value

void

at line 223
static void truthy(mixed $actual, string $description = null)

Asserts that a value is truthy.

Parameters

mixed $actual
string $description

Return Value

void

at line 236
static void falsey(mixed $actual, string $description = null)

Asserts that a value is falsey.

Parameters

mixed $actual
string $description

Return Value

void

at line 249
static void count(int $count, array|Countable $value, string $description = null)

Asserts the number of items in an array or Countable.

Parameters

int $count
array|Countable $value
string $description

Return Value

void

at line 266
static void type(string|object $type, mixed $value, string $description = null)

Asserts that a value is of given class, interface or built-in type.

Parameters

string|object $type
mixed $value
string $description

Return Value

void

at line 295
static Throwable|null exception(callable $function, string $class, string $message = null, $code = null)

Asserts that a function throws exception of given type and its message matches given pattern.

Parameters

callable $function
string $class
string $message
$code

Return Value

Throwable|null

at line 326
static Throwable|null throws(callable $function, string $class, string $message = null, $code = null)

Asserts that a function throws exception of given type and its message matches given pattern. Alias for exception().

Parameters

callable $function
string $class
string $message
$code

Return Value

Throwable|null

at line 339
static Throwable|null error(callable $function, int|string|array $expectedType, string $expectedMessage = null)

Asserts that a function generates one or more PHP errors or throws exceptions.

Parameters

callable $function
int|string|array $expectedType
string $expectedMessage message

Return Value

Throwable|null

Exceptions

Exception
Exception

at line 396
static void noError(callable $function)

Asserts that a function does not generate PHP errors and does not throw exceptions.

Parameters

callable $function

Return Value

void

at line 423
static void match(string $pattern, $actual, string $description = null)

Asserts that a string matches a given pattern.

%a% one or more of anything except the end of line characters %a?% zero or more of anything except the end of line characters %A% one or more of anything including the end of line characters %A?% zero or more of anything including the end of line characters %s% one or more white space characters except the end of line characters %s?% zero or more white space characters except the end of line characters %S% one or more of characters except the white space %S?% zero or more of characters except the white space %c% a single character of any sort (except the end of line) %d% one or more digits %d?% zero or more digits %i% signed integer value %f% floating point number %h% one or more HEX digits

Parameters

string $pattern

mask|regexp; only delimiters ~ and # are supported for regexp

$actual
string $description

Return Value

void

at line 439
static void matchFile(string $file, $actual, string $description = null)

Asserts that a string matches a given pattern stored in file.

Parameters

string $file
$actual
string $description

Return Value

void

at line 459
static void fail(string $message, $actual = null, $expected = null, Throwable $previous = null)

Assertion that fails.

Parameters

string $message
$actual
$expected
Throwable $previous

Return Value

void

at line 480
static with($objectOrClass, Closure $closure)

Executes function that can access private and protected members of given object via $this.

Parameters

$objectOrClass
Closure $closure

at line 493
static bool isMatching(string $pattern, $actual, bool $strict = false)

internal  
 

Compares using mask.

Parameters

string $pattern
$actual
bool $strict

Return Value

bool

at line 531
static array expandMatchingPatterns(string $pattern, $actual)

internal  
 

No description

Parameters

string $pattern
$actual

Return Value

array