Die abstrakte Klasse Node

Version 7.1.2

Alle Klassen von QF-Test's pseudo DOM API sind von dieser Klasse abgeleitet und implementieren damit das folgende Interface. Die Klasse befindet sich im Package de.qfs.apps.qftest.client.web.dom.


`Node findCommonAncestor(Node node1, Node node2, Node topmost)`
Liefert einen gemeinsamen Vorgänger von zwei Knoten.
Parameter
`node1`	Der erste Knoten.
`node2`	Der zweite Knoten.
`topmost`	Der oberste Knoten, bei dem die Suche stoppen soll.
Rückgabewert	Der gemeinsame Vorgänger oder null.

`Node getAncestorOfClass(String clazz)`
Liefert die nächsten Vorgänger dieser Komponente von einer angegebenen Klasse.
Parameter
`clazz`	Das Klassenname des Parents.
Rückgabewert	Der passende Vorgänger oder null.

`Node getAncestorOfClass(String clazz, int maxDepth)`
Liefert die nächsten Vorgänger dieser Komponente von einer angegebenen Klasse unter Angabe einer maximalen Suchhöhe.
Parameter
`clazz`	Das Klassenname des Parents.
`maxDepth`	Das maximale Suchlevel.
Rückgabewert	Der passende Vorgänger oder null.

`String getAttribute(String name)`
Liefert den wert eines Attributs des Knotens. Zur bequemeren Nutzung ist diese Methode bereits auf dieser Ebene für `Node` definiert. Falls es sich bei einem konkreten Knoten nicht um ein Objekt der Klasse `DomNode` handelt, ist das Ergebnis immer null. In einigen Fällen liefert diese Methode Werte für Attribute zurück, die nicht explizit angegeben wurden, z.B. die Attribute "width" und "height" für einen <IMG> Knoten. Welche Attribute implizit zur Verfügung stehen, hängt vom jeweiligen Browser ab.
Parameter
`name`	Der Name des Attributs.
Rückgabewert	Der Wert des Attributs oder null, falls es für diesen Knoten kein solches Attribut gibt.

`String getAttributeIfSpecified(String name)`
Liefert den Wert eines Attributs, sofern dieses explizit im HTML-Code spezifiziert wurde. Zur bequemeren Nutzung ist diese Methode bereits auf dieser Ebene für `Node` definiert. Falls es sich bei einem konkreten Knoten nicht um ein Objekt der Klasse `DomNode` handelt, ist das Ergebnis immer null.
Parameter
`name`	Der Name des Attributs.
Rückgabewert	Der Wert des Attributs oder null, falls für diesen Knoten kein solches Attribut explizit spezifiziert wurde.

`Node getChild(int index)`
Liefert den Kind-Knoten an einem bestimmten Index. Hinweis für Opera vor Version 86, Google Chrome und Microsoft Edge vor Version 100: Text-Knoten, die nur zur Formatierung des HTML-Codes dienen und keinen Einfluss auf die Darstellung der Webseite haben, werden im CDP-Verbindungsmodus nicht vom Browser an QF-Test übermittelt. Daher kann in diesem Verbindungsmodus mit diesen Browsern eine abweichende Zählung der Kind-Knoten auftreten. Prinzipiell ist hier ein Zugriff über `getChildrenByTagName` zu bevorzugen.
Parameter
`index`	Der Index des Kind-Knotens, beginnend mit 0.
Rückgabewert	Der Kind-Knoten an dem angegebenen Index.
Exceptions
`IllegalArgumentException`	Falls der Index negativ oder größer als die Zahl der Kind-Knoten ist.

`int getChildCount()`
Liefert die Anzahl an Kind-Knoten. Hinweis für Opera vor Version 86, Google Chrome und Microsoft Edge vor Version 100: Text-Knoten, die nur zur Formatierung des HTML-Codes dienen und keinen Einfluss auf die Darstellung der Webseite haben, werden im CDP-Verbindungsmodus nicht vom Browser an QF-Test übermittelt. Daher kann in diesem Verbindungsmodus mit diesen Browsern eine abweichende Anzahl der Kind-Knoten auftreten.
Rückgabewert	Die Anzahl an Kind-Knoten.

`Node[] getChildren()`
Liefert alle Kinder dieses Knotens als Array. Hinweis für Opera vor Version 86, Google Chrome und Microsoft Edge vor Version 100: Text-Knoten, die nur zur Formatierung des HTML-Codes dienen und keinen Einfluss auf die Darstellung der Webseite haben, werden im CDP-Verbindungsmodus nicht vom Browser an QF-Test übermittelt. Daher kann in diesem Verbindungsmodus mit diesen Browsern eine abweichende Anzahl Kind-Knoten auftreten.
Rückgabewert	Die Kind-Knoten.

