Конструктор

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

.

Константы

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

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

Метод

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

Вызван метод

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

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

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». Это свойство можно установить только после вызова метода

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