Spec-Zone.ru › Laravel 5.2

MakesHttpRequests

trait MakesHttpRequests (View source)

Свойства

InteractsWithPages

Свойства

protected Crawler $crawler Экземпляр DomCrawler. из InteractsWithPages
protected array $subCrawlers Вложенные экземпляры crawler, используемые методом "within". из InteractsWithPages
protected array $inputs Все сохранённые данные ввода для текущей страницы. из InteractsWithPages
protected array $uploads Все сохранённые загруженные файлы для текущей страницы. из InteractsWithPages
protected Response $response Последний ответ, возвращённый приложением.
protected string $currentUri Текущий URL, отображаемый в браузере.
protected array $serverVariables Дополнительные переменные сервера для запроса.

Методы

$this visit(string $uri)

Посетить указанный URI с помощью GET-запроса.

из InteractsWithPages
$this makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [])

Отправить запрос к приложению и создать экземпляр Crawler.

из InteractsWithPages
void resetPageContext()

Очистить значения хранилища и вложенных хранилищ для сброса контекста страницы.

из InteractsWithPages
$this makeRequestUsingForm(Form $form, array $uploads = [])

Отправить запрос к приложению с использованием заданной формы.

из InteractsWithPages
array extractParametersFromForm(Form $form)

Извлечь параметры из заданной формы.

из InteractsWithPages
$this followRedirects()

Следовать перенаправлениям из последнего ответа.

из InteractsWithPages
$this clearInputs()

Очистить вводы для текущей страницы.

из InteractsWithPages
$this seePageIs(string $uri)

Утвердить, что текущая страница соответствует заданному URI.

из InteractsWithPages
void assertPageLoaded(string $uri, string|null $message = null)

Утвердить, что заданная страница успешно загрузилась.

из InteractsWithPages
$this within(string $element, Closure $callback)

Ограничить область тестирования конкретной областью страницы.

из InteractsWithPages
Crawler crawler()

Получить текущий Crawler в соответствии с контекстом теста.

из InteractsWithPages
$this assertInPage(PageConstraint $constraint, bool $reverse = false, string $message = '')

Утвердить заданный ограничитель.

из InteractsWithPages
$this see(string $text, bool $negate = false)

Утвердить, что заданная строка видна на текущем HTML.

из InteractsWithPages
$this dontSee(string $text)

Утвердить, что заданная строка не видна на текущем HTML.

из InteractsWithPages
$this seeElement(string $selector, array $attributes = [], bool $negate = false)

Утвердить, что элемент присутствует на странице.

из InteractsWithPages
$this dontSeeElement(string $selector, array $attributes = [])

Утвердить, что элемент отсутствует на странице.

из InteractsWithPages
$this seeText(string $text, bool $negate = false)

Утвердить, что заданная строка видна в текущем тексте.

из InteractsWithPages
$this dontSeeText(string $text)

Утвердить, что заданная строка не видна в текущем тексте.

из InteractsWithPages
$this seeInElement(string $element, string $text, bool $negate = false)

Утвердить, что заданная строка видна внутри элемента.

из InteractsWithPages
$this dontSeeInElement(string $element, string $text)

Утвердить, что заданная строка не видна внутри элемента.

из InteractsWithPages
$this seeLink(string $text, string|null $url = null, bool $negate = false)

Утвердить, что заданная ссылка видна на странице.

из InteractsWithPages
$this dontSeeLink(string $text, string|null $url = null)

Утвердить, что заданная ссылка не видна на странице.

из InteractsWithPages
$this seeInField(string $selector, string $expected, bool $negate = false)

Утвердить, что поле ввода содержит заданное значение.

из InteractsWithPages
$this dontSeeInField(string $selector, string $value)

Утвердить, что поле ввода не содержит заданного значения.

из InteractsWithPages
$this seeIsSelected(string $selector, string $value, bool $negate = false)

Утвердить, что ожидаемое значение выбрано.

