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

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

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

void

resetPageContext()

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

$this

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

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

array

extractParametersFromForm(Form $form)

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

$this

followRedirects()

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

$this

clearInputs()

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

$this

seePageIs(string $uri)

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

void

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)

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

void

assertFilterProducesResults(string $filter)

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

Crawler

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

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

array

convertUploadsForTesting(Form $form, array $uploads)

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

UploadedFile

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

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

Подробности

$this visit(string $uri)

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

Параметры

string

$uri

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

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

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

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

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

Return Value

Crawler

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

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

Parameters

PageConstraint	$constraint
bool	$reverse
string	$message

Return Value

$this

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

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

Parameters

string	$text
bool	$negate

Return Value

$this

$this dontSee(string $text)

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

Parameters

string

$text

Return Value

$this

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

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

Parameters

string	$selector
array	$attributes
bool	$negate

Return Value

$this

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

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

Parameters

string	$selector
array	$attributes

Return Value

$this

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

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

Parameters

string	$text
bool	$negate

Return Value

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

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

Параметры

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)

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

Параметры

string

$name

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

$this

Исключения

InvalidArgumentException

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

Исключения

InvalidArgumentException

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

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

Параметры

string	$element
string	$text

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

$this

protected void assertFilterProducesResults(string $filter)

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

Параметры

string

$filter

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

void

Исключения

InvalidArgumentException

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

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