getElement

Gets the element in the active tab, satisfying the specified conditions

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

• aTagName
  • functions: tag of the desired element
• aIndex
  • functions: index of the desired element
• aAttributes
  • functions: array of attributes of the desired element
• aValues
  • functions: array of attribute values ​​corresponding to the array of attributes of the desired element
• aStrong
  • functions: flag of match precision of the attribute values
• aAntiAttributes
  • functions: array of exclusive attributes
• aAntiValues
  • functions: an array of values of exclusive attributes
• aAntiStrong
  • functions: flag of match precision of an exclusive attribute values

• functions: structure that contains the parameters of the found element

• When searching for an element the script enumerates all elements that have values ​​aValues of aAttributes​​ attributes. Of these elements, the script selects the elements that are not have values aAntiValues of ​​aAntiAttributes attributes. If aStrong flag is true, the element is found, the values ​​of properties aValues of ​​aAttributes of which are strictly equal to the specified (sensitive search is not considered). Otherwise, the element is found, in property values ​​aAttributes of which includes the corresponding values ​​aValues. Similarly, with the flag aAntiStrong.
• If the index of the desired element aIndex is -1, it will be obtained a random element from found ones.
• If no elements are found, then the resulting structures of the field will be empty.
• Found element is highlighted by a dotted frame

1. //Obtain a random element from all, having tag "a" (obtain random link)
   var element = getElement('a');
   //If the element is found, the
   if(element.varName !== ''){
     //emulate a click on it
     clickElement(element);
   }

2. //Load a page google.com
   loadURI('google.com');
   //Get the search button
   var search = getElement('button',0,['class'],['gbq']);