Internet Explorer 8: XDomainRequest

Введение

Новый Internet Explorer 8 (IE8) принес с собой одно приятное нововведение, призванное, как когда-то это сделал XMLHttpRequest, облегчить жизнь программистам и дать бОльшие возможности для взаимодействия с пользователем.

Напомню, что XMLHttpRequest может работать при условии, что запрашиваемый документ и страница, с которой направлен запрос, должны быть в одном домене. Например, http://www.landgraph.ru/test/test_xml.html - страницы с кодом запроса XMLHttpRequest и http://www.landgraph.ru/test/test_xml.xml - запрашиваемый XML файл.

Новой "фишкой" восьмой версии IE8 является интерфейс XDomainRequest (IHTMLXDomainRequest), с помощью которого, в отличие от XMLHttpRequest, можно делать запросы к различным доменам. Другими словами, страница с кодом XDomainRequest может находиться по адресу http://www.landgraph.ru/test/test.html, а запрашиваемая страница - http://www.google.com/.

Описание XDomainRequest

Рассмотрим структуру интерфейса. Основные элементы интерфейса, необходимые для работы, отмечены жирным шрифтом.

Свойства

Каждый объект XDomainRequest имеет следующие свойства:

События

Объект XDomainRequest может порождать следующие события:

Методы

Все объекты XDomainRequest обладают следующим набором методов:

object.open(Method, URL)

object.send([Data])

object.abort()

Использование

Отправка запроса

Теперь перейдем к программированию. Все примеры написаны на языке JavaScript. Проверить наличие XDomainRequest можно просто:

if(window.XDomainRequest) {
	//Действия при наличии интерфейса
	}
else {
	//Действия при отсутствии интерфейса
	}

В принципе, все точно так же, как и при работе с XMLHttpRequest.

Создать объект интерфейса можно с помощью следующего кода:

	var xdr = new window.XDomainRequest;

Теперь необходимо открыть соединение с сервером. Сделать это можно с помощью метода open:

	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");

В данном случае мы указываем метод GET передачи запроса. Далее следует отослать запрос с помощью метода send:

	xdr.send("какие-то данные");

При этом, мы можем и не передавать данные, а вызвать метод без параметров:

	xdr.send();

Всё. На этом передача данных завершается. Итого у нас получился следующий код:

if(window.XDomainRequest) {
	var xdr = new window.XDomainRequest;
	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");
	xdr.send();
	}
else {
	alert("XDomainRequest отсутствует!");
	}

Получение данных

Практически всегда необходимо также получить данные от сервера. Сделать это можно, если установить обработчик события onload объекта. Напомню, что событие onload происходит, когда данные от сервера получены в полном объеме.

xdr.onload=xdrLoad;
...
function xdrLoad() {
	var data=xdr.responseText;
	//Выполнение действий с полученными данными
	}

Например, следующий код выводит полученные данные в виде сообщения:

if(window.XDomainRequest) {
	var xdr = new window.XDomainRequest;
	xdr.onload=xdrLoad;
	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");
	xdr.send();
	}
else {
	alert("XDomainRequest отсутствует!");
	}

function xdrLoad() {
	var data=xdr.responseText;
	alert("Приняты данные следующего содержания:\r\n"+data);
	}

Обработка ошибок

Не секрет, во время работы происходят те или иные ошибки. И лучше пользователю либо узнать об их появлении, либо обработать самостоятельно. Пока что мы можем обработать только два вида ошибок: превышение времени ожидания ответа сервера и все остальные ошибки. Первые обрабатываются через событие ontimeout, вторые через событие onerror. Пример:

if(window.XDomainRequest) {
	var xdr = new window.XDomainRequest;
	xdr.onerror=xdrError;
	xdr.onerror=xdrTimeOut;
	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");
	xdr.send();
	}
else {
	alert("XDomainRequest отсутствует!");
	}

function xdrError() {
	alert("Во время выполнения запроса произошла ошибка!");
	}

function xdrTimeOut() {
	alert("Истекло время ожидания ответа сервера, попробуйте еще раз!");
	}

Требования к серверу

При использовании интерфейса XDomainRequest, веб-серверу направляется запрос, в заголовке которого присутствует поле

XDomainRequest: 1

При получении подобного запроса, сервер обязательно должен установить поле заголовка ответа

XDomainRequestAllowed: 1

Иначе пользователь получит сообщение об ошибке! Ниже пример рабочего скрипта PHP, с помощью которого вы всегда можете проверить работоспособность своего детища. Для тестирования вы также можете воспользоваться страницей, постоянно расположеной по адресу http://www.landgraph.ru/test/test_xdr.php.

<?php
// Если к нам приходит запрос от XDomainRequest

if ($_SERVER['HTTP_XDOMAINREQUEST']=='1') {
	// Отвечаем клиенту, что мы поддерживаем XDomainRequest
	header('XDomainRequestAllowed: 1');
	echo "XDomainRequest works!"; 
	}
else {
	// Если страница запрошена не через XDomainRequest
	echo "XDomainRequest dont work!";
	}
?>

Ограничения

Как и везде, из соображений безопасности, есть ограничения. При использовании XDomainRequest протокол страницы, с которой идет запрос, и протокол загружаемой страницы должны быть идентичны. Другими словами, если вы открываете сохраненный на вашем локальном компьютере документ, то его протокол - file://, а внутри документа есть запрос к странице в Интернете по протоколу http://, то этот запрос не будет выполнен.

Следующая таблица показывает, какие возможны комбинации страниц, с которых разрешен доступ с помощью интерфейса XDomainRequest в другие зоны безопасности.

Из таблицы видно, что страницы, расположенные локально (http://localhost/) имеют выход на все узлы, кроме ограниченных политикой безопасности. Как видите, через Интернет могут взаимодействовать любые узлы, кроме ограниченных текущей политикой безопасности.