`String getClassName()`
Liefert den aktuellsten Klassennamen des Knotens.
Rückgabewert	Die Name der aktuellsten Klasse des Knotens.

`String[] getClassNames()`
Liefert alle Klassen des Knotens.
Rückgabewert	Ein Array mit allen Klassen des Knotens.

`DocumentNode getDocument()`
Liefert das Dokument, zu dem dieser Knoten gehört.
Rückgabewert	Das Dokument, zu dem dieser Knoten gehört. Ein `DocumentNode` liefert sich selbst, ein `DialogNode` liefert null.

`Node getElementById(String id)`
Liefert einen direkten oder indirekten Kind-Knoten mit einer bestimmten ID. Verglichen wird hierbei nicht mit dem Original-Attribut 'ID', sondern der möglicherweise durch `IdResolver` modifizierten ID (vgl. Abschnitt 52.1.17).
Parameter
`id`	Die gesuchte ID.
Rückgabewert	Der Kind-Knoten mit der vorgegebenen ID, ein beliebiger im Fall mehrerer Treffer oder null falls keiner gefunden wird. Ein `DialogNode` liefert immer null, ein `FrameNode` Knoten reicht den Aufruf an seinen `DocumentNode` Knoten weiter und ein `DocumentNode` Knoten an seinen <HTML> Wurzelknoten.

`Node[] getElementsByClassName(String className)`
Liefert alle direkten oder indirekten Kind-Knoten mit einer bestimmten Klasse.
Parameter
`className`	Der Klassenname.
Rückgabewert	Ein Array von Kind-Knoten mit der vorgegebenen Klasse. Werden keine gefunden, wird ein leeres Array zurückgeliefert.

`Node[] getElementsById(String id)`
Liefert alle direkten oder indirekten Kind-Knoten mit einer bestimmten ID. Verglichen wird hierbei nicht mit dem Original-Attribut 'ID' , sondern der möglicherweise durch `IdResolver` modifizierten ID (vgl. Abschnitt 52.1.17).
Parameter
`id`	Die gesuchte ID.
Rückgabewert	Ein Array von Kind-Knoten mit der vorgegebenen ID. Werden keine gefunden, wird ein leeres Array zurückgeliefert. Ein `DialogNode` liefert immer ein leeres Array, ein `FrameNode` Knoten reicht den Aufruf an seinen `DocumentNode` Knoten weiter und ein `DocumentNode` Knoten an seinen <HTML> Wurzelknoten.

`Node[] getElementsByIdAndTagname(String id, String tagName)`
Liefert alle direkten oder indirekten Kind-Knoten mit einem bestimmten TagNamen und einer bestimmten ID. Verglichen wird hierbei nicht mit dem Original-Attribut 'ID', sondern der möglicherweise durch `IdResolver` modifizierten ID (vgl. Abschnitt 52.1.17).
Parameter
`id`	Die gesuchte ID.
`tagName`	Der gesuchte Tagname.
Rückgabewert	Ein Array von Kind-Knoten mit der vorgegebenen ID und dem vorgegebenen Tagnamen. Werden keine gefunden, wird ein leeres Array zurückgeliefert. Ein `DialogNode` liefert immer ein leeres Array, ein `FrameNode` Knoten reicht den Aufruf an seinen `DocumentNode` Knoten weiter und ein `DocumentNode` Knoten an seinen <HTML> Wurzelknoten.

`Node[] getElementsByTagName(String tagName)`
Liefert alle direkten oder indirekten Kind-Knoten mit einem bestimmten Tagnamen.
Parameter
`tagName`	Der gesuchte Tagname.
Rückgabewert	Ein Array von Kind-Knoten mit dem vorgegebenen Tagnamen. Werden keine gefunden, wird ein leeres Array zurückgeliefert. Ein `DialogNode` liefert immer ein leeres Array, ein `FrameNode` Knoten reicht den Aufruf an seinen `DocumentNode` Knoten weiter und ein `DocumentNode` Knoten an seinen <HTML> Wurzelknoten.

`Node getFirstChild()`
Liefert den ersten Kind-Knoten: ein Element, ein Text-Knoten oder ein Kommentar.
Rückgabewert	Der erste Kind-Knoten.

`Node getFirstElementChild()`
Liefert das erste Kind-Element (Text-Knoten und Kommentare werden übersprungen).
Rückgabewert	Das erste Kind-Element.

