CrawlerTrait

trait CrawlerTrait (View source)

Свойства

protected Crawler	$crawler	Экземпляр DomCrawler.	из 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-запросом.	from InteractsWithPages
$this	makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = []) Сделать запрос к приложению и создать экземпляр Crawler.	from InteractsWithPages
$this	makeRequestUsingForm(Form $form, array $uploads = []) Сделать запрос к приложению с использованием данной формы.	from InteractsWithPages
array	extractParametersFromForm(Form $form) Извлечь параметры из данной формы.	from InteractsWithPages
$this	followRedirects() Следовать редиректам из последнего ответа.	from InteractsWithPages
$this	clearInputs() Очистить поля ввода для текущей страницы.	from InteractsWithPages
$this	seePageIs(string $uri) Утверждать, что текущая страница соответствует заданному URI.	from InteractsWithPages
void	assertPageLoaded(string $uri, string\|null $message = null) Утверждать, что заданная страница успешно загружена.	from InteractsWithPages
$this	see(string $text, bool $negate = false) Утверждать, что заданная строка отображается на странице.	from InteractsWithPages
$this	dontSee(string $text) Утверждать, что заданная строка не отображается на странице.	from InteractsWithPages
$this	seeInElement(string $element, string $text, bool $negate = false) Утверждать, что заданная строка отображается внутри элемента.	from InteractsWithPages
$this	dontSeeInElement(string $element, string $text) Утверждать, что заданная строка не отображается внутри элемента.	from InteractsWithPages
bool	hasInElement(string $element, string $text) Проверить, содержит ли страница текст внутри заданного элемента.	from InteractsWithPages
$this	seeLink(string $text, string\|null $url = null) Утверждать, что заданная ссылка отображается на странице.	from InteractsWithPages
$this	dontSeeLink(string $text, string\|null $url = null) Утверждать, что заданная ссылка не отображается на странице.	from InteractsWithPages
bool	hasLink(string $text, string\|null $url = null) Проверить, имеет ли страница ссылку с заданным $text и необязательным $url.	from InteractsWithPages
string	addRootToRelativeUrl(string $url) Добавить корень, если URL является относительным (вспомогательный метод функции hasLink).	from InteractsWithPages
$this	seeInField(string $selector, string $expected) Утверждать, что поле ввода содержит заданное значение.	from InteractsWithPages
$this	dontSeeInField(string $selector, string $value) Утверждать, что поле ввода не содержит заданное значение.	from InteractsWithPages
$this	seeIsChecked(string $selector) Утверждать, что заданный флажок выбран.	from InteractsWithPages
$this	dontSeeIsChecked(string $selector) Утверждать, что заданный флажок не выбран.	from InteractsWithPages
$this	seeIsSelected(string $selector, string $expected) Утверждать, что ожидаемое значение выбрано.	from InteractsWithPages
$this	dontSeeIsSelected(string $selector, string $value) Утверждать, что заданное значение не выбрано.	from InteractsWithPages
string	getInputOrTextAreaValue(string $selector) Получить значение поля ввода или текстового поля.	from InteractsWithPages
string\|null	getSelectedValue(string $selector) Получить выбранное значение поля выбора или группы переключателей.	from InteractsWithPages
string\|null	getSelectedValueFromSelect(Crawler $field) Получить выбранное значение из поля выбора.	from InteractsWithPages
string\|null	getCheckedValueFromRadioGroup(Crawler $radioGroup) Получить выбранное значение из группы переключателей.	from InteractsWithPages
bool	isChecked(string $selector) Возвращает true, если заданный флажок установлен, false в противном случае.	from InteractsWithPages
$this	click(string $name) Нажать на ссылку с заданным текстом, именем или атрибутом ID.	from 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	json(string $method, string $uri, array $data = [], array $headers = []) Посещение заданного URI с JSON-запросом.
$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	seeJsonContains(array $data, bool $negate = false) Утверждение, что ответ содержит заданный JSON.
string	formatToExpectedJson(string $key, mixed $value) Форматирование заданного ключа и значения в JSON-строку для проверок ожиданий.
$this	seeStatusCode(int $status) Утверждение, что код состояния ответа соответствует заданному коду.
$this	seeHeader(string $headerName, mixed $value = null) Утверждение, что ответ содержит заданный заголовок и равен необязательному значению.
$this	seeCookie(string $cookieName, mixed $value = null) Утверждение, что ответ содержит заданный cookie и равен необязательному значению.
$this	withServerVariables(array $server) Определение набора переменных сервера, которые будут отправляться с запросами.
Response	call(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null) Вызов заданного URI и возврат Response.
Response	callSecure(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null) Вызов заданного URI HTTPS и возврат Response.
Response	action(string $method, string $action, array $wildcards = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null) Вызов действия контроллера и возврат Response.

Response	route(string $method, string $name, array $routeParameters = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null) Вызвать маршрут по имени и вернуть Response.
string	prepareUrlForRequest(string $uri) Преобразовать данный URI в полностью квалифицированный URL.
array	transformHeadersToServerVars(array $headers) Преобразовать массив заголовков в массив переменных $SERVER с HTTP* форматом.
void	dump() Вывести содержимое последнего ответа.

