Содержание

checkAvailability

Проверяет указанную страницу на доступность. Прекращает выполнение задания, если страница оказалась недоступна.

Синтаксис

checkAvailability = function(aPage, aExpectedIP, aIncludedText, aUserAgent);
checkAvailability = function(aCheckItems);

Параметры

  • aPage
    • назначение: проверяемая страница
  • aExpectedIP
    • назначение: предполагаемый IP хоста, на котором находится страница
  • aIncludedText
    • назначение: текст, содержащийся в исходном коде проверяемой страницы
  • aUserAgent
    • назначение: User-agent, который будет указан при загрузке исходного кода проверяемой страницы
  • aCheckItems
    • назначение: массив объектов для проверки нескольких страниц

Замечания

  • Проверка страницы проходит по следующему алгоритму:
    1. проверяется доступность хоста, на котором располагается страница. Если хост доступен, то
    2. если IP хоста совпадает с aExpectedIP или aExpectedIP равен '0.0.0.0', то
    3. если aIncludedText не пустая строка, то загружается исходный код страницы с использованием aUserAgent (редиректы не поддерживаются!). Если aUserAgent пустой, то используется User-agent, установленный для браузера. Если исходный код страницы содержит aIncludedText или aIncludedText - пустая строка, то
    4. проверка пройдена, скрипт продолжает выполнение
  • Если проверка не пройдена, то скрипт прекратит выполнение
  • Процедура может быть выполнена только один раз и только в случае, если является первым выполняемым в скрипте методом. Если до этого были выполнены другие методы, то ПО проигнорирует CheckAvailability.
  • Если проверяется массив страниц, то будут проверены только первые пять элементов массива

Примеры

  1. checkAvailability('habrahabr.ru');
  2. checkAvailability('habrahabr.ru', '178.248.233.33');
  3. checkAvailability('habrahabr.ru', '178.248.233.33', 'habr');
  4. checkAvailability([
  {"page":"habrahabr.ru","expectedIP":"178.248.233.33","includedTextt":"habr"},
  {"page":"liveinternet.ru","includedText":"stat","userAgent":"my ua"}
]);