МетодXMLHttpRequest.send() отправляет запрос. Если запрос асинхронный (каким он является по умолчанию), то возврат из данного метода происходит сразу после отправления запроса. Если запрос синхронный, то метод возвращает управление только после получения ответа. Методsend() принимает необязательные аргументы в тело запросов. Если метод запросаGET илиHEAD, то аргументы игнорируются и тело запроса устанавливается в null.

Если заголовокAccept не был задан с помощьюsetRequestHeader(), будет отправлено значениеAccept по умолчанию*/*.

Синтаксис

XMLHttpRequest.send(body)

Параметры

bodyНеобязательный

Данные из параметра body оправляются в запросе через XHR. Это могут быть:

• Document, и в этом случае данные будут сериализованы перед отправкой.
• BodyInit, которые, согласно спецификацииFetch могут быть:Blob,BufferSource,FormData,URLSearchParams,ReadableStream, или объектомUSVString.

Лучший способ передать двоичные данные (например при загрузке файлов) - это использованиеArrayBufferView илиBlobs в сочетании с методомsend().

Если никакого значения не определено в качествеbody, то будет использовано значение по умолчанию:null.

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

undefined.

Исключения

Пример: GET

var xhr = new XMLHttpRequest();xhr.open('GET', '/server', true);xhr.onload = function () {  // Запрос завершён. Здесь можно обрабатывать результат.};xhr.send(null);// xhr.send('string');// xhr.send(new Blob());// xhr.send(new Int8Array());// xhr.send({ form: 'data' });// xhr.send(document);

Пример: POST

var xhr = new XMLHttpRequest();xhr.open("POST", '/server', true);//Передаёт правильный заголовок в запросеxhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");xhr.onreadystatechange = function() {//Вызывает функцию при смене состояния.    if(xhr.readyState == XMLHttpRequest.DONE && xhr.status == 200) {        // Запрос завершён. Здесь можно обрабатывать результат.    }}xhr.send("foo=bar&lorem=ipsum");// xhr.send('string');// xhr.send(new Blob());// xhr.send(new Int8Array());// xhr.send({ form: 'data' });// xhr.send(document);

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

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

Смотрите также

• Использование XMLHttpRequest
• HTML in XMLHttpRequest