Spec-Zone.ru › CakePHP 2.10

Класс CakeTestCase

Класс CakeTestCase

PHPUnit_Framework_TestCase
Extended by CakeTestCase

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

  • ControllerTestCase
Абстрактный
Пакет: Cake\TestSuite
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/TestSuite/CakeTestCase.php

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

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

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

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

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

  • _assertAttributes() protected
    Проверка атрибутов в рамках проверки assertTags().
  • _buildMock() protected
    Возвращает объект-заглушку для указанного класса.
  • assertEqual() protected static
    Функция-обёртка совместимости для assertEquals
  • assertIdentical() protected static
    Функция-обёртка совместимости для assertEquals
  • assertIsA() protected static
    Функция-обёртка совместимости для assertIsA
  • assertNoErrors() protected
    Проверка отсутствия ошибок
  • assertNoPattern() protected static
    Функция-обёртка совместимости для assertNotRegExp
  • assertNotEqual() protected static
    Функция-обёртка совместимости для assertNotEquals
  • assertNotIdentical() protected static
    Функция-обёртка совместимости для assertNotEquals
  • assertPattern() protected static
    Функция-обёртка совместимости для assertRegexp
  • assertPostConditions() protected
    Объявление конца теста.
  • assertPreConditions() protected
    Объявление начала теста.
  • assertReference() protected static
    Функция-обёртка совместимости для assertSame
  • assertTags() public

    Принимает массив $expected и генерирует регулярное выражение для соответствия предоставленной строке $string. Примеры для $expected:

  • assertTextContains() public

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

  • assertTextEndsNotWith() public

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

  • assertTextEndsWith() public

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

  • assertTextEquals() public

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

  • assertTextNotContains() public

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

  • assertTextNotEquals() public

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

  • assertTextStartsNotWith() public

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

  • assertTextStartsWith() public

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

  • assertWithinMargin() protected static
    Функция совместимости для проверки, находится ли значение в приемлемом диапазоне
  • date() public static
    См. CakeTestSuiteDispatcher::date()
  • endTest() public
    Вызывается, когда метод тестового случая был выполнен (переопределять при необходимости).
  • expectError() protected
    Функция-обёртка совместимости для setExpectedException
  • expectException() public
    Функция-обёртка совместимости для setExpectedException
  • getMock() public
    Возвращает объект-заглушку для указанного класса.
  • getMockForModel() public
    Заглушка модели, поддерживает фикстуры и ассоциации таблиц
  • loadFixtures() public
    Выбирает фикстуры для загрузки в данный тест
  • run() public

    Выполняет тестовый случай и собирает результаты в объекте TestResult. Если объект TestResult не передан, будет создан новый. Этот метод выполняется для каждого тестового метода в этом классе

  • setUp() public

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

  • skipIf() public
    Переопределяет SimpleTestCase::skipIf для предоставления булевого возвращаемого значения
  • skipUnless() protected
    Функция совместимости для пропуска.
  • startTest() public
    Вызывается перед началом метода тестового случая (переопределять при необходимости).
  • tearDown() public
    Разрушение любых статических изменений объекта и их восстановление.

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

_assertAttributes()source protected

_assertAttributes( array $assertions , string $string )

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

Параметры

массив $assertions
Проверки для выполнения.
строка $string
HTML-строка для проверки.
END_OF_DOCUMENT_MARKER

_buildMock()source protected

_buildMock( string $originalClassName , array $methods array() , array $arguments array() , string $mockClassName '' , boolean $callOriginalConstructor true , boolean $callOriginalClone true , boolean $callAutoload true )

Возвращает объект-мока для указанного класса.

Устаревшее

Используйте getMockBuilder() или createMock() в новых юнит-тестах.

Параметры

строка $originalClassName
Имя класса объекта, который должен быть смоделирован.
массив $methods необязательно array()

По умолчанию все методы данного класса заменяются на тестовый дубликат, который просто возвращает NULL, если не указано возвращаемое значение с помощью will($this->returnValue()), например. Если указан второй (необязательный) параметр, то только методы, имена которых находятся в массиве, заменяются на настраиваемый тестовый дубликат. Поведение других методов не меняется. Передача NULL в качестве параметра означает, что никакие методы не будут заменены.

массив $arguments необязательно array()

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

строка $mockClassName необязательно ''

Четвертый (необязательный) параметр можно использовать для указания имени класса для сгенерированного тестового дубликата.

логическое $callOriginalConstructor необязательно true

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

логическое $callOriginalClone необязательно true

Шестой (необязательный) параметр можно использовать для отключения вызова конструктора исходного класса clone.

логическое $callAutoload необязательно true

Седьмой (необязательный) параметр можно использовать для отключения __autoload() во время генерации класса тестового дубликата.

Возвращает

объект

См. также

https://phpunit.de/manual/current/en/test-doubles.html

assertEqual()source protected static

assertEqual( mixed $result , mixed $expected , string $message '' )

Функция-обертка совместимости для assertEquals

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $result
смешанный $expected
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertIdentical()source protected static

assertIdentical( mixed $actual , mixed $expected , string $message '' )

Функция-обертка совместимости для assertEquals

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $actual
смешанный $expected
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertIsA()source protected static

assertIsA( string $object , string $type , string $message '' )

Функция-обертка совместимости для assertIsA

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

строка $object
строка $type
строка $message необязательно ''

assertNoErrors()source protected

assertNoErrors( )

Утверждение об отсутствии ошибок

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

assertNoPattern()source protected static

assertNoPattern( mixed $pattern , string $string , string $message '' )

Функция-обертка совместимости для assertNotRegExp

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $pattern
регулярное выражение
строка $string
текст для сопоставления
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertNotEqual()source protected static

assertNotEqual( mixed $result , mixed $expected , string $message '' )

Функция-обертка совместимости для assertNotEquals

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $result
смешанный $expected
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertNotIdentical()source protected static

assertNotIdentical( mixed $actual , mixed $expected , string $message '' )

Функция-обертка совместимости для assertNotEquals

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $actual
смешанный $expected
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertPattern()source protected static

assertPattern( mixed $pattern , string $string , string $message '' )

Функция-обертка совместимости для assertRegexp

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $pattern
регулярное выражение
строка $string
текст для сопоставления
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertPostConditions()source protected

assertPostConditions( )

Объявляет конец теста.

assertPreConditions()source protected

assertPreConditions( )

Объявляет начало теста.

assertReference()source protected static

assertReference( mixed $first , mixed $second , string $message '' )

Функция-обертка совместимости для assertSame

Устаревшее

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

смешанный $first
смешанный $second
строка $message необязательно ''
текст, который будет отображен, если утверждение неверно

assertTags()source public

assertTags( string $string , array $expected , string $fullDebug false )

Принимает массив $expected и генерирует регулярное выражение для сопоставления с предоставленной строкой $string. Примеры $expected:

Проверяет тег ввода с атрибутом name (содержит любое ненулевое значение) и атрибутом id, содержащим 'my-input':

array('input' => array('name', 'id' => 'my-input'))

Проверяет два тега p с некоторым текстом в них:

array(
  array('p' => true),
  'textA',
  '/p',
  array('p' => true),
  'textB',
  '/p'
)

Также можно указать выражение шаблона как часть значений атрибутов или определяемого тега, если вы предваряете значение preg: и заключаете его в косые черты, например:

array(
  array('input' => array('name', 'id' => 'preg:/FieldName\d+/')),
  'preg:/My\s+field/'
)

Важно: Эта функция очень терпима к пробелам и также принимает любые перестановки порядка атрибутов. Она также позволит пробелам между указанными тегами.

Параметры

строка $string
Строка HTML/XHTML/XML
массив $expected
Массив, см. выше
строка $fullDebug необязательно false
Показывать ли более подробный вывод.

Возвращает

логическое значение
END_OF_DOCUMENT_MARKER

assertTextContains()source public

assertTextContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )

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

Параметры

string $needle
Строка, которую нужно найти.
string $haystack
Строка, в которой нужно искать.
string $message необязательно ''
Сообщение для отображения при ошибке.
boolean $ignoreCase необязательно false
Указывает, должна ли проверка быть регистрозависимой.

Возвращает

boolean

assertTextEndsNotWith()source public

assertTextEndsNotWith( string $suffix , string $string , string $message '' )

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

Параметры

string $suffix
Суффикс, который не должен быть найден.
string $string
Строка для поиска.
string $message необязательно ''
Сообщение для использования при ошибке.

Возвращает

boolean

assertTextEndsWith()source public

assertTextEndsWith( string $suffix , string $string , string $message '' )

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

Параметры

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

Возвращает

boolean

assertTextEquals()source public

assertTextEquals( string $expected , string $result , string $message '' )

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

Параметры

string $expected
Ожидаемое значение.
string $result
Фактическое значение.
string $message необязательно ''
Сообщение для использования при ошибке.

Возвращает

boolean

assertTextNotContains()source public

assertTextNotContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )

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

Параметры

string $needle
Строка, которую нужно найти.
string $haystack
Строка, в которой нужно искать.
string $message необязательно ''
Сообщение для отображения при ошибке.
boolean $ignoreCase необязательно false
Указывает, должна ли проверка быть регистрозависимой.

Возвращает

boolean

assertTextNotEquals()source public

assertTextNotEquals( string $expected , string $result , string $message '' )

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

Параметры

string $expected
Ожидаемое значение.
string $result
Фактическое значение.
string $message необязательно ''
Сообщение для использования при ошибке.

Возвращает

boolean

assertTextStartsNotWith()source public

assertTextStartsNotWith( string $prefix , string $string , string $message '' )

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

Параметры

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

Возвращает

boolean

assertTextStartsWith()source public

assertTextStartsWith( string $prefix , string $string , string $message '' )

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

Параметры

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

Возвращает

boolean

assertWithinMargin()source protected static

