getElement

Получает элемент в активной вкладке, удовлетворяющий указанным условиям

Синтаксис

getElement = function(aTagName, aIndex, aAttributes, aValues, aStrong,
  aAntiAttributes, aAntiValues, aAntiStrong);

Параметры

  • aTagName
    • назначение: тэг искомого элемента
  • aIndex
    • назначение: индекс искомого элемента
  • aAttributes
    • назначение: массив атрибутов искомого элемента
  • aValues
    • назначение: массив значений атрибутов, соответствующий массиву атрибутов искомого элемента
  • aStrong
    • назначение: флаг точности совпадения значений атрибутов
  • aAntiAttributes
    • назначение: массив исключающих атрибутов
  • aAntiValues
    • назначение: массив значений исключающих атрибутов
  • aAntiStrong
    • назначение: флаг точности совпадения значений исключающих атрибутов

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

  • назначение: структура, содержащая параметры найденного элемента

Замечания

  • При поиске элемента скрипт перебирает все элементы, которые имеют значения aValues атрибутов aAttributes. Из этих элементов скрипт выбирает те элементы, которые не имеют значения aAntiValues атрибутов aAntiAttributes. Если флаг aStrong равен true, то будет найден элемент, значения aValues свойств aAttributes которого строго равны указанным (регистр при поиске не учитывается). В противном случае будет найден элемент, в значения свойств aAttributes которого входят соответствующие значения aValues. Аналогично и с флагом aAntiStrong.
  • Если индекс искомого элемента aIndex равен -1, то будет получен случайный элемент из найденных
  • Если элемент не найден, то поля результирующей структуры будут пусты.
  • Найденный элемент будет подсвечен пунктирной рамкой

Примеры

  1. //Получаем случайный элемент из всех, имеющих тег "a" (получаем случайную ссылку)
    var element = getElement('a');
    //Если элемент найден, то 
    if(element.varName !== ''){
      //эмулируем клик по нему
      clickElement(element);
    }
  2. //Загружаем страницу google.com
    loadURI('google.com');
    //Получаем кнопку поиска
    var search = getElement('button',0,['class'],['gbq']);