Handbuch

45.1.4
Die Klasse DomNode

Die Klasse DomNode ist von Node abgeleitet und befindet sich ebenfalls im Package de.qfs.apps.qftest.client.web.dom. Zusätzlich zu den in der Node Klasse definierten Methoden, die oben beschrieben wurden, bietet DomNode folgendes an:

 
 
getId()
Liefert die gecachte Version der ID des Knotens. Diese Version wurde eventuell durch einen IdResolver modifiziert (vgl. Abschnitt 46.1.16). Das originale, unverfälschte 'ID' Attribut kann mittels getAttribute("id") bestimmt werden.
RückgabewertDie gecachte ID des Knotens.
 
setAttribute(String name, String value)
Setzt ein Attribut des Knotens.
Parameter
nameDer Name des Attributs.
valueDer zu setzende Wert.
 
Node[] getChildrenByTagName(String tagName)
Liefert alle direkten Kinder des Knotens mit einem vorgegebenen Tagnamen.
Parameter
tagNameDer zu suchende Tagname.
Rückgabewert Ein Array mit den Kind-Knoten mit dem vorgegebenen Tagnamen. Werden keine gefunden, wird ein leeres Array zurückgeliefert.
 
boolean hasFocus()
Prüft, ob der Knoten den Tastatur-Fokus besitzt.
Rückgabewert True falls der Knoten den Tastatur-Fokus besitzt.
 
requestFocus()
Fordert den Tastatur-Fokus für den Knoten an. Ob der Knoten den Tastatur-Fokus tatsächlich erhält, hängt allerdings von Browser und Betriebssystem ab.
 
boolean isShowing()
Prüft, ob der Knoten aktuell sichtbar ist oder durch Scrollen sichtbar gemacht werden kann.
Rückgabewert True falls der Knoten sichtbar ist, false falls er nicht sichtbar ist oder sichtbar gescrollt werden kann.
 
scrollVisible()
Versucht die Webseite oder einen Frame so zu scrollen, dass der Knoten komplett sichtbar ist. Ob und wie dies geschieht, hängt allerdings von Browser und Betriebssystem ab.
 
int[] getLocationOnScreen()
Liefert Position und Größe des Knotens relativ zum Desktop.
RückgabewertDie Geometrie des Knotens in der Form [x, y, width, height].
 
void toJS(String name)
Setzt eine JavaScript Variable im Kontext des Dokuments dieses Knotens auf diesen Knoten.
Parameter
nameDer Name der zu setzenden Variable.
 
Object evalJS(String script)
Führt JavaScript Code im Context des Dokuments dieses Knotens aus.
Parameter
scriptDas auszuführende Skript.
RückgabewertWas immer das skript zurückliefert, konvertiert in einen passenden Objekttyp. Sogar die Rückgabe von DOM Knoten, Frames oder Dokumenten funktioniert.
 
boolean hasCSSClass(String cl)
Prüft, ob der Knoten eine angegebene CSS Klasse besitzt.
Parameter
clDer zu prüfende CSS-Klassenname.
RückgabewertTrue, wenn der Knoten die Klasse besitzt, sonst false.
 
DomNode getByXPath(String xpath)
Liefert einen Knoten, der mittels XPath gefunden wird.
Parameter
xpathDer XPath ab diesem Knoten.
RückgabewertDer gefundene Knoten oder null.
 
DomNode[] getAllByXPath(String xpath)
Liefert alle Knoten, die mittels XPath gefunden werden.
Parameter
xpathDer XPath ab diesem Knoten.
RückgabewertEin Array der gefundenen Knoten oder null.
 
DomNode getByCSS(String css)
Liefert einen Knoten, der mittels CSS-Selector gefunden wird.
Parameter
cssDer CSS-Selector ab diesem Knoten.
RückgabewertDer gefundene Knoten oder null.
 
DomNode[] getAllByCSS(String css)
Liefert alle Knoten, die mittels CSS-Selector gefunden werden.
Parameter
cssDer CSS-Selector ab diesem Knoten.
RückgabewertEin Array der gefundenen Knoten oder null.