Подробности

$this visit(string $uri)

Перейти по заданному URI с запросом GET.

Параметры

string

$uri

Значение результата

$this

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

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

Параметры

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

Значение результата

$this

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

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

Параметры

Form	$form
array	$uploads

Значение результата

$this

protected array extractParametersFromForm(Form $form)

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

Параметры

Form

$form

Значение результата

array

protected $this followRedirects()

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

Значение результата

$this

protected $this clearInputs()

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

Значение результата

$this

protected $this seePageIs(string $uri)

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

Параметры

string

$uri

Значение результата

$this

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

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

Параметры

string	$uri
string\|null	$message

Значение результата

void

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

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

Параметры

string	$text
bool	$negate

Значение результата

$this

protected $this dontSee(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

protected bool hasInElement(string $element, string $text)

Проверка наличия текста на странице внутри заданного элемента.

Параметры

string	$element
string	$text

Значение результата

bool

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

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

Параметры

string	$text
string\|null	$url

Значение результата

$this

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

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

Параметры

string	$text
string\|null	$url

Значение результата

$this

protected bool hasLink(string $text, string|null $url = null)

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

Параметры

string	$text
string\|null	$url

Значение результата

bool

protected string addRootToRelativeUrl(string $url)

Добавить корень, если URL относительный (вспомогательный метод функции hasLink).

Параметры

string

$url

Значение результата

string

$this seeInField(string $selector, string $expected)

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

Параметры

string	$selector
string	$expected

Значение результата

$this

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

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

Параметры

string	$selector
string	$value

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

$this

$this seeIsChecked(string $selector)

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

Параметры

string

$selector

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

$this

$this dontSeeIsChecked(string $selector)

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

Параметры

string

$selector

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

$this

$this seeIsSelected(string $selector, string $expected)

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

Параметры

string	$selector
string	$expected

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

$this

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

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

Параметры

string	$selector
string	$value

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

$this

protected string getInputOrTextAreaValue(string $selector)

Получить значение поля ввода или текстовой области.

Параметры

string

$selector

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

string

Исключения

Exception

protected string|null getSelectedValue(string $selector)

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

Параметры

string

$selector

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

string|null

Исключения

Exception

protected string|null getSelectedValueFromSelect(Crawler $field)

Получить выбранное значение из поля выбора.

Параметры

Crawler

$field

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

string|null

Исключения

Exception

protected string|null getCheckedValueFromRadioGroup(Crawler $radioGroup)

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

Параметры

Crawler

$radioGroup

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

string|null

Исключения

Exception

protected bool isChecked(string $selector)

Возвращает true, если указанная галочка выбрана, и false в противном случае.

Параметры

string

$selector

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

bool

Исключения

Exception

protected $this click(string $name)

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

Параметры

string

$name

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

$this

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

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

Параметры

string	$text
string	$element

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

$this

protected $this check(string $element)

Выбрать галочку на странице.

Параметры

string

$element

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

$this

protected $this uncheck(string $element)

Снять выделение с галочки на странице.

Параметры

string

$element

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

$this

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

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

Параметры

string	$option
string	$element

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

$this

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

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

Параметры

string	$absolutePath
string	$element

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

$this

protected $this press(string $buttonText)

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

Параметры

string

$buttonText

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

$this

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

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

Параметры

string	$buttonText
array	$inputs
array	$uploads

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

$this

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

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

Параметры

string	$buttonText
array	$inputs

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

Form

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

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

Параметры

string|null

$buttonText

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

Form

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

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

Параметры

string	$element
string	$text

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

$this

protected void assertFilterProducesResults(string $filter)

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

Параметры

string

$filter

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

void

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

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

Параметры

string	$name
array\|string	$elements

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

Crawler

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

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

Параметры

Form	$form
array	$uploads

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

array

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

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

Параметры

array	$file
array	$uploads
string	$name

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

UploadedFile

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

Обращение к заданному URI с JSON-запросом.

Параметры

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

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

$this

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

Обращение к заданному URI с запросом GET.

Параметры

string	$uri
array	$headers

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

$this

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

Обращение к заданному URI с запросом POST.

Параметры

string	$uri
array	$data
array	$headers

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

$this

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

Обращение к заданному URI с запросом PUT.

Параметры

string	$uri
array	$data
array	$headers

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

$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 = [])

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

Параметры

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

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

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

Параметры

array	$data
bool	$negate

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

$this

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 seeCookie(string $cookieName, mixed $value = null)

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

Параметры

string	$cookieName
mixed	$value

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

$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 и возвращает ответ.

Параметры

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

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

Response

Response 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

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

Response

Response 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

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

Response

Response 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

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

Response

protected string prepareUrlForRequest(string $uri)

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

Параметры

string

$uri

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

string

protected array transformHeadersToServerVars(array $headers)

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

Параметры

array

$headers

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

array

void dump()

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

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

void

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