assertWithinMargin( mixed $result , mixed $expected , mixed $margin , string $message '' )

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

Параметры

mixed $result
mixed $expected
mixed $margin
Диапазон принятия
string $message необязательно ''
Текст для отображения, если утверждение неверно

date()source public static

date( string $format 'Y-m-d H:i:s' )

См. CakeTestSuiteDispatcher::date()

Параметры

string $format необязательно 'Y-m-d H:i:s'
формат, который будет использоваться.

Возвращает

string

endTest()source public

endTest( string $method )

Вызывается при выполнении метода тестового случая (для переопределения при необходимости).

Параметры

string $method
Метод теста, который был выполнен.

expectError()source protected

expectError( mixed $expected false , string $message '' )

Функция-обертка совместимости для setExpectedException

Устарело

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0

Параметры

mixed $expected необязательно false
имя исключения или ошибки
string $message необязательно ''
текст для отображения, если утверждение неверно

expectException()source public

expectException( mixed $name 'Exception' , string $message '' )

Функция-обертка совместимости для setExpectedException

Устарело

3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0.

Параметры

mixed $name необязательно 'Exception'
Имя ожидаемого исключения.
string $message необязательно ''
текст для отображения, если утверждение неверно
END_OF_DOCUMENT_MARKER

getMock()source public

getMock( string $originalClassName , array $methods array() , array $arguments array() , string $mockClassName '' , boolean $callOriginalConstructor true , boolean $callOriginalClone true , boolean $callAutoload true , boolean $cloneArguments false , boolean $callOriginalMethods false , string $proxyTarget null )

Возвращает объект-заглушку для указанного класса.

Устарело

Используйте getMockBuilder() или createMock() в новых юнит-тестах.

Параметры

строка $originalClassName
Имя класса объекта, который нужно смоделировать.
массив $methods необязательный array()

По умолчанию все методы данного класса заменяются на заглушку, которая просто возвращает NULL, если не задано возвращаемое значение с помощью will($this->returnValue()), например. При указании второго (необязательного) параметра, заглушки будут созданы только для методов, имена которых содержатся в массиве. Поведение других методов не изменится. Передача NULL в качестве параметра означает, что методы не будут заменены.

массив $arguments необязательный array()

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

строка $mockClassName необязательный ''

Четвертый (необязательный) параметр может использоваться для указания имени класса для сгенерированной заглушки.

логическое $callOriginalConstructor необязательный true

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

логическое $callOriginalClone необязательный true

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

логическое $callAutoload необязательный true

Седьмой (необязательный) параметр может быть использован для отключения __autoload() при генерации класса-заглушки.

логическое $cloneArguments необязательный false
Не поддерживается.
логическое $callOriginalMethods необязательный false
Не поддерживается.
строка $proxyTarget необязательный null
Не поддерживается.

Возвращает

объект

Исключения

InvalidArgumentException
Когда установлены не поддерживаемые параметры.

См. также

https://phpunit.de/manual/current/en/test-doubles.html

getMockForModel()source public

getMockForModel( string $model , mixed $methods array() , array $config array() )

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

Параметры

строка $model
Модель, для которой нужно создать заглушку.
смешанный $methods необязательный array()
Список методов для имитации
массив $config необязательный array()
Данные конфигурации для конструктора заглушки.

Возвращает

Model

Исключения

MissingModelException

loadFixtures()source public

loadFixtures( )

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

Каждый параметр — имя модели, соответствующей фикстуре, например, 'Post', 'Author' и т. д.

Исключения

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

См. также

CakeTestCase::$autoFixtures

run()source public

run( PHPUnit_Framework_TestResult $result null )

Выполняет тестовый случай и собирает результаты в объекте TestResult. Если объект TestResult не передан, будет создан новый. Этот метод выполняется для каждого тестового метода в этом классе

Параметры

PHPUnit_Framework_TestResult $result необязательный null
Объект результата теста

Возвращает

PHPUnit_Framework_TestResult

Исключения

InvalidArgumentException

setUp()source public

setUp( )

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

skipIf()source public

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

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

Параметры

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

Возвращает

логическое

skipUnless()source protected

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

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

Параметры

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

Возвращает

логическое

startTest()source public

startTest( string $method )

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

Параметры

строка $method
Тестовый метод, который вот-вот будет выполнен.

tearDown()source public

tearDown( )

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

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

$_configuresource

protected массив

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

array()

$_pathRestoresource

protected массив

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

array()

$autoFixturessource

public массив

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

true

$dropTablessource

public логическое

Управление созданием/удалением таблиц в каждом тестовом методе.

Установите значение в false, чтобы избежать удаления таблиц, если они уже существуют между каждым тестовым методом. Таблицы все равно будут удалены в конце выполнения каждого тестового исполнителя.

true

$fixtureManagersource

public CakeFixtureManager

Класс, отвечающий за управление созданием, загрузкой и удалением фикстур

null

© 2005–2017 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/2.10/class-CakeTestCase.html

Spec-Zone.ru

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