из InteractsWithPages
$this dontSeeIsSelected(string $selector, string $value)

Утвердить, что заданное значение не выбрано.

из InteractsWithPages
$this seeIsChecked(string $selector, bool $negate = false)

Утвердить, что данный флажок выбран.

из InteractsWithPages
$this dontSeeIsChecked(string $selector)

Утвердить, что данный флажок не выбран.

из InteractsWithPages
$this click(string $name)

Нажмите на ссылку с заданным телом, именем или атрибутом ID.

из InteractsWithPages
$this type(string $text, string $element)

Заполните поле ввода заданным текстом.

из InteractsWithPages
$this check(string $element)

Отметить флажок на странице.

из InteractsWithPages
$this uncheck(string $element)

Снять отметку с флажка на странице.

из InteractsWithPages
$this select(string $option, string $element)

Выберите опцию из раскрывающегося списка.

из InteractsWithPages
$this attach(string $absolutePath, string $element)

Прикрепить файл к полю формы на странице.

из InteractsWithPages
$this press(string $buttonText)

Отправить форму, используя кнопку с заданным текстом.

из InteractsWithPages
$this submitForm(string $buttonText, array $inputs = [], array $uploads = [])

Отправить форму на странице с заданным вводом.

из InteractsWithPages
Form fillForm(string $buttonText, array $inputs = [])

Заполните форму заданными данными.

из InteractsWithPages
Form getForm(string|null $buttonText = null)

Получить форму со страницы с заданным текстом кнопки отправки.

из InteractsWithPages
$this storeInput(string $element, string $text)

Сохранить входные данные формы в локальном массиве.

из InteractsWithPages
void assertFilterProducesResults(string $filter)

Утверждается, что отфильтрованный Crawler возвращает узлы.

из InteractsWithPages
Crawler filterByNameOrId(string $name, array|string $elements = '*')

Фильтрация элементов по заданному имени или атрибуту ID.

из InteractsWithPages
array convertUploadsForTesting(Form $form, array $uploads)

Преобразование заданных загрузок в экземпляры UploadedFile.

из InteractsWithPages
UploadedFile getUploadedFileForTesting(array $file, array $uploads, string $name)

Создание экземпляра UploadedFile для тестирования.

из InteractsWithPages
$this withoutMiddleware()

Отключение middleware для теста.

$this json(string $method, string $uri, array $data = [], array $headers = [])

Переход к заданному URI с JSON-запросом.

array extractFilesFromDataArray(array $data)

Извлечение загрузок файлов из заданного массива данных.

$this get(string $uri, array $headers = [])

Переход к заданному URI с GET-запросом.

$this post(string $uri, array $data = [], array $headers = [])

Переход к заданному URI с POST-запросом.

$this put(string $uri, array $data = [], array $headers = [])

Переход к заданному URI с PUT-запросом.

$this patch(string $uri, array $data = [], array $headers = [])

Переход к заданному URI с PATCH-запросом.

$this delete(string $uri, array $data = [], array $headers = [])

Переход к заданному URI с DELETE-запросом.

$this handle(Request $request)

Отправить заданный запрос через приложение.

$this shouldReturnJson(array $data = null)

Утверждается, что ответ содержит JSON.

$this|null receiveJson(array|null $data = null)

Утверждение, что ответ содержит JSON.

$this seeJsonEquals(array $data)

Утверждение, что ответ содержит точный массив JSON.

$this seeJson(array $data = null, bool $negate = false)

Утверждение, что ответ содержит JSON.

$this dontSeeJson(array $data = null)

Утверждение, что ответ не содержит JSON.

$this seeJsonStructure(array $structure = null, array|null $responseData = null)

Утверждение, что JSON-ответ имеет заданную структуру.

$this seeJsonContains(array $data, bool $negate = false)

Утверждение, что ответ содержит заданный JSON.

$this seeJsonSubset(array $data)

