InteractsWithPages

trait InteractsWithPages (View source)

Свойства

protected Crawler	$crawler	Экземпляр DomCrawler.
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.

$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

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

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

$this

dontSee(string $text)

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

$this

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

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

$this

dontSeeInElement(string $element, string $text)

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

bool

hasInElement(string $element, string $text)

Проверка, содержит ли страница текст внутри данного элемента.

$this

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

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

$this

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

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

bool

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

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

string

addRootToRelativeUrl(string $url)

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

$this

seeInField(string $selector, string $expected)

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

$this

dontSeeInField(string $selector, string $value)

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

$this

seeIsChecked(string $selector)

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

$this

dontSeeIsChecked(string $selector)

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

$this

seeIsSelected(string $selector, string $expected)

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

$this

dontSeeIsSelected(string $selector, string $value)

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

string

getInputOrTextAreaValue(string $selector)

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

string|null

getSelectedValue(string $selector)

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

string|null

getSelectedValueFromSelect(Crawler $field)

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

string|null

getCheckedValueFromRadioGroup(Crawler $radioGroup)

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

bool

isChecked(string $selector)

Возвращает true, если заданный флажок выбран, иначе false.

$this

click(string $name)

Нажать на ссылку с заданным значением атрибута body, 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 = '*')

Отфильтровать элементы по заданному атрибуту name или 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.

Параметры

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)

Проверка наличия ссылки с заданным $text и необязательным $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)

Получить значение input или textarea.

Параметры

string

$selector

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

string

Исключения

Exception

protected string|null getSelectedValue(string $selector)

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

Параметры

string

$selector

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

string|null

Исключения

Exception

protected string|null getSelectedValueFromSelect(Crawler $field)

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

Параметры

Crawler

$field

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

string|null

Исключения

Exception

protected string|null getCheckedValueFromRadioGroup(Crawler $radioGroup)

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

Параметры

Crawler

$radioGroup

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

string|null

Исключения

Exception

protected bool isChecked(string $selector)

Возвращает true, если заданный checkbox выбран, иначе false.

Параметры

string

$selector

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

bool

Исключения

Exception

protected $this click(string $name)

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

Параметры

string

$name

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

$this

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

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

Параметры

string	$text
string	$element

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

$this

protected $this check(string $element)

Выбрать checkbox на странице.

Параметры

string

$element

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

$this

protected $this uncheck(string $element)

Снять выбор с checkbox на странице.

Параметры

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

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