`String getFlatText()`
Liefert den "flachen" Textinhalt eines Knotens. Für einen einfachen Text-Knoten ist dies sein Wert. Andernfalls werden die Werte aller direkt in diesem Knoten enthaltenen Text-Knoten gesammelt. Knoten in darunter liegenden Ebenen werden nicht berücksichtigt.
Rückgabewert	Der gesamte direkte Textinhalt eines Knotens.

`String getGenericClassName()`
Liefert den generischen Klassenname des Knotens.
Rückgabewert	Der Name der generischen Klasse.

`int getIndexOfChild(Node child)`
Liefert den Index eines bestimmten Kind-Knotens.
Parameter
`child`	Der Kind-Knoten dessen Index ermittelt werden soll.
Rückgabewert	Der Index des Kind-Knoten, beginnend bei 0, oder -1 falls es sich dabei nicht um ein Kind dieses Knotens handelt.

`Node getInterestingParent()`
Liefert den interessanten Parent eines Knoten. Das ist der Parent, der auch als Parent aufgezeichnet wird. Ein `DocumentNode` auf oberster Ebene oder ein `DialogNode` liefern null. Alle anderen Knoten sollten einen Parent haben, sofern sie nicht via JavaScript aus dem DOM entfernt wurden.
Rückgabewert	Der interessante Parent des Knoten.

`Node getInterestingParent(int n)`
Liefert den interessanten Parent eines Knoten. Das ist der Parent, der auch als Parent aufgezeichnet wird. Ein `DocumentNode` auf oberster Ebene oder ein `DialogNode` liefern null. Alle anderen Knoten sollten einen Parent haben, sofern sie nicht via JavaScript aus dem DOM entfernt wurden.
Parameter
`n`	Das Level des interessanten Parents.
Rückgabewert	Der interessante Parent des Knoten.

`String getName()`
Liefert den Tagnamen eines Knoten. Dieser Name entspricht dem Type des Knotens in Großbuchstaben, z.B: "HTML" für einen <HTML> Knoten. Einfache Text-Knoten werden als `DomNode` mit dem Tagnamen "#text" repräsentiert. Pseudo-Tagnamen sind für `DocumentNodes` ("DOCUMENT") und `DialogNodes` ("DIALOG") definiert.
Rückgabewert	Der Tagname eines Knotens.

`Node getNextElementSibling()`
Liefert das nachfolgende Element auf der gleichen Ebene des DOM-Baums.
Rückgabewert	Das nachfolgende Element.

`Node getNextSibling()`
Liefert den nachfolgenden Knoten: ein Element, ein Text-Knoten oder ein Kommentar.
Rückgabewert	Der nachfolgende Knoten.

`String getNodeType()`
Liefert einen Bezeichner für die Art des Knotens. Diese Methode ist zwar nicht ganz im Sinne einer puristischen OO Doktrin, beim Traversieren des DOM aber sehr praktisch, um ohne Aufwand die Art des jeweiligen Knotens zu bestimmen.
Rückgabewert	Ein String der die Art des Knoten angibt. Die zugehörigen Konstanten sind in den konkreten Unterklassen definiert:`DocumentNode.DOCUMENT_NODE`, `FrameNode.FRAME_NODE`, `DomNode.DOM_NODE` und `DialogNode.DIALOG_NODE`.

`Node getNthParent(int n)`
Liefert den Parent vom n-tn Level.
Parameter
`n`	Das Level des Parents.
Rückgabewert	Der Parent oder null.

`Node getParent()`
Liefert den Parent eines Knoten. Ein `DocumentNode` auf oberster Ebene oder ein `DialogNode` liefern null. Alle anderen Knoten sollten einen Parent haben, sofern sie nicht via JavaScript aus dem DOM entfernt wurden.
Rückgabewert	Der Parent des Knoten.

`Node getPreviousElementSibling()`
Liefert das vorangehende Element auf der gleichen Ebene des DOM-Baums.
Rückgabewert	Das vorangehende Element.

`Node getPreviousSibling()`
Liefert den vorangehenden Knoten: ein Element, ein Text-Knoten oder ein Kommentar.
Rückgabewert	Der vorangehende Knoten.

`Object getProperty(String name)`
Liefert eine benutzerdefinierte Eigenschaft zurück.
Parameter
`name`	Der Name der Eigenschaft.
Rückgabewert	Der Wert der Eigenschaft oder null.

