Spec-Zone.ru › Web APIs

XMLHttpRequest: метод open()

Базовая реализация Широко доступна

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Потоках выполнения JavaScript, за исключением Сервисных работников.

Метод XMLHttpRequest open() инициализирует вновь созданный запрос или повторно инициализирует существующий.

Примечание: Вызов этого метода для уже активного запроса (для которого open() уже был вызван) эквивалентен вызову abort().

Синтаксис

open(method, url)
open(method, url, async)
open(method, url, async, user)
open(method, url, async, user, password)

Параметры

method

Метод HTTP запроса, например, "GET", "POST", "PUT", "DELETE", и т. д. Игнорируется для URL, не являющихся HTTP(S).

url

Строка или любой другой объект со строковым преобразованием — включая объект URL — предоставляющий URL ресурса, к которому необходимо отправить запрос.

async Необязательно

Необязательный булевый параметр, по умолчанию true, указывающий, будет ли операция выполняться асинхронно. Если это значение false, метод send() не возвращает значение, пока не будет получен ответ. Если true, уведомление о завершении транзакции предоставляется с помощью обработчиков событий. Это обязательно должно быть true, если атрибут multipart равен true, иначе будет выброшено исключение.

Примечание: Синхронные запросы в основном потоке могут существенно ухудшить пользовательский опыт и должны быть избегаемы; на самом деле многие браузеры полностью устарели синхронную поддержку XHR в основном потоке. Синхронные запросы разрешены в Worker.

user Необязательно

Необязательное имя пользователя для целей аутентификации; по умолчанию это значение null.

password Необязательно

Необязательный пароль для целей аутентификации; по умолчанию это значение null.

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

None (undefined).

Спецификации

Спецификация
XMLHttpRequest
# the-open()-method

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
open 1 12
1Начиная с Firefox 30, синхронные запросы в основном потоке были устаревши, из-за негативного влияния на производительность и пользовательский опыт. Поэтому параметр async может быть не false за исключением Worker.
8 1.2 18
4Начиная с Firefox для Android 30, синхронные запросы в основном потоке были устаревши, из-за негативного влияния на производительность и пользовательский опыт. Поэтому параметр async может быть не false за исключением Worker.
10.1 1 1.0 4.4

См. также

  • Использование XMLHttpRequest
  • Связанные методы XMLHttpRequest: setRequestHeader(), send() и abort()

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/open

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API