Spec-Zone.ru › CakePHP 3.7

Класс TestCase

Класс Cake TestCase

PHPUnit\Framework\TestCase
Extended by 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, чтобы предоставить возвращаемое значение boolean.
  • skipUnless() protected
    Функция совместимости для пропуска.
  • tearDown() public
    Разборка любых изменений статических объектов и их восстановление.
  • withErrorReporting() public
    Вспомогательный метод для тестов, которым нужно использовать error_reporting().

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

_assertAttributes()source protected

_assertAttributes( array $assertions , string $string , boolean $fullDebug = false , array|string $regex = '' )

Проверка атрибутов в рамках проверки assertTags().

Параметры

массив $assertions
Проверки для выполнения.
строка $string
Строка HTML для проверки.
булево $fullDebug необязательно false
Определяет, будет ли использоваться более подробный вывод.
массив|строка $regex необязательно ''
Полный регулярное выражение из assertHtml

Возвращает

строка|булево

_getTableClassName()source protected

_getTableClassName( string $alias , array $options )

Получение имени класса таблицы.

Параметры

строка $alias
Модель для получения имитации.
массив $options
Данные конфигурации для конструктора имитации.

Возвращает

строка

Исключения

Cake\ORM\Exception\MissingTableClassException

_normalizePath()source 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 устарело

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 = '' )

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

Параметры

строка $prefix
Префикс для проверки.
строка $string
Строка для поиска.
строка $message необязательно ''
Сообщение для использования при ошибке.

assertWithinRange()source protected static

assertWithinRange( float $expected , float $result , float $margin , string $message = '' )

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

Параметры

число с плавающей запятой $expected
число с плавающей запятой $result
число с плавающей запятой $margin
диапазон приемлемости
строка $message необязательно ''
текст для отображения, если утверждение неверно

clearPlugins()source public

clearPlugins( )

Очистить все плагины из глобальной коллекции плагинов.

Полезно в методах завершения тестовых случаев.

deprecated()source public

deprecated( callable $callable )

Вспомогательный метод для проверки устаревших методов

Параметры

вызываемый объект $callable
вызываемая функция, которая получит утверждения

getMockForModel()source public

getMockForModel( string $alias , array|null $methods = [] , array $options = [] )

Создать макет модели, сохранить фикстуры и связь таблиц

Параметры

строка $alias
Модель, для которой требуется макет.
массив|null $methods необязательно []
Список методов для создания макета
массив $options необязательно []
Конфигурационные данные для конструктора макета.

Возвращает

Cake\ORM\Table|PHPUnit_Framework_MockObject_MockObject

Выбрасывает

Cake\ORM\Exception\MissingTableClassException

loadFixtures()source public

loadFixtures( )

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

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

Выбрасывает

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

См. также

\Cake\TestSuite\TestCase::$autoFixtures

loadPlugins()source public

loadPlugins( array $plugins = [] )

Загрузка плагинов в симулированное приложение.

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

Параметры

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

Возвращает

Cake\Http\BaseApplication

removePlugins()source public

removePlugins( array $plugins = [] )

Удаление плагинов из глобальной коллекции плагинов.

Полезно в методах завершения тестовых случаев.

Параметры

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

setAppNamespace()source public static

setAppNamespace( string $appNamespace = 'TestApp' )

Установить пространство имен приложения

Параметры

строка $appNamespace необязательно 'TestApp'
Пространство имен приложения, по умолчанию "TestApp".

setUp()source public

setUp( )

Настройка тестового случая, резервное копирование значений статических объектов для их последующего восстановления. В частности, сохраняет содержимое Configure и пути в App, если они еще не были скопированы.

skipIf()source public

skipIf( boolean $shouldSkip , string $message = '' )

Переопределяет SimpleTestCase::skipIf для предоставления булевого возвращаемого значения

Параметры

булево $shouldSkip
Указывает, следует ли пропускать тест.
строка $message необязательно ''
Сообщение для отображения.

Возвращает

boolean

skipUnless()source protected

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

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

Параметры

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

Возвращает

boolean

tearDown()source public

tearDown( )

разборка любых изменений в статическом объекте и их восстановление.

withErrorReporting()source public

withErrorReporting( integer $errorLevel , callable $callable )

Вспомогательный метод для тестов, которым необходимо использовать error_reporting()

Параметры

целое число $errorLevel
значение error_reporting(), которое необходимо использовать
вызываемый объект $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 deprecated

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 boolean

По умолчанию все фикстуры, прикреплённые к этому классу, будут усекаться и перезагружаться после каждого теста. Установите в значение 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.7/class-Cake.TestSuite.TestCase.html

Spec-Zone.ru

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