Spec-Zone.ru › CakePHP 3.8

Класс TestCase

Класс Cake TestCase

PHPUnit\Framework\TestCase
Расширенный Cake\TestSuite\TestCase использует Cake\ORM\Locator\LocatorAwareTrait

Прямые подклассы

  • Cake\TestSuite\ConsoleIntegrationTestCase
  • Cake\TestSuite\IntegrationTestCase
Абстрактный
Пространство имен: Cake\TestSuite
Расположение: TestSuite/TestCase.php

Краткое описание свойств

  • $_configure protected
    array
    Значения настроек для восстановления в конце теста.
  • $_pathRestore protected
    array
    Настройки путей для восстановления в конце теста.
  • $autoFixtures public
    boolean

    По умолчанию все фикстуры, присоединённые к этому классу, будут обнулены и перезагружены после каждого теста. Установите в значение false, чтобы обработать вручную

  • $dropTables public
    boolean
    Управление созданием/удалением таблиц для каждого метода теста.
  • $fixtureManager public
    Cake\TestSuite\Fixture\FixtureManager|null
    Класс, отвечающий за управление созданием, загрузкой и удалением фикстур

Унаследованные свойства

  • _tableLocator

Краткое описание методов

  • _assertAttributes() protected
    Проверка атрибутов в рамках проверки assertTags().
  • _getTableClassName() protected
    Получение имени класса для таблицы.
  • _normalizePath() protected
    Нормализация пути для сравнения.
  • assertEventFired() public
    Проверяет, был ли вызван глобальный событие. Для работы этой проверки необходимо отслеживать события в вашем диспетчере событий.
  • assertEventFiredWith() public
    Проверяет, был ли вызван событие с данными
  • assertHtml() public
    Проверка HTML тегов.
  • assertNotWithinRange() protected static
    Функция совместимости для проверки, что значение не находится в допустимом диапазоне.
  • assertPathEquals() protected static
    Функция совместимости для проверки путей.
  • assertTags() public deprecated
    Проверка HTML тегов.
  • assertTextContains() public

    Проверить, содержит ли строка другую строку, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextEndsNotWith() public

    Проверяет, что строка не заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextEndsWith() public

    Проверяет, что строка заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextEquals() public

    Проверка равенства текста, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextNotContains() public

    Проверить, что текст не содержит другой текст, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextNotEquals() public

    Проверка равенства текста, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextStartsNotWith() public

    Проверяет, что строка не начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertTextStartsWith() public

    Проверяет, что строка начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для выполнения кроссплатформенных тестов блоков текста.

  • assertWithinRange() protected static
    Функция совместимости для проверки, что значение находится в допустимом диапазоне.
  • clearPlugins() public
    Очистить все плагины из глобальной коллекции плагинов.
  • deprecated() public
    Вспомогательный метод для проверки методов устаревания
  • getMockForModel() public
    Создать модель-заглушку, сохранить фикстуры и ассоциации таблиц
  • loadFixtures() public
    Выбор фикстур для загрузки для данного теста
  • loadPlugins() public
    Загрузка плагинов в имитируемое приложение.
  • removePlugins() public
    Удалить плагины из глобальной коллекции плагинов.
  • setAppNamespace() public static
    Установить имя пространства приложения
  • 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.
END_OF_DOCUMENT_MARKER ```

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
Используется ли более подробный вывод.

Возвращаемое значение

boolean

assertNotWithinRange()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 необязательный ''
Сообщение для использования при ошибке.
END_OF_DOCUMENT_MARKER

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\MissingTableClassException

loadFixtures()source public

loadFixtures( )

Выбирает фикстуры, которые нужно загрузить для данного теста

Каждый параметр — имя модели, соответствующее фикстуре, т. е. «Posts», «Authors» и т. д. Передача без параметров приведет к загрузке всех фикстур в тестовом случае.

Выбрасывает

Исключение
если менеджер фикстур недоступен.

См. также

\Cake\TestSuite\TestCase::$autoFixtures

loadPlugins()source public

loadPlugins( array $plugins = [] )

Загрузить плагины в имитируемое приложение.

Полезно для тестирования того, как взаимодействуют плагины, загружаемые/не загружаемые с другими элементами CakePHP или приложениями.

Параметры

array $plugins необязательно []
Список плагинов для загрузки.

Возвращает

Cake\Http\BaseApplication

removePlugins()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 необязательно ''
Сообщение для отображения.

Возвращает

boolean

skipUnless()source protected

skipUnless( boolean $condition , string $message = '' )

Функция совместимости для пропуска.

Параметры

boolean $condition
Условие для запуска пропуска
string $message необязательно ''
Сообщение о пропуске

Возвращает

boolean

tearDown()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\LocatorInterface

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

Подробное описание свойств

$_configuresource

protected массив

Значения Configure для восстановления в конце теста.

[]

$_pathRestoresource

protected массив

Настройки путей для восстановления в конце теста.

[]

$autoFixturessource

public логическое

По умолчанию все фикстуры, присоединённые к этому классу, будут усекаться и перезагружаться после каждого теста. Установите значение false, чтобы обработать их вручную

true
END_OF_DOCUMENT_MARKER

$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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API