XMLHttpRequest

package js.html

extends XMLHttpRequestEventTarget › EventTarget

Доступно в js

Используйте объекты XMLHttpRequest (XHR), чтобы взаимодействовать с серверами. Вы можете извлекать данные из URL, не производя полной перезагрузки страницы. Это позволяет веб-странице обновлять только часть страницы без прерывания действий пользователя.

Документация XMLHttpRequest от авторов Mozilla, лицензирована по CC-BY-SA 2.5.

См. также:

• https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest

Статические переменные

staticinlineread onlyDONE:Int = 4

staticinlineread onlyHEADERS_RECEIVED:Int = 2

staticinlineread onlyLOADING:Int = 3

staticinlineread onlyOPENED:Int = 1

staticinlineread onlyUNSENT:Int = 0

Конструктор

new(ignored:String)

new(?params:Dynamic)

Исключение:

Переменные

onreadystatechange:Function

Функция, которая вызывается всякий раз, когда изменяется атрибут readyState.

read onlyreadyState:Int

Возвращает unsigned short, состояние запроса.

read onlyresponse:Dynamic

Возвращает ArrayBuffer, Blob, Document, JavaScript-объект или DOMString, в зависимости от значения XMLHttpRequest.responseType, содержащий тело ответа.

read onlyresponseText:String

Возвращает DOMString, содержащий ответ на запрос в виде текста, или null, если запрос неудачен или ещё не отправлен.

responseType:XMLHttpRequestResponseType

Перечисляет тип ответа.

read onlyresponseURL:String

Возвращает сериализованный URL ответа или пустую строку, если URL равен null.

read onlyresponseXML:HTMLDocument

Возвращает Document, содержащий ответ на запрос, или null, если запрос неудачен, ещё не отправлен или не может быть распарсен как XML или HTML.

read onlystatus:Int

Возвращает unsigned short со статусом ответа на запрос.

read onlystatusText:String

Возвращает DOMString со строковым ответом, возвращённым HTTP-сервером. В отличие от XMLHTTPRequest.status, эта строка включает в себя весь текст сообщения ответа ("200 OK", например).

timeout:Int

Это unsigned long, представляющее количество миллисекунд, которое запрос может занимать, прежде чем будет автоматически прерван.

read onlyupload:XMLHttpRequestUpload

Это XMLHttpRequestUpload, представляющее процесс загрузки.

withCredentials:Bool

Это Boolean, указывающее, должны ли межсайтовые Access-Control запросы осуществляться с использованием учётных данных, таких как куки или заголовки авторизации.

Методы

abort():Void

Прерывает запрос, если он уже отправлен.

Исключение:

getAllResponseHeaders():String

Возвращает все заголовки ответа, разделённые CRLF, как строку, или null , если ответ ещё не получен.

Исключение:

getResponseHeader(header:String):String

Возвращает строку, содержащую текст указанного заголовка, или null, если ответ ещё не получен или заголовок отсутствует в ответе.

Исключение:

open(method:String, url:String, async:Bool, ?user:String, ?password:String):Void

open(method:String, url:String):Void

Инициализирует запрос. Этот метод предназначен для использования из JavaScript-кода; для инициализации запроса из кода нативном языке используйте openRequest().

Исключение:

overrideMimeType(mime:String):Void

Переопределяет тип MIME, возвращённый сервером.

Исключение:

send(?body:HTMLDocument):Void

send(?body:Blob):Void

send(?body:ArrayBufferView):Void

send(?body:ArrayBuffer):Void

send(?body:FormData):Void

send(?body:URLSearchParams):Void

send(?body:String):Void

Отправляет запрос. Если запрос асинхронный (по умолчанию), этот метод возвращает результат сразу после отправки запроса.

Исключение:

setRequestHeader(header:String, value:String):Void

Устанавливает значение заголовка HTTP-запроса. Вы должны вызвать setRequestHeader() после open(), но до send().

Исключение: