Класс TestCase
Класс Cake TestCase
- PHPUnit\Framework\TestCase
-
Cake\TestSuite\TestCase использует Cake\ORM\Locator\LocatorAwareTrait
Прямые подклассы
Краткое описание свойств
-
$_configureprotectedЗначения настроек для восстановления в конце теста.array -
$_pathRestoreprotectedНастройки путей для восстановления в конце теста.array -
$autoFixturespublicbooleanПо умолчанию все фикстуры, присоединённые к этому классу, будут обнулены и перезагружены после каждого теста. Установите в значение false, чтобы обработать вручную
-
$dropTablespublicУправление созданием/удалением таблиц для каждого метода теста.boolean - Класс, отвечающий за управление созданием, загрузкой и удалением фикстур
$fixtureManagerpublic
Унаследованные свойства
Краткое описание методов
- _assertAttributes() protectedПроверка атрибутов в рамках проверки assertTags().
- _getTableClassName() protectedПолучение имени класса для таблицы.
- _normalizePath() protectedНормализация пути для сравнения.
- assertEventFired() publicПроверяет, был ли вызван глобальный событие. Для работы этой проверки необходимо отслеживать события в вашем диспетчере событий.
- assertEventFiredWith() publicПроверяет, был ли вызван событие с данными
- assertHtml() publicПроверка HTML тегов.
- Функция совместимости для проверки, что значение не находится в допустимом диапазоне.
- Функция совместимости для проверки путей.
- Проверка HTML тегов.
- assertTextContains() public
Проверить, содержит ли строка другую строку, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextEndsNotWith() public
Проверяет, что строка не заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextEndsWith() public
Проверяет, что строка заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextEquals() public
Проверка равенства текста, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextNotContains() public
Проверить, что текст не содержит другой текст, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextNotEquals() public
Проверка равенства текста, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextStartsNotWith() public
Проверяет, что строка не начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextStartsWith() public
Проверяет, что строка начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.
- Функция совместимости для проверки, что значение находится в допустимом диапазоне.
- clearPlugins() publicОчистить все плагины из глобальной коллекции плагинов.
- deprecated() publicВспомогательный метод для проверки методов устаревания
- getMockForModel() publicСоздать модель-заглушку, сохранить фикстуры и ассоциации таблиц
- loadFixtures() publicВыбор фикстур для загрузки для данного теста
- loadPlugins() publicЗагрузка плагинов в имитируемое приложение.
- removePlugins() publicУдалить плагины из глобальной коллекции плагинов.
- Установить имя пространства приложения
- setUp() public
Настройка тестового случая, резервное копирование статических значений объекта, чтобы они могли быть восстановлены. В частности, создает резервную копию содержимого Configure и путей в App, если они еще не были скопированы.
- skipIf() publicПереопределяет SimpleTestCase::skipIf, чтобы предоставить логическое возвращаемое значение
- skipUnless() protectedФункция совместимости для пропуска.
- tearDown() publicРазборка любых изменений статических объектов и их восстановление.
- withErrorReporting() publicВспомогательный метод для тестов, которые необходимо использовать error_reporting()
Подробное описание методов
_assertAttributes()исходный код protected
_assertAttributes( array $assertions , string $string , boolean $fullDebug = false , array|string $regex = '' )
Проверка атрибутов в рамках проверки assertTags().
Параметры
- массив
$assertions - Проверки для выполнения.
- строка
$string - Строка HTML для проверки.
- логическое
$fullDebugнеобязательно false - Использовать ли более подробный вывод.
- массив|строка
$regexнеобязательно '' - Полный регулярное выражение из
assertHtml
Возвращаемое значение
строка|логическое значение_getTableClassName()исходный код protected
_getTableClassName( string $alias , array $options )
Получение имени класса для таблицы.
Параметры
- строка
$alias - Модель для создания заглушки.
- массив
$options - Данные конфигурации для конструктора заглушки.
Возвращаемое значение
строкаИсключения
Cake\ORM\Exception\MissingTableClassException_normalizePath()исходный код protected
_normalizePath( string $path )
Нормализация пути для сравнения.
Параметры
- строка
$path - Путь, разделённый слэшами "/".
Возвращаемое значение
строкаНормализованный путь, разделённый DIRECTORY_SEPARATOR.
assertEventFired()source public
assertEventFired( string $name , Cake\Event\EventManager|null $eventManager = null , string $message = '' )
Утверждает, что глобальное событие было сгенерировано. Для работы этого утверждения вы должны отслеживать события в вашем обработчике событий.
Параметры
- строка
$name - Имя события
-
Cake\Event\EventManager|null$eventManagerнеобязательный null - Обработчик событий для проверки, по умолчанию используется глобальный обработчик событий
- строка
$messageнеобязательный '' - Сообщение об ошибке утверждения
assertEventFiredWith()source public
assertEventFiredWith( string $name , string $dataKey , string $dataValue , Cake\Event\EventManager|null $eventManager = null , string $message = '' )
Утверждает, что событие было сгенерировано с данными.
Если в качестве третьего аргумента передаётся значение, оно используется для сравнения со значением в $dataKey.
Параметры
- строка
$name - Имя события
- строка
$dataKey - Ключ данных
- строка
$dataValue - Значение данных
-
Cake\Event\EventManager|null$eventManagerнеобязательный null - Обработчик событий для проверки, по умолчанию используется глобальный обработчик событий
- строка
$messageнеобязательный '' - Сообщение об ошибке утверждения
assertHtml()source public
assertHtml( array $expected , string $string , boolean $fullDebug = false )
Утверждает теги HTML.
Принимает массив $expected и генерирует регулярное выражение для сопоставления с предоставленной строкой $string. Примеры для $expected:
Проверяет наличие тега input с атрибутом name (содержащим любое ненулевое значение) и атрибутом id, содержащим 'my-input':
['input' => ['name', 'id' => 'my-input']]
Проверяет наличие двух тегов p с некоторым текстом внутри:
[ ['p' => true], 'textA', '/p', ['p' => true], 'textB', '/p' ]
Вы также можете указать выражение шаблона в качестве части значений атрибутов или определяемого тега, если вы добавите значение с префиксом preg: и заключите его в косые черты, например:
[ ['input' => ['name', 'id' => 'preg:/FieldName\d+/']], 'preg:/My\s+field/' ]
Важно: эта функция очень лояльна к пробелам и также принимает любую перестановку порядка атрибутов. Она также позволит использовать пробелы между указанными тегами.
Параметры
- массив
$expected - Массив, см. выше
- строка
$string - Строка HTML/XHTML/XML
- логическое значение
$fullDebugнеобязательный false - Используется ли более подробный вывод.
Возвращаемое значение
booleanassertNotWithinRange()source protected static
assertNotWithinRange( float $expected , float $result , float $margin , string $message = '' )
Функция совместимости для проверки, не находится ли значение в допустимом диапазоне.
Параметры
- число с плавающей точкой
$expected - число с плавающей точкой
$result - число с плавающей точкой
$margin - диапазон приемлемости
- строка
$messageнеобязательный '' - текст для отображения, если утверждение неверно
assertPathEquals()source protected static
assertPathEquals( string $expected , string $result , string $message = '' )
Функция совместимости для проверки путей.
Параметры
- строка
$expected - строка
$result - строка
$messageнеобязательный '' - текст для отображения, если утверждение неверно
assertTags()source public deprecated
assertTags( string $string , array $expected , boolean $fullDebug = false )
Утверждает теги HTML.
Устарело
3.0. Используйте assertHtml() вместо этого.Параметры
- строка
$string - Строка HTML/XHTML/XML
- массив
$expected - Массив, см. выше
- логическое значение
$fullDebugнеобязательный false - Используется ли более подробный вывод.
assertTextContains()source public
assertTextContains( string $needle , string $haystack , string $message = '' , boolean $ignoreCase = false )
Утверждает, что строка содержит другую строку, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$needle - Строка, которую нужно найти.
- строка
$haystack - Строка, в которой нужно искать.
- строка
$messageнеобязательный '' - Сообщение для отображения при ошибке.
- логическое значение
$ignoreCaseнеобязательный false - Является ли поиск регистрозависимым.
assertTextEndsNotWith()source public
assertTextEndsNotWith( string $suffix , string $string , string $message = '' )
Утверждает, что строка не заканчивается заданным префиксом, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$suffix - Суффикс, который не должен быть найден.
- строка
$string - Строка для поиска.
- строка
$messageнеобязательный '' - Сообщение для использования при ошибке.
assertTextEndsWith()source public
assertTextEndsWith( string $suffix , string $string , string $message = '' )
Утверждает, что строка заканчивается заданным префиксом, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$suffix - Суффикс, который должен быть найден.
- строка
$string - Строка для поиска.
- строка
$messageнеобязательный '' - Сообщение для использования при ошибке.
assertTextEquals()source public
assertTextEquals( string $expected , string $result , string $message = '' )
Утверждает равенство текста, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$expected - Ожидаемое значение.
- строка
$result - Фактическое значение.
- строка
$messageнеобязательный '' - Сообщение для использования при ошибке.
assertTextNotContains()source public
assertTextNotContains( string $needle , string $haystack , string $message = '' , boolean $ignoreCase = false )
Утверждает, что текст не содержит другой текст, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$needle - Строка, которую нужно найти.
- строка
$haystack - Строка, в которой нужно искать.
- строка
$messageнеобязательный '' - Сообщение для отображения при ошибке.
- логическое значение
$ignoreCaseнеобязательный false - Является ли поиск регистрозависимым.
assertTextNotEquals()source public
assertTextNotEquals( string $expected , string $result , string $message = '' )
Утверждает неравенство текста, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$expected - Ожидаемое значение.
- строка
$result - Фактическое значение.
- строка
$messageнеобязательный '' - Сообщение для использования при ошибке.
assertTextStartsNotWith()source public
assertTextStartsNotWith( string $prefix , string $string , string $message = '' )
Утверждает, что строка не начинается с заданного префикса, игнорируя различия в символах новой строки. Это полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$prefix - Префикс, который не должен быть найден.
- строка
$string - Строка для поиска.
- строка
$messageнеобязательный '' - Сообщение для использования при ошибке.
assertTextStartsWith()source public
assertTextStartsWith( string $prefix , string $string , string $message = '' )
Утверждает, что строка начинается с заданного префикса, игнорируя различия в новых строках. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс для проверки.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertWithinRange()source protected static
assertWithinRange( float $expected , float $result , float $margin , string $message = '' )
Функция совместимости для проверки, находится ли значение в приемлемом диапазоне.
Параметры
- float
$expected - float
$result - float
$margin - диапазон приемлемости
- string
$messageнеобязательно '' - текст для отображения, если утверждение неверно
clearPlugins()source public
clearPlugins( )
Очистить все плагины из глобальной коллекции плагинов.
Полезно в методах завершения работы тестовых случаев.
deprecated()source public
deprecated( callable $callable )
Вспомогательный метод для проверки методов устаревания
Параметры
- callable
$callable - вызываемая функция, которая получит утверждения
getMockForModel()source public
getMockForModel( string $alias , array|null $methods = [] , array $options = [] )
Создать макет модели, сохранить фикстуры и связи таблиц
Параметры
- string
$alias - Модель для создания макета.
- array|null
$methodsнеобязательно [] - Список методов для создания макета
- array
$optionsнеобязательно [] - Данные конфигурации для конструктора макета.
Возвращает
Cake\ORM\Table|PHPUnit_Framework_MockObject_MockObjectВыбрасывает
Cake\ORM\Exception\MissingTableClassExceptionloadFixtures()source public
loadFixtures( )
Выбирает фикстуры, которые нужно загрузить для данного теста
Каждый параметр — имя модели, соответствующее фикстуре, т. е. «Posts», «Authors» и т. д. Передача без параметров приведет к загрузке всех фикстур в тестовом случае.
Выбрасывает
Исключениеесли менеджер фикстур недоступен.
См. также
\Cake\TestSuite\TestCase::$autoFixturesloadPlugins()source public
loadPlugins( array $plugins = [] )
Загрузить плагины в имитируемое приложение.
Полезно для тестирования того, как взаимодействуют плагины, загружаемые/не загружаемые с другими элементами CakePHP или приложениями.
Параметры
- array
$pluginsнеобязательно [] - Список плагинов для загрузки.
Возвращает
Cake\Http\BaseApplicationremovePlugins()source public
removePlugins( array $plugins = [] )
Удалить плагины из глобальной коллекции плагинов.
Полезно в методах завершения работы тестовых случаев.
Параметры
- array
$pluginsнеобязательно [] - Список плагинов, которые нужно удалить.
setAppNamespace()source public static
setAppNamespace( string $appNamespace = 'TestApp' )
Установить пространство имен приложения
Параметры
- string
$appNamespaceнеобязательно 'TestApp' - Пространство имен приложения, по умолчанию «TestApp».
setUp()source public
setUp( )
Настройка тестового случая, резервное копирование значений статических объектов для их последующего восстановления. В частности, резервирует содержимое Configure и пути в App, если они еще не были резервными.
skipIf()source public
skipIf( boolean $shouldSkip , string $message = '' )
Переопределяет SimpleTestCase::skipIf, чтобы обеспечить булево значение возвращаемого значения
Параметры
- boolean
$shouldSkip - Нужно ли пропустить тест.
- string
$messageнеобязательно '' - Сообщение для отображения.
Возвращает
booleanskipUnless()source protected
skipUnless( boolean $condition , string $message = '' )
Функция совместимости для пропуска.
Параметры
- boolean
$condition - Условие для запуска пропуска
- string
$messageнеобязательно '' - Сообщение о пропуске
Возвращает
booleantearDown()source public
tearDown( )
Разборка любых изменений в статических объектах и их восстановление.
withErrorReporting()source public
withErrorReporting( integer $errorLevel , callable $callable )
Вспомогательный метод для тестов, которым необходимо использовать error_reporting()
Параметры
- integer
$errorLevel - значение error_reporting(), которое необходимо использовать
- callable
$callable - вызываемая функция, которая получит утверждения
Методы, используемые из Cake\ORM\Locator\LocatorAwareTrait
getTableLocator()source public
getTableLocator( )
Получить локатор таблиц.
Возвращает
Cake\ORM\Locator\LocatorInterfacesetTableLocator()source public
setTableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator )
Устанавливает локатор таблиц.
Параметры
-
Cake\ORM\Locator\LocatorInterface$tableLocator - Экземпляр LocatorInterface.
Возвращает
$this
tableLocator()source public устаревший
tableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator = null )
Устанавливает локатор таблиц. Если параметры не переданы, он вернет текущий используемый локатор.
Устаревший
3.5.0 Используйте getTableLocator()/setTableLocator() вместо этого.Параметры
-
Cake\ORM\Locator\LocatorInterface$tableLocatorнеобязательно null - Экземпляр LocatorInterface.
Возвращает
Cake\ORM\Locator\LocatorInterfaceПодробное описание свойств
$autoFixturessource
public логическое
По умолчанию все фикстуры, присоединённые к этому классу, будут усекаться и перезагружаться после каждого теста. Установите значение false, чтобы обработать их вручную
true
$dropTablessource
public boolean
Управление созданием и удалением таблиц для каждого тестового метода.
Если true, таблицы всё равно будут удалены в конце выполнения каждого тестового прогона.
false
$fixtureManagersource
public Cake\TestSuite\Fixture\FixtureManager|null
Класс, отвечающий за управление созданием, загрузкой и удалением фикстур.
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.TestSuite.TestCase.html