Утверждение, что ответ является супермножеством заданного JSON.

array decodeResponseJson()

Проверка и возврат декодированного JSON ответа.

string formatToExpectedJson(string $key, mixed $value)

Форматирование заданного ключа и значения в JSON-строку для проверок ожиданий.

$this seeStatusCode(int $status)

Утверждает, что код состояния ответа соответствует заданному коду.

$this seeHeader(string $headerName, mixed $value = null)

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

$this seePlainCookie(string $cookieName, mixed $value = null)

Утверждает, что ответ содержит указанный cookie и равен необязательному значению.

$this seeCookie(string $cookieName, mixed $value = null, bool $encrypted = true)

Утверждает, что ответ содержит указанный cookie и равен необязательному значению.

$this withServerVariables(array $server)

Определяет набор переменных сервера, которые будут отправляться с запросами.

Response call(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызов заданного URI и возврат ответа.

Response callSecure(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызов заданного URI HTTPS и возврат ответа.

Response action(string $method, string $action, array $wildcards = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызов действия контроллера и возврат ответа.

Response route(string $method, string $name, array $routeParameters = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызов именованного маршрута и возврат ответа.

string prepareUrlForRequest(string $uri)

Преобразование заданного URI в полностью квалифицированный URL.

array transformHeadersToServerVars(array $headers)

Преобразование массива заголовков в массив переменных $SERVER в формате HTTP*.

$this assertResponseOk()

Утверждение, что ответ клиента имеет код состояния OK.

$this assertResponseStatus(int $code)

Утверждение, что ответ клиента имеет заданный код.

$this assertViewHas(string|array $key, mixed $value = null)

Утверждение, что ответ представления содержит заданные данные.

$this assertViewHasAll(array $bindings)

Утверждение, что представление содержит заданный список данных.

$this assertViewMissing(string $key)

Утверждение, что в ответе представления отсутствуют заданные данные.

$this assertRedirectedTo(string $uri, array $with = [])

Утверждение о перенаправлении клиента на заданный URI.

$this assertRedirectedToRoute(string $name, array $parameters = [], array $with = [])

Утверждение о перенаправлении клиента на заданный маршрут.

$this assertRedirectedToAction(string $name, array $parameters = [], array $with = [])

Утверждение о перенаправлении клиента на заданное действие.

void dump()

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

Details

$this visit(string $uri)

Посещение заданного URI с запросом GET.

Parameters

string $uri

Return Value

$this

protected $this makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [])

Выполнение запроса к приложению и создание экземпляра Crawler.

Parameters

string $method
string $uri
array $parameters
array $cookies
array $files

Return Value

$this

protected void resetPageContext()

Очистка значения crawler и subcrawlers для сброса контекста страницы.

Return Value

void

protected $this makeRequestUsingForm(Form $form, array $uploads = [])

Выполнение запроса к приложению с использованием заданной формы.

Parameters

Form $form
array $uploads

Return Value

$this

protected array extractParametersFromForm(Form $form)

Извлечение параметров из заданной формы.

Parameters

Form $form

Return Value

array

protected $this followRedirects()

Следование перенаправлениям из последнего ответа.

Return Value

$this

protected $this clearInputs()

Очистка входных данных для текущей страницы.

Return Value

$this

protected $this seePageIs(string $uri)

Утверждение, что текущая страница соответствует заданному URI.

Parameters

string $uri

Return Value

$this

protected void assertPageLoaded(string $uri, string|null $message = null)

Утверждение, что заданная страница успешно загрузилась.

Parameters

string $uri
string|null $message

Return Value

void

Exceptions

HttpException

$this within(string $element, Closure $callback)

Сужение содержимого теста до определенной области страницы.

Parameters

string $element
Closure $callback

Return Value

$this

protected Crawler crawler()

Получение текущего crawler в соответствии с контекстом теста.

Return Value

Crawler

protected $this assertInPage(PageConstraint $constraint, bool $reverse = false, string $message = '')

Утверждение заданного ограничения.

Параметры

PageConstraint $constraint
bool $reverse
string $message

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

$this

$this see(string $text, bool $negate = false)

Утверждение, что заданная строка видна на текущем HTML.

Параметры

string $text
bool $negate

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

$this

$this dontSee(string $text)

Утверждение, что заданная строка не видна на текущем HTML.

Параметры

string $text

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

$this

$this seeElement(string $selector, array $attributes = [], bool $negate = false)

Утверждение, что элемент присутствует на странице.

Параметры

string $selector
array $attributes
bool $negate

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

$this

$this dontSeeElement(string $selector, array $attributes = [])

Утверждение, что элемент отсутствует на странице.

Параметры

string $selector
array $attributes

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

$this

$this seeText(string $text, bool $negate = false)

Утверждение, что заданная строка видна в текущем тексте.

Параметры

string $text
bool $negate

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

$this

$this dontSeeText(string $text)

Утверждение, что заданная строка не видна в текущем тексте.

Параметры

string $text

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

$this

$this seeInElement(string $element, string $text, bool $negate = false)

Утверждение, что заданная строка видна внутри элемента.

Параметры

string $element
string $text
bool $negate

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

$this

$this dontSeeInElement(string $element, string $text)

Утверждение, что заданная строка не видна внутри элемента.

Параметры

string $element
string $text

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

$this

$this seeLink(string $text, string|null $url = null, bool $negate = false)

Утверждение, что заданная ссылка видна на странице.

Параметры

string $text
string|null $url
bool $negate

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

$this

$this dontSeeLink(string $text, string|null $url = null)

Утверждение, что заданная ссылка не видна на странице.

Параметры

string $text
string|null $url

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

$this

$this seeInField(string $selector, string $expected, bool $negate = false)

Утверждение, что поле ввода содержит заданное значение.

Параметры

string $selector
string $expected
bool $negate

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

$this

$this dontSeeInField(string $selector, string $value)

Утверждение, что поле ввода не содержит заданное значение.

Параметры

string $selector
string $value

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

$this

$this seeIsSelected(string $selector, string $value, bool $negate = false)

Утверждение, что ожидаемое значение выбрано.

Параметры

string $selector
string $value
bool $negate

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

$this

$this dontSeeIsSelected(string $selector, string $value)

Утверждение, что заданное значение не выбрано.

Параметры

string $selector
string $value

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

$this

$this seeIsChecked(string $selector, bool $negate = false)

Утверждение, что заданный чекбокс выбран.

Параметры

string $selector
bool $negate

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

$this

$this dontSeeIsChecked(string $selector)

Утверждение, что заданный чекбокс не выбран.

Параметры

string $selector

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

$this

protected $this click(string $name)

Нажать на ссылку с заданным телом, именем или атрибутом ID.

Параметры

string $name

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

$this

Исключения

InvalidArgumentException

protected $this type(string $text, string $element)

Заполнить поле ввода заданным текстом.

Параметры

string $text
string $element

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

$this

protected $this check(string $element)

Установить флажок на странице.

Parameters

string $element

Return Value

$this

protected $this uncheck(string $element)

Снять флажок на странице.

Parameters

string $element

Return Value

$this

protected $this select(string $option, string $element)

Выбрать опцию из выпадающего списка.

Parameters

string $option
string $element

Return Value

$this

protected $this attach(string $absolutePath, string $element)

Прикрепить файл к полю формы на странице.

Parameters

string $absolutePath
string $element

Return Value

$this

protected $this press(string $buttonText)

Отправить форму, используя кнопку с заданным текстом.

Parameters

string $buttonText

Return Value

$this

protected $this submitForm(string $buttonText, array $inputs = [], array $uploads = [])

Отправить форму на странице с заданными данными.

Parameters

string $buttonText
array $inputs
array $uploads

Return Value

$this

protected Form fillForm(string $buttonText, array $inputs = [])

Заполнить форму заданными данными.

Parameters

string $buttonText
array $inputs

Return Value

Form

protected Form getForm(string|null $buttonText = null)

Получить форму со страницы по тексту кнопки отправки.

Parameters

string|null $buttonText

Return Value

Form

Exceptions

InvalidArgumentException

protected $this storeInput(string $element, string $text)

Сохранить элемент ввода формы в локальный массив.

Parameters

string $element
string $text

Return Value

$this

protected void assertFilterProducesResults(string $filter)

Проверить, что отфильтрованный Crawler возвращает узлы.

Parameters

string $filter

Return Value

void

Exceptions

InvalidArgumentException

protected Crawler filterByNameOrId(string $name, array|string $elements = '*')

Отфильтровать элементы по заданному имени или атрибуту ID.

Parameters

string $name
array|string $elements

Return Value

Crawler

protected array convertUploadsForTesting(Form $form, array $uploads)

Преобразовать заданные загрузки в экземпляры UploadedFile.

Parameters

Form $form
array $uploads

Return Value

array

protected UploadedFile getUploadedFileForTesting(array $file, array $uploads, string $name)

Создать экземпляр UploadedFile для тестирования.

Parameters

array $file
array $uploads
string $name

Return Value

UploadedFile

$this withoutMiddleware()

Отключить middleware для теста.

Return Value

$this

$this json(string $method, string $uri, array $data = [], array $headers = [])

Обратиться к заданному URI с JSON-запросом.

Parameters

string $method
string $uri
array $data
array $headers

Return Value

$this

protected array extractFilesFromDataArray(array $data)

Извлечь загрузки файлов из заданного массива данных.

Parameters

array $data

Return Value

array

$this get(string $uri, array $headers = [])

Обратиться к заданному URI с GET-запросом.

Parameters

string $uri
array $headers

Return Value

$this

$this post(string $uri, array $data = [], array $headers = [])

Обратиться к заданному URI с POST-запросом.

Parameters

string $uri
array $data
array $headers

Return Value

$this

$this put(string $uri, array $data = [], array $headers = [])

Обратиться к заданному URI с PUT-запросом.

Parameters

string $uri
array $data
array $headers

Return Value

$this

$this patch(string $uri, array $data = [], array $headers = [])

Обратиться к заданному URI с запросом PATCH.

Параметры

string $uri
array $data
array $headers

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

$this

$this delete(string $uri, array $data = [], array $headers = [])

Обратиться к заданному URI с запросом DELETE.

Параметры

string $uri
array $data
array $headers

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

$this

$this handle(Request $request)

Отправить заданный запрос через приложение.

Этот метод позволяет полностью настроить весь объект Request.

Параметры

Request $request

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

$this

protected $this shouldReturnJson(array $data = null)

Утверждать, что ответ содержит JSON.

Параметры

array $data

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

$this

protected $this|null receiveJson(array|null $data = null)

Утверждать, что ответ содержит JSON.

Параметры

array|null $data

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

$this|null

$this seeJsonEquals(array $data)

Утверждать, что ответ содержит точный массив JSON.

Параметры

array $data

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

$this

$this seeJson(array $data = null, bool $negate = false)

Утверждать, что ответ содержит JSON.

Параметры

array $data
bool $negate

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

$this

$this dontSeeJson(array $data = null)

Утверждать, что ответ не содержит JSON.

Параметры

array $data

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

$this

$this seeJsonStructure(array $structure = null, array|null $responseData = null)

Утверждать, что JSON-ответ имеет заданную структуру.

Параметры

array $structure
array|null $responseData

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

$this

protected $this seeJsonContains(array $data, bool $negate = false)

Утверждать, что ответ содержит заданный JSON.

Параметры

array $data
bool $negate

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

$this

protected $this seeJsonSubset(array $data)

Утверждать, что ответ является надмножеством заданного JSON.

Параметры

array $data

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

$this

protected array decodeResponseJson()

Проверить и вернуть декодированный JSON ответа.

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

array

protected string formatToExpectedJson(string $key, mixed $value)

Отформатировать заданный ключ и значение в строку JSON для проверки ожиданий.

Параметры

string $key
mixed $value

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

string

protected $this seeStatusCode(int $status)

Утверждает, что код состояния ответа соответствует заданному коду.

Параметры

int $status

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

$this

protected $this seeHeader(string $headerName, mixed $value = null)

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

Параметры

string $headerName
mixed $value

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

$this

protected $this seePlainCookie(string $cookieName, mixed $value = null)

Утверждает, что ответ содержит заданный cookie и равен необязательному значению.

Параметры

string $cookieName
mixed $value

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

$this

protected $this seeCookie(string $cookieName, mixed $value = null, bool $encrypted = true)

Утверждает, что ответ содержит заданный cookie и равен необязательному значению.

Параметры

string $cookieName
mixed $value
bool $encrypted

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

$this

protected $this withServerVariables(array $server)

Определите набор переменных сервера, которые будут отправляться с запросами.

Параметры

array $server

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

$this

Response call(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызвать заданный URI и вернуть Response.

Параметры

string $method
string $uri
array $parameters
array $cookies
array $files
array $server
string $content

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

Response
END_OF_DOCUMENT_MARKER

Ответ callSecure(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызвать указанный HTTPS URI и вернуть ответ.

Параметры

string $method
string $uri
array $parameters
array $cookies
array $files
array $server
string $content

Значение возврата

Ответ

Ответ action(string $method, string $action, array $wildcards = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызвать действие контроллера и вернуть ответ.

Параметры

string $method
string $action
array $wildcards
array $parameters
array $cookies
array $files
array $server
string $content

Значение возврата

Ответ

Ответ route(string $method, string $name, array $routeParameters = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)

Вызвать маршрут с именем и вернуть ответ.

Параметры

string $method
string $name
array $routeParameters
array $parameters
array $cookies
array $files
array $server
string $content

Значение возврата

Ответ

protected string prepareUrlForRequest(string $uri)

Преобразовать данный URI в полностью квалифицированный URL.

Параметры

string $uri

Значение возврата

string

protected array transformHeadersToServerVars(array $headers)

Преобразовать массив заголовков в массив переменных $SERVER в формате HTTP*.

Параметры

array $headers

Значение возврата

array

$this assertResponseOk()

Утверждение, что код ответа клиента — OK.

Значение возврата

$this

$this assertResponseStatus(int $code)

Утверждение, что код ответа клиента равен заданному.

Параметры

int $code

Значение возврата

$this

$this assertViewHas(string|array $key, mixed $value = null)

Утверждение, что представление ответа содержит заданные данные.

Параметры

string|array $key
mixed $value

Значение возврата

$this

$this assertViewHasAll(array $bindings)

Утверждение, что представление содержит указанный список данных.

Параметры

array $bindings

Значение возврата

$this

$this assertViewMissing(string $key)

Утверждение, что представление не содержит заданных данных.

Параметры

string $key

Значение возврата

$this

$this assertRedirectedTo(string $uri, array $with = [])

Утверждение перенаправления клиента на указанный URI.

Параметры

string $uri
array $with

Значение возврата

$this

$this assertRedirectedToRoute(string $name, array $parameters = [], array $with = [])

Утверждение перенаправления клиента на указанный маршрут.

Параметры

string $name
array $parameters
array $with

Значение возврата

$this

$this assertRedirectedToAction(string $name, array $parameters = [], array $with = [])

Утверждение перенаправления клиента на указанное действие.

Параметры

string $name
array $parameters
array $with

Значение возврата

$this

void dump()

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

Значение возврата

void

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.2/Illuminate/Foundation/Testing/Concerns/MakesHttpRequests.html

Spec-Zone.ru

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