InteractsWithPages

trait InteractsWithPages (View source)

Свойства

protected Crawler	$crawler	Экземпляр DomCrawler.
protected array	$subCrawlers	Вложенные экземпляры обходчика, используемые методом «within».
protected array	$inputs	Все сохранённые входные данные для текущей страницы.
protected array	$uploads	Все сохранённые загрузки для текущей страницы.

Методы

$this	visit(string $uri) Перейти по заданному URI с запросом GET.
$this	visitRoute(string $route, array $parameters = []) Перейти по заданному маршруту с запросом GET.
$this	makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = []) Отправить запрос к приложению и создать экземпляр Crawler.
$this	resetPageContext() Очистить значения ползунка и подползунков для сброса контекста страницы.
$this	makeRequestUsingForm(Form $form, array $uploads = []) Отправить запрос к приложению с помощью заданной формы.
array	extractParametersFromForm(Form $form) Извлечь параметры из заданной формы.
$this	followRedirects() Следовать перенаправлениям из последнего ответа.
$this	clearInputs() Очистить входные данные для текущей страницы.
$this	seePageIs(string $uri) Утверждение, что текущая страница соответствует заданному URI.
$this	seeRouteIs(string $route, array $parameters = []) Утверждение, что текущая страница соответствует заданному именованному маршруту.
$this	assertPageLoaded(string $uri, string\|null $message = null) Утверждение, что заданная страница успешно загрузилась.
$this	within(string $element, Closure $callback) Сузить содержимое теста до определенной области страницы.
Crawler	crawler() Получить текущий ползунок в соответствии с контекстом теста.
$this	assertInPage(PageConstraint $constraint, bool $reverse = false, string $message = '') Утверждение заданного ограничения.
$this	see(string $text, bool $negate = false) Утверждение, что заданная строка видна на текущем HTML.
$this	dontSee(string $text) Утверждение, что заданная строка не видна на текущем HTML.
$this	seeElement(string $selector, array $attributes = [], bool $negate = false) Утверждение, что элемент присутствует на странице.
$this	dontSeeElement(string $selector, array $attributes = []) Утверждение, что элемент отсутствует на странице.
$this	seeText(string $text, bool $negate = false) Утверждение, что заданная строка видна в текущем тексте.
$this	dontSeeText(string $text) Утверждение, что заданная строка не видна в текущем тексте.
$this	seeInElement(string $element, string $text, bool $negate = false) Утверждение, что заданная строка видна внутри элемента.
$this	dontSeeInElement(string $element, string $text) Утверждение, что заданная строка не видна внутри элемента.
$this	seeLink(string $text, string\|null $url = null, bool $negate = false) Утверждение, что заданная ссылка видна на странице.
$this	dontSeeLink(string $text, string\|null $url = null) Утверждение, что заданная ссылка не видна на странице.
$this	seeInField(string $selector, string $expected, bool $negate = false) Утверждение, что поле ввода содержит заданное значение.
$this	dontSeeInField(string $selector, string $value) Утверждение, что поле ввода не содержит заданное значение.
$this	seeIsSelected(string $selector, string $value, bool $negate = false) Утверждение, что ожидаемое значение выбрано.
$this	dontSeeIsSelected(string $selector, string $value) Утверждение, что данное значение не выбрано.
$this	seeIsChecked(string $selector, bool $negate = false) Утверждение, что данный флажок выбран.
$this	dontSeeIsChecked(string $selector) Утверждение, что данный флажок не выбран.
$this	click(string $name) Нажать на ссылку с заданным телом, именем или атрибутом ID.
$this	type(string $text, string $element) Заполнить поле ввода заданным текстом.
$this	check(string $element) Выбрать флажок на странице.
$this	uncheck(string $element) Снять выделение с флажка на странице.
$this	select(string $option, string $element) Выбрать вариант из раскрывающегося списка.
$this	attach(string $absolutePath, string $element) Прикрепить файл к полю формы на странице.
$this	press(string $buttonText) Отправить форму с помощью кнопки с заданным текстовым значением.
$this	submitForm(string $buttonText, array $inputs = [], array $uploads = []) Отправить форму на странице с заданным входом.
Form	fillForm(string $buttonText, array $inputs = []) Заполнить форму заданными данными.
Form	getForm(string\|null $buttonText = null) Получить форму со страницы с заданным текстом кнопки отправки.
$this	storeInput(string $element, string $text) Сохранить входной параметр формы в локальном массиве.
$this	assertFilterProducesResults(string $filter) Утверждение, что отфильтрованный ползунок возвращает узлы.
Crawler	filterByNameOrId(string $name, array\|string $elements = '*') Фильтр элементов по заданному имени или атрибуту ID.
array	convertUploadsForTesting(Form $form, array $uploads) Преобразовать заданные загрузки в экземпляры UploadedFile.
prepareArrayBasedFileInput(array $uploads, string $key, mixed $file) Сохранить загрузку файла на основе массива с правильной вложенной структурой массива.

UploadedFile

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

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

Подробности

$this visit(string $uri)

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

Параметры

string

$uri

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

$this

$this visitRoute(string $route, array $parameters = [])

Посетить указанный маршрут с запросом GET.

Параметры

string	$route
array	$parameters

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

$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 resetPageContext()

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

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

$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 $this seeRouteIs(string $route, array $parameters = [])

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

Параметры

string	$route
array	$parameters

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

$this

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

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

Параметры

string	$uri
string\|null	$message

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

$this

Исключения

HttpException

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

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

Параметры

string	$element
Closure	$callback

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

$this

protected Crawler crawler()

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

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

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)

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

Parameters

string

$text

Return Value

$this

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

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

Parameters

string	$element
string	$text
bool	$negate

Return Value

$this

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

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

Parameters

string	$element
string	$text

Return Value

$this

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

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

Parameters

string	$text
string\|null	$url
bool	$negate

Return Value

$this

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

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

Parameters

string	$text
string\|null	$url

Return Value

$this

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

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

Parameters

string	$selector
string	$expected
bool	$negate

Return Value

$this

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

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

Parameters

string	$selector
string	$value

Return Value

$this

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

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

Parameters

string	$selector
string	$value
bool	$negate

Return Value

$this

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

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

Parameters

string	$selector
string	$value

Return Value

$this

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

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

Parameters

string	$selector
bool	$negate

Return Value

$this

$this dontSeeIsChecked(string $selector)

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

Parameters

string

$selector

Return Value

$this

protected $this click(string $name)

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

Parameters

string

$name

Return Value

$this

Exceptions

InvalidArgumentException

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

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

Parameters

string	$text
string	$element

Return Value

$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 Форма getForm(string|null $buttonText = null)

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

Параметры

string|null

$buttonText

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

Форма

Исключения

Исключение неверного аргумента

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

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

Параметры

string	$element
string	$text

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

$this

protected $this assertFilterProducesResults(string $filter)

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

Параметры

string

$filter

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

$this

Исключения

Исключение неверного аргумента

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

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

Параметры

string	$name
array\|string	$elements

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

Crawler

protected массив convertUploadsForTesting(Form $form, array $uploads)

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

Параметры

Форма	$form
массив	$uploads

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

массив

protected prepareArrayBasedFileInput(array $uploads, string $key, mixed $file)

Сохранить загрузку файла, основанную на массиве, с соответствующей вложенной структурой массива.

Параметры

массив	$uploads
string	$key
смешанный тип	$file

protected ФайлЗагрузки getUploadedFileForTesting(array $file, array $uploads, string $name)

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

Параметры

массив	$file
массив	$uploads
строка	$name

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

ФайлЗагрузки

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