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 | visitRoute(string $route, array $parameters = []) Посетить указанный именованный маршрут с помощью GET-запроса. | из InteractsWithPages |
| $this | makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = []) Отправить запрос к приложению и создать экземпляр Crawler. | из InteractsWithPages |
| $this | 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 |
| $this | seeRouteIs(string $route, array $parameters = []) Утверждать, что текущая страница соответствует заданному именованному маршруту. | из InteractsWithPages |
| $this | assertPageLoaded(string $uri, string|null $message = null) Утверждать, что заданная страница успешно загрузилась. | из InteractsWithPages |
| $this | within(string $element, Closure $callback) Сузить область теста до определенной области страницы. | из InteractsWithPages |
| 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 |
| $this | assertFilterProducesResults(string $filter) Утверждение, что отфильтрованный Crawler возвращает узлы. | из InteractsWithPages |
| Crawler | filterByNameOrId(string $name, array|string $elements = '*') Фильтр элементов по заданному имени или атрибуту ID. | из InteractsWithPages |
| array | convertUploadsForTesting(Form $form, array $uploads) Преобразовать заданные загрузки в экземпляры UploadedFile. | из InteractsWithPages |
| prepareArrayBasedFileInput(array $uploads, string $key, mixed $file) Хранить загрузку файла на основе массива с правильной вложенной структурой массива. | из 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 | getJson(string $uri, array $headers = []) Посетить указанный URI с GET-запросом, ожидая JSON-ответ. | |
| $this | post(string $uri, array $data = [], array $headers = []) Посетить указанный URI с POST-запросом. | |
| $this | postJson(string $uri, array $data = [], array $headers = []) Посетить указанный URI с POST-запросом, ожидая JSON-ответ. | |
| $this | put(string $uri, array $data = [], array $headers = []) Посетить указанный URI с PUT-запросом. | |
| $this | putJson(string $uri, array $data = [], array $headers = []) Посетить указанный URI с PUT-запросом, ожидая JSON-ответ. | |
| $this | patch(string $uri, array $data = [], array $headers = []) Посетить указанный URI с PATCH-запросом. | |
| $this | patchJson(string $uri, array $data = [], array $headers = []) Посетить указанный URI с PATCH-запросом, ожидая JSON-ответ. | |
| $this | delete(string $uri, array $data = [], array $headers = []) Посетить указанный URI с DELETE-запросом. | |
| $this | deleteJson(string $uri, array $data = [], array $headers = []) Посетить указанный URI с DELETE-запросом, ожидая JSON-ответ. | |
| $this | handle(Request $request) Отправить заданный запрос через приложение. | |
| $this | shouldReturnJson(array $data = null) Утверждение, что ответ содержит JSON. | |
| $this|null | receiveJson(array $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*. | |
| mixed | filterFiles(array $files) Фильтрация заданного массива файлов, удаляя любые пустые значения. | |
| $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.
$this visitRoute(string $route, array $parameters = [])
Переход по заданному именованному маршруту с запросом GET.
protected $this makeRequest(string $method, string $uri, array $parameters = [], array $cookies = [], array $files = [])
Отправка запроса к приложению и создание экземпляра Crawler.
protected $this 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 $this seeRouteIs(string $route, array $parameters = [])
Утвердить, что текущая страница соответствует заданному именованному маршруту.
protected $this assertPageLoaded(string $uri, string|null $message = null)
Утвердить, что заданная страница успешно загрузилась.
$this within(string $element, Closure $callback)
Сузить область тестирования до определённой области страницы.
protected 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)
Нажать на ссылку с заданным атрибутом body, 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 $this assertFilterProducesResults(string $filter)
Утверждать, что отфильтрованный Crawler возвращает узлы.
protected Crawler filterByNameOrId(string $name, array|string $elements = '*')
Отфильтровать элементы по заданному атрибуту имени или ID.
protected array convertUploadsForTesting(Form $form, array $uploads)
Преобразовать заданные загрузки в экземпляры UploadedFile.
protected prepareArrayBasedFileInput(array $uploads, string $key, mixed $file)
Хранение загрузки файла, основанного на массиве, с правильной вложенной структурой массива.
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 getJson(string $uri, array $headers = [])
Обращение к указанному URI с запросом GET, ожидая JSON-ответ.
$this post(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом POST.
$this postJson(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом POST, ожидая JSON-ответ.
$this put(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом PUT.
$this putJson(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом PUT, ожидая JSON-ответ.
$this patch(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом PATCH.
$this patchJson(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом PATCH, ожидая JSON-ответ.
$this delete(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом DELETE.
$this deleteJson(string $uri, array $data = [], array $headers = [])
Обращение к указанному URI с запросом DELETE, ожидая JSON-ответ.
$this handle(Request $request)
Пересылка заданного запроса через приложение.
Этот метод позволяет полностью настроить весь объект Request.
protected $this shouldReturnJson(array $data = null)
Проверка, что ответ содержит JSON.
protected $this|null receiveJson(array $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)
Вызов заданного 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)
Вызов именованного маршрута и возврат ответа.
protected string prepareUrlForRequest(string $uri)
Преобразование заданного URI в полностью квалифицированный URL.
protected array transformHeadersToServerVars(array $headers)
Преобразовать массив заголовков в массив переменных $SERVER с форматом HTTP*.
protected mixed filterFiles(array $files)
Фильтрует предоставленный массив файлов, удаляя все пустые значения.
$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.3/Illuminate/Foundation/Testing/Concerns/MakesHttpRequests.html