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.
protected $this makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [])
Выполнение запроса к приложению и создание экземпляра Crawler.
protected void resetPageContext()
Очистка значения crawler и subcrawlers для сброса контекста страницы.
protected $this makeRequestUsingForm(Form $form, array $uploads = [])
Выполнение запроса к приложению с использованием заданной формы.
protected array extractParametersFromForm(Form $form)
Извлечение параметров из заданной формы.
protected $this followRedirects()
Следование перенаправлениям из последнего ответа.
protected $this clearInputs()
Очистка входных данных для текущей страницы.
protected $this seePageIs(string $uri)
Утверждение, что текущая страница соответствует заданному URI.
protected void assertPageLoaded(string $uri, string|null $message = null)
Утверждение, что заданная страница успешно загрузилась.
$this within(string $element, Closure $callback)
Сужение содержимого теста до определенной области страницы.
protected Crawler crawler()
Получение текущего crawler в соответствии с контекстом теста.
protected $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)
Утверждение, что заданный чекбокс не выбран.
protected $this click(string $name)
Нажать на ссылку с заданным телом, именем или атрибутом ID.
protected $this type(string $text, string $element)
Заполнить поле ввода заданным текстом.
protected $this check(string $element)
Установить флажок на странице.
protected $this uncheck(string $element)
Снять флажок на странице.
protected $this select(string $option, string $element)
Выбрать опцию из выпадающего списка.
protected $this attach(string $absolutePath, string $element)
Прикрепить файл к полю формы на странице.
protected $this press(string $buttonText)
Отправить форму, используя кнопку с заданным текстом.
protected $this submitForm(string $buttonText, array $inputs = [], array $uploads = [])
Отправить форму на странице с заданными данными.
protected Form fillForm(string $buttonText, array $inputs = [])
Заполнить форму заданными данными.
protected Form getForm(string|null $buttonText = null)
Получить форму со страницы по тексту кнопки отправки.
protected $this storeInput(string $element, string $text)
Сохранить элемент ввода формы в локальный массив.
protected void assertFilterProducesResults(string $filter)
Проверить, что отфильтрованный Crawler возвращает узлы.
protected Crawler filterByNameOrId(string $name, array|string $elements = '*')
Отфильтровать элементы по заданному имени или атрибуту ID.
protected array convertUploadsForTesting(Form $form, array $uploads)
Преобразовать заданные загрузки в экземпляры UploadedFile.
protected UploadedFile getUploadedFileForTesting(array $file, array $uploads, string $name)
Создать экземпляр UploadedFile для тестирования.
$this withoutMiddleware()
Отключить middleware для теста.
$this json(string $method, string $uri, array $data = [], array $headers = [])
Обратиться к заданному URI с JSON-запросом.
protected 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)
Отправить заданный запрос через приложение.
Этот метод позволяет полностью настроить весь объект Request.
protected $this shouldReturnJson(array $data = null)
Утверждать, что ответ содержит JSON.
protected $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-ответ имеет заданную структуру.
protected $this seeJsonContains(array $data, bool $negate = false)
Утверждать, что ответ содержит заданный JSON.
protected $this seeJsonSubset(array $data)
Утверждать, что ответ является надмножеством заданного JSON.
protected array decodeResponseJson()
Проверить и вернуть декодированный JSON ответа.
protected string formatToExpectedJson(string $key, mixed $value)
Отформатировать заданный ключ и значение в строку JSON для проверки ожиданий.
protected $this seeStatusCode(int $status)
Утверждает, что код состояния ответа соответствует заданному коду.
protected $this seeHeader(string $headerName, mixed $value = null)
Утверждает, что ответ содержит заданный заголовок и равен необязательному значению.
protected $this seePlainCookie(string $cookieName, mixed $value = null)
Утверждает, что ответ содержит заданный cookie и равен необязательному значению.
protected $this seeCookie(string $cookieName, mixed $value = null, bool $encrypted = true)
Утверждает, что ответ содержит заданный cookie и равен необязательному значению.
protected $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)
Вызвать указанный HTTPS URI и вернуть ответ.
Ответ action(string $method, string $action, array $wildcards = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)
Вызвать действие контроллера и вернуть ответ.
Ответ route(string $method, string $name, array $routeParameters = [], array $parameters = [], array $cookies = [], array $files = [], array $server = [], string $content = null)
Вызвать маршрут с именем и вернуть ответ.
protected string prepareUrlForRequest(string $uri)
Преобразовать данный URI в полностью квалифицированный URL.
protected 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()
Вывести содержимое последнего ответа.
© 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