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