Чтение онлайн

5. После того как свойство

достигнет значения 4, можно проверить код состояния в свойстве , чтобы убедиться, что запрос завершился успехом. В этом случае методом или следует извлечь значения из заголовка ответа и с помощью свойства или получить тело ответа.

Объект

определяет относительно высокоуровневый прикладной интерфейс к протоколу HTTP. Он учитывает такие особенности, как обработка переадресации, управление cookies и обслуживание меж доменных запросов с заголовками CORS.

Возможности объекта

, описанные выше, прекрасно поддерживаются всеми современными броузерами. На момент написания этих строк велись работы над стандартом «XMLHttpRequest Level 2», и производители броузеров уже приступили к его реализации. Свойства, методы и обработчики событий, перечисленные ниже, включают особенности, введенные спецификацией «XMLHttpRequest Level 2», которые могут быть реализованы не во всех броузерах. Эти новые особенности помечены строкой «XHR2».

Конструктор

Этот конструктор, не имеющий аргументов, возвращает новый объект

.

Константы

Начальное состояние. Объект

только что создан или сброшен в исходное состояние вызовом метода .

Метод

уже вызван, но обращения к методу еще не было. Запрос еще не отправлен.

Вызван метод

и приняты заголовки ответа, но тело ответа еще не принято.

Начат прием тела ответа, но прием еще не завершился.

HTTP-ответ принят полностью или прием был остановлен из-за ошибки.

Свойства

Состояние HTTP-запроса. В момент создания объекта

это свойство приобретает значение 0, а к моменту получения полного HTTP-ответа это значение возрастает до 4. Возможные значения свойства определяют константы, перечисленные выше.

Значение свойства

может уменьшаться, только если в процессе выполнения запроса был вызван метод или

Теоретически при каждом изменении значения этого свойства должен вызываться обработчик события

. Однако на практике событие гарантированно возникает, только когда свойство получает значение 4. (События «progress», введенные спецификацией XHR2, обеспечивают более надежный способ слежения за ходом выполнения запроса.)

В спецификации XHR2 это свойство хранит ответ сервера. Тип свойства зависит от значения свойства

. Если содержит пустую строку или строку «text», данное свойство содержит тело ответа в виде строки. Если содержит строку «document», значением данного свойства будет объект , полученный в результате разбора XML- или HTML-документа в теле ответа. Если содержит строку «arraybuffer», значением данного свойства будет объект , представляющий двоичные данные в теле ответа. А если содержит строку «ЫоЬ», значением данного свойства будет объект , представляющий двоичные данные в теле ответа.

Если значение свойства

меньше 3, данное свойство будет содержать пустую строку. Если значение свойства равно 3, данное свойство возвращает часть ответа, которая была принята к текущему моменту. Если значение свойства равно 4, это свойство содержит полное тело ответа.

Если в ответе имеется заголовок, определяющий кодировку символов в теле ответа, используется эта кодировка, в противном случае предполагается кодировка UTF-8.

В спецификации ХHR2 это свойство определяет тип ответа и тип свойства

. Допустимыми значениями являются «text», «document», «arraybuffer» и «blob».

Значением по умолчанию является пустая строка, которая также является синонимом значения «text». Если установить это свойство вручную, последующие попытки обратиться к свойствам

и будут возбуждать исключения и для получения ответа сервера необходимо будет использовать свойство , предусмотренное спецификацией XHR2.

Ответ на запрос, который интерпретируется как XML- или HTML-документ и возвращается в виде объекта

. Это свойство будет иметь значение null, если тело ответа еще не получено или оно не является допустимым XML или HTML-документом.

HTTP-код состояния, полученный от сервера, такой как 200 - в случае успеха, 404 - в случае ошибки отсутствия документа или 0 - если сервер еще не прислал код состояния.

Это свойство содержит текст, соответствующий HTTP-коду состояния в ответе. То есть, когда свойство

имеет значение 200, это свойство содержит строку «ОК», а когда 404 - строку «Not Found». Это свойство содержит пустую строку, если сервер еще не прислал код состояния.

Свойство, введенное спецификацией XHR2, определяющее предельное время ожидания ответа в миллисекундах. Если выполнение HTTP-запроса займет больше времени, чем указано в данном свойстве, он будет прерван и будет сгенерировано событие «timeout». Это свойство можно установить только после вызова метода

и перед вызовом метода