`String getSimpleText()`
Liefert den "einfachen" Textinhalt eines Knotens. Für einen einfachen Text-Knoten ist dies sein Wert. Andernfalls wird das DOM ab diesem Knoten traversiert und die Werte aller Text-Knoten gesammelt, die direkt in diesem Knoten, oder in "einfachen" Knoten wie <B> enthalten sind. Strukturell komplexere Knoten wie <TABLE> werden für die Suche nicht betreten.
Rückgabewert	Der einfache Textinhalt eines Knotens.

`String getText()`
Liefert den Textinhalt eines Knotens. Für einen einfachen Text-Knoten ist dies sein Wert. Andernfalls wird das DOM ab diesem Knoten traversiert und die Werte aller verschachtelten Text-Knoten gesammelt. Dabei wird darauf geachtet, Leerraum möglichst so wiederzugeben, wie er im Browser dargestellt wird.
Rückgabewert	Der gesamte direkte und indirekte Textinhalt eines Knotens.

`String getVisibleFlatText()`
Liefert den "flachen" Textinhalt eines Knotens. Für einen einfachen Text-Knoten ist dies sein Wert. Andernfalls werden die Werte aller direkt in diesem Knoten enthaltenen Text-Knoten gesammelt. Unsichtbare Knoten und Knoten in darunter liegenden Ebenen werden nicht berücksichtigt.
Rückgabewert	Der gesamte direkte sichtbare Textinhalt eines Knotens.

`String getVisibleSimpleText()`
Liefert den "einfachen" Textinhalt eines Knotens. Für einen einfachen Text-Knoten ist dies sein Wert. Andernfalls wird das DOM ab diesem Knoten traversiert und die Werte aller sichtbaren Text-Knoten gesammelt, die direkt in diesem Knoten, oder in "einfachen" Knoten wie <B> enthalten sind. Strukturell komplexere Knoten wie <TABLE> werden für die Suche nicht betreten.
Rückgabewert	Der sichtbare einfache Textinhalt eines Knotens.

`String getVisibleText()`
Liefert den Textinhalt eines Knotens. Für einen einfachen Text-Knoten ist dies sein Wert. Andernfalls wird das DOM ab diesem Knoten traversiert und die Werte aller verschachtelten Text-Knoten gesammelt, wobei unsichtbare Knoten ignoriert werden. Dabei wird darauf geachtet, Leerraum möglichst so wiederzugeben, wie er im Browser dargestellt wird.
Rückgabewert	Der gesamte direkte und indirekte sichtbare Textinhalt eines Knotens.

`boolean isAncestor(Node node)`
Prüft, ob ein angegebener Knoten ein Vorgänger des aktuellen Knotens ist.
Parameter
`node`	Der vermeintliche Vorgängerknoten.
Rückgabewert	True, falls der Knoten ein Vorgänger ist, sonst false.

`boolean isAttributeSpecified(String name)`
Prüft, ob ein Attribut eines Knotens explizit im HTML-Code spezifiziert wurde. Zur bequemeren Nutzung ist diese Methode bereits auf dieser Ebene für `Node` definiert. Falls es sich bei einem konkreten Knoten nicht um ein Objekt der Klasse `DomNode` handelt, ist das Ergebnis immer false.
Parameter
`name`	Der Name des Attributs.
Rückgabewert	True falls das Attribut für diesen Knoten explizit spezifiziert wurde.

`boolean isBrowserChrome()`
Prüft, ob der Browser, zu dem dieser Knoten gehört, eine Chrome Variante ist.
Rückgabewert	True für Chrome Varianten, ansonsten false.

`boolean isBrowserHeadless()`
Prüft, ob der Browser, zu dem dieser Knoten gehört, eine headless Browser ist.
Rückgabewert	True für Headless Browser, ansonsten false.

`boolean isBrowserMozilla()`
Prüft, ob der Browser, zu dem dieser Knoten gehört, eine Mozilla Variante ist.
Rückgabewert	True für Mozilla Varianten, ansonsten false.

`boolean isBrowserSafari()`
Prüft, ob der Browser, zu dem dieser Knoten gehört, ein Safari Browser ist.
Rückgabewert	True für Safari Browser, ansonsten false.

`boolean isMatchingClass(String className)`
Prüft, ob der Knoten von der angegebenen Klasse ist.
Parameter
`className`	Der zu prüfende Klassenname.
Rückgabewert	True, wenn der Knoten diese Klasse besitzt, sonst false.

`void setProperty(String name, Object value)`
Setzt eine benutzerdefinierte Eigenschaft.
Parameter
`name`	Der Name der Eigenschaft.
`value`	Der Wert der Eigenschaft oder null um eine Eigenschaft wieder zu entfernen.

52.11.1Die abstrakte Klasse Node

52.11.1
Die abstrakte Klasse `Node`