Eine neue Ausnahme {exception} wurde den Ausnahmen speziell dieser XPath-Schnittstelle hinzugefügt.

IDL Definition

exception XPathException {
  unsigned short   code;
};
// XPathExceptionCode
const unsigned short      INVALID_EXPRESSION_ERR         = 51;
const unsigned short      TYPE_ERR                       = 52;

Definitionsgruppe {definition group} XPathExceptionCode

Definierte Konstanten

INVALID_EXPRESSION_ERR

{Trifft zu} wenn die Ausnahme {einerseits} einen Syntaxfehler hat oder andererseits keinen gültigen Ausdruck entsprechend dem spezifischen XPathEvaluator enthält oder spezielle Erweiterungsfunktionen oder Variablen hat, die von dieser Implementierung nicht unterstützt werden.

TYPE_ERR

{Trifft zu} wenn der Ausdruck nicht zur Rückgabe des angegebenen Typs konvertiert werden kann.

Die Auswertung von XPath-Ausdrücken wird bereitgestellt von XPathEvaluator. In einer DOM-Implementierung, die die XPath 3.0-Funktionalität {feature} so wie oben beschrieben unterstützt, wird die XPathEvaluator-Schnittstelle im selben Objekt implementiert, in der die Document-Schnittstelle implementiert ist, die es ermöglicht, gesetzt durch übliche bindungsspezifische Methoden wie Typwandlung {casting} oder durch die getInterface-Methode des DOM Level 3 zu wirken. In diesem Fall entspricht die Implementierung erwirkt vom Dokument dem XPath-DOM-Modul und ist kompatibel mit der Spezifikation zu XPath 1.0.

Die Auswertung von Ausdrücken mit spezialisierten Erweiterungsfunktionen oder Variablen kann möglicherweise nicht in allen Implementierungen funktionieren und ist demzufolge nicht portabel. XPathEvaluator-Implementierungen können eventuell von anderen Quellen vorfügbar sein, die spezifische Unterstützung für spezialisierte Erweiterungsfunktionen bereitstellen könnten.

IDL Definition

interface XPathEvaluator {
  XPathExpression    createExpression(in DOMString expression,
                                      in XPathNSResolver resolver)
                                        raises(XPathException,
                                               DOMException);
  XPathNSResolver    createNSResolver(in Node nodeResolver);
  DOMObject          evaluate(in DOMString expression,
                              in Node contextNode,
                              in XPathNSResolver resolver,
                              in unsigned short type,
                              in DOMObject result)
                                        raises(XPathException,
                                               DOMException);
};

Methoden

createExpression

Erzeugt einen geparsten XPath-Ausdruck mit aufgelösten Namensräumen. Das ist günstig, wenn ein Ausdruck in einer Anwendung wiederverwendet wird, weil dies es möglich macht, die Ausdruckszeichenkette in eine effizientere interne Form zu übersetzen unter Berücksichtigung aller Namensraum-Präfixe {namespace prefixes}, die innerhalb des Ausdrucks auftreten.

Parameter

expression vom Typ DOMString

Die Zeichenkette des XPath-Ausdrucks, die zu parsen ist.

resolver vom Typ XPathNSResolver

Der {Parameter} resolver ermöglicht die Übersetzung von allen Präfixen, einschließlich xml-Namenraum-Präfixen inmitten von XPath-Ausdrücken in die passenden Namensraum-URIs {namespace URIs}. Ist dafür null angegeben, so führt jeder Namensraum-Präfix {namespace prefix} mitten im Ausdruck zu DOMException mit dem Kode NAMESPACE_ERR.

Rückgabewert {Return Value}

XPathExpression

Die übersetzte Form des XPath-Ausdrucks.

Ausnahmen {Exceptions}

XPathException	INVALID_EXPRESSION_ERR: Wird gesetzt, falls der Ausdruck gemäß den Regeln von XPathEvaluator ungültig ist.
DOMException	NAMESPACE_ERR: Wird gesetzt, falls der Ausdruck Namesraum-Präfixe {namespace prefixes} enthält, die nicht vom angegebenen XPathNSResolver erkannt werden können.

createNSResolver

Passt jeden möglichen DOM-Knoten zum Erkennen von Namensräumen so an, dass ein XPath-Ausdruck relativ zum Knotenkontext leicht ausgewertet werden kann, der sich inmitten des Dokuments befindet. Der Adapter arbeitet wie die Methode lookupNamespaceURI im DOM Level 3 auf Knoten in Erkennung des Namensraum-URI von einem gegebenen Präfix mit den aktuellen Informationen die in der Knotenhierarchie vorhanden sind, im Moment des Aufrufs von lookupNamespaceURI, also dem richtigen Erkennen des impliziten xml-Präfixes.

Parameter

nodeResolver von Typ Node

Der Knoten, der als Kontext bei der Namensraumerkennung fungiert.

Rückgabewert

XPathNSResolver

XPathNSResolver erkennt Namensräume in Bezug auf die Definitionen im Bereich eines angegebenen Knotens.

Keine Ausnahmen {No Exceptions}

evaluate

Wertet die Zeichenkette des XPath-Ausdrucks aus und gibt ein Ergebnis mit dem angegebenem Typ zurück, sofern möglich.

Parameter

Ausdruck {expression} vom Typ DOMString

Die XPath-Audrucks-Zeichenkette, die zu parsen und zu bewerten ist.

contextNode vom Typ Node

Der Kontext {context} ist der Kontextknoten zur Auswertung dieses XPath-Ausdrucks. Wenn der XPathEvaluator gesetzt wurde {was obtained} durch Verarbeitung {by casting} von Document, dann muss dieser {Kontextknoten} zum gleichen Dokument gehören und muss ein Document-, Element-, Attribute-, Text-, CDATASection-, Comment-, ProcessingInstruction-, oder ein XPathNamespace-Knoten sein. Ist der Kontextknoten ein Text- oder ein CDATASection-Knoten, dann wird der Kontext interpretiert als der gesamte logische Textknoten wie von XPath gesehen; außer der Knoten ist leer, in diesem Fall kann er nicht als ein XPath-Kontext gelten.

resolver vom Typ XPathNSResolver

Der {Parameter} resolver ermöglicht die Übersetzung von allen Präfixen, einschließlich xml-Namenraum-Präfixen inmitten von XPath-Ausdrücken in die passenden Namensraum-URIs {namespace URIs}. Ist dafür null angegeben, so führt jeder Namensraum-Präfix {namespace prefix} mitten im Ausdruck zu DOMException mit dem Kode NAMESPACE_ERR.

type vom Typ unsigned short

Wenn ein bestimmter type angegeben ist, dann wird das Ergebnis mit dem entsprechenden Typ zurückgegeben.
Bei Resultaten in XPath 1.0 muss dies einer der Kodes der XPathResult-Schnittstelle sein.

result vom Typ DOMObject

result gibt ein bestimmtes Ergebnisobjekt an welches wiederverwendet werden kann und von dieser Methode zurückgegeben wird. Ist {der Parameter} mit null angegeben oder die Implementierung gestattet nicht die Wiederverwendung des angegeben result-Wertes, dann wird ein neues result-Objekt erzeugt und zurückgegeben.
Beim Ergebnis in XPath 1.0 wird dieses Objekt vom Typ XPathResult sein.

Rückgabewert

DOMObject

{Dies ist} das Ergebnis der Verarbeitung des XPath-Ausdrucks. Beim Ergebnis in XPath 1.0 wird dieses Objekt vom Typ XPathResult sein.

Ausnahmen

XPathException

INVALID_EXPRESSION_ERR: Wird gesetzt, falls der Ausdruck gemäß den Regeln von XPathEvaluator ungültig ist. TYPE_ERR: Wird gesetzt, wenn der Ausdruck nicht zur Rückgabe des entsprechenden Typs konvertiert werden kann.

DOMException

NAMESPACE_ERR: Wird gesetzt, falls der Ausdruck Namesraum-Präfixe {namespace prefixes} enthält, die nicht vom angegebenen XPathNSResolver erkannt werden können WRONG_DOCUMENT_ERR: {Gilt wenn} der Knoten als von einem Dokument stammend erkannt wird, das nicht von diesem XPathEvaluator unterstützt wird. NOT_SUPPORTED_ERR: {Gilt wenn} der Knoten nicht von einem Typ ist, der als XPath-Kontextknoten gelten kann, oder der angeforderte Typ nicht von diesem XPathEvaluator zugelassen wird.

Die XPathExpression-Schnittstelle repräsentiert einen geparsten und endverarbeiteten {resolved} XPath-Ausdruck.

IDL Definition

interface XPathExpression {
  DOMObject          evaluate(in Node contextNode,
                              in unsigned short type,
                              in DOMObject result)
                                        raises(XPathException,
                                               DOMException);
};

Methoden

evaluate

Wertet diesen XPath-Ausdruck aus und gibt ein Ergebnis zurück.

Parameter

contextNode vom Typ Node

Der Kontext {context} ist der Kontextknoten zur Auswertung dieses XPath-Ausdrucks.
Wenn der XPathEvaluator gesetzt wurde {was obtained} durch Verarbeitung {by casting} von Document, dann muss dieser {Kontextknoten} zum gleichen Dokument gehören und muss ein Document-, Element-, Attribute-, Text-, CDATASection-, Comment-, ProcessingInstruction-, oder ein XPathNamespace-Knoten sein.
Ist der Kontextknoten ein Text- oder ein CDATASection-Knoten, dann wird der Kontext interpretiert als der gesamte logische Textknoten wie von XPath gesehen; außer der Knoten ist leer, in diesem Fall kann er nicht als ein XPath-Kontext gelten.

type vom Typ unsigned short

Wenn ein bestimmter type angegeben ist, dann wird das Resultat gezwungenermaßen den angegeben type beruhend auf XPath-Konvertierungen zurückzugeben; oder schief gehen {fail}, wenn die gewünschte Zwangsumwandlung nicht möglich ist.
Dieser {Parameter} muss einer der Typkodes der XPathResult-Schnittstelle sein.

result vom Typ DOMObject

result spezifiziert ein bestimmtes Ergebnisobjekt welches wiederverwendet werden kann und von dieser Methode zurückgegeben wird. Ist {der Wert} null angegeben oder die Implementierung gestattet nicht die Wiederverwendung des angegebenen result-Wertes, dann wird ein neues result-Objekt erzeugt und zurückgegeben. Bei Ergebnissen in XPath 1.0 wird dieses Objekt vom Typ XPathResult sein.

Rückgabewert

DOMObject

{Das ist} das Ergebnis der Verarbeitung des XPath-Ausdrucks. Bei Ergebnissen in XPath 1.0 gilt, dass dieses Objekt vom Typ XPathResult ist.

Ausnahmen

XPathException	TYPE_ERR: Wird gesetzt, wenn der Ausdruck nicht zur Rückgabe des angegebenen Typs konvertiert werden kann.
DOMException	WRONG_DOCUMENT_ERR: Der Knoten wird als von einem Dokument stammend erkannt, das nicht vom XPathEvaluator unterstützt wird der diesen XPathExpression erzeugt hat. NOT_SUPPORTED_ERR: Der Knoten ist nicht von einem Typ, der als XPath-Kontextknoten gelten kann, oder der angeforderte Typ ist nicht für diesen XPathExpression zugelassen.

Die XPathNSResolver-Schnittstelle erlaubt prefix-Zeichenketten im Ausdruck vollständig mit den namespaceURI-Zeichenketten zu verbinden. XPathEvaluator kann die Implementierung eines XPathNSResolver von einem Knoten erzeugen, oder die Schnittstelle wurde von irgendeiner Anwendung {bereits} implementiert.

IDL Definition

interface XPathNSResolver {
  DOMString          lookupNamespaceURI(in DOMString prefix);
};

Methoden

lookupNamespaceURI

Aktualisiert {look up} den Namensraum-URI {namespace URI} der zum gegebenen Namensraum-Präfix {namespace prefix} gehört. Der XPath-Evaluator darf niemals diese {Methode} mit {dem Wert} null oder einem leeren Argument aufrufen, weil dann das Ergebnis undefiniert ist.

Parameter

prefix vom Typ DOMString

Der Präfix {für den der Namensraum-URI} zu aktualisieren ist.

Rückgabewert

DOMString

Gibt den entsprechenden Namensnsraum-URI {namespace URI} oder {den Wert} null zurück, wenn nichts {kein Namenraum-URI} gefunden wurde.

Keine Ausnahmen

Die XPathResult-Schnittstelle repräsentiert das Ergebnis der Auswertung {evaluation} eines Ausdrucks in XPath 1.0 inmitten des Kontextsets eines einzelnen {particular} Knotens. Nach {Since} der Auswertung eines XPath-Ausdrucks kann das Ergebnis in verschiedenen Typen vorliegen, dieses Objekt macht es möglich Typ und Wert des Ergebnisses zu erkennen {discover} und zu manipulieren.

IDL Definition

interface XPathResult {

  // XPathResultType
  const unsigned short      ANY_TYPE                       = 0;
  const unsigned short      NUMBER_TYPE                    = 1;
  const unsigned short      STRING_TYPE                    = 2;
  const unsigned short      BOOLEAN_TYPE                   = 3;
  const unsigned short      UNORDERED_NODE_ITERATOR_TYPE   = 4;
  const unsigned short      ORDERED_NODE_ITERATOR_TYPE     = 5;
  const unsigned short      UNORDERED_NODE_SNAPSHOT_TYPE   = 6;
  const unsigned short      ORDERED_NODE_SNAPSHOT_TYPE     = 7;
  const unsigned short      ANY_UNORDERED_NODE_TYPE        = 8;
  const unsigned short      FIRST_ORDERED_NODE_TYPE        = 9;

  readonly attribute unsigned short  resultType;
  readonly attribute double          numberValue;
                                        // raises(XPathException) on retrieval

  readonly attribute DOMString       stringValue;
                                        // raises(XPathException) on retrieval

  readonly attribute boolean         booleanValue;
                                        // raises(XPathException) on retrieval

  readonly attribute Node            singleNodeValue;
                                        // raises(XPathException) on retrieval

  readonly attribute boolean         invalidIteratorState;
  readonly attribute unsigned long   snapshotLength;
                                        // raises(XPathException) on retrieval

  Node               iterateNext()
                                        raises(XPathException,
                                               DOMException);
  Node               snapshotItem(in unsigned long index)
                                        raises(XPathException);
};

Definitionsgruppe {definition group} XPathResultType

Eine Ganzzahl zeigt den Typ des Ergebnisses an.

Wenn ein bestimmter Typ {type} angegeben ist, dann wird das Ergebnis als entsprechender Typ zurückgegeben unter Verwendung der XPath-Typkonvertierung {XPath type conversions}, die erforderlich und möglich ist.

Vordefinierte Konstanten

ANY_TYPE

Dieser Kodewert repräsentiert keinen bestimmten Typ. Die Auswertung eines XPath-Ausdrucks wird niemals diesen Typ erzeugen. Wird dieser Typwert angefordert, dann gibt die Auswertung das Ergebnis mit dem Typ zurück, der normalerweise {naturally} von der Auswertung des Ausdrucks erzeugt wird.
Ist das normale Ergebnis ein Knotenset wenn ANY_TYPE angefordert war, dann ist immer UNORDERED_NODE_ITERATOR_TYPE der Ergebnistyp. Jede andere Repräsentation eines Knotensets muss explizit angefordert werden.

ANY_UNORDERED_NODE_TYPE

Das Ergebnis ist ein Knotenset {node set} wie es von [XPath 1.0] definiert ist, und verhält sich wie ein Einzelknoten, der null sein kann, wenn das Knotenset leer ist. Dokumentänderungen beschädigen den Knoten nicht, erwecken aber den Eindruck, dass der Ergebnisknoten nicht mehr zum aktuellen Dokument gehört. Dies ist eine Vereinfachung, die eine Optimierung erlaubt, nachdem {since} die Implementierung {bei} jeden möglichen Knoten stehenbleibt, der im Ergebnisset gefunden wurde.
Gibt es mehr als einen Knoten im aktuellen Resultat, dann muss ein zurückgegebener Einzelknoten keineswegs der Erste in der Dokumentfolge sein.

BOOLEAN_TYPE

Das Ergebnis ist vom Typ boolean wie er in [XPath 1.0] definiert ist. Eine Dokumentänderung macht {den Typ} boolean nicht ungültig, kann aber bedeuten, dass eine Aktualisierung {reevaluation} nicht denselben boolean{schen Wert} ergeben würde.

FIRST_ORDERED_NODE_TYPE

Das Ergebnis ist ein Kontenset {node set} wie es von [XPath 1.0] definiert ist, und verhält sich wie ein Einzelknoten, der null sein kann, wenn das Knotenset leer ist. Eine Dokumentänderung kann den Knoten nicht beschädigen, erweckt aber den Eindruck, dass der Ergebnisknoten nicht mehr zum aktuellen Dokument gehört. Dies ist eine Vereinfachung, die eine Optimierung erlaubt, nachdem {since} die Implementierung {bei} jeden möglichen Knoten stehenbleibt, der im Ergebnisset gefunden wurde.
Gibt es mehr als einen Knoten im aktuellen Resultat, dann muss ein zurückgegebener Einzelknoten der Erste in der Dokumentfolge sein.

NUMBER_TYPE

Das Ergebnis ist {vom Typ} number so wie in [XPath 1.0] definiert. Eine Dokumentänderung macht {den Typ} number nicht ungültig, kann aber bedeuten, dass eine Aktualisierung {reevaluation} nicht denselben numerischen Wert {number} ergeben würde.

ORDERED_NODE_ITERATOR_TYPE

Das Ergebnis ist ein Knotenset, so wie in [XPath 1.0] definiert, das iterativ entstehen und Knoten entsprechend der Dokumentfolge erzeugen kann. Eine Dokumentänderung zerstört die Iteration.

ORDERED_NODE_SNAPSHOT_TYPE

Das Ergebnis ist ein Knotenset {node set} so wie in [XPath 1.0] definiert, und das sich wie eine Snapshotliste {snapshot list} von Knoten verhält, die sich in originaler Dokumentfolge befinden. Eine Dokumentänderung beschädigt den Snapshot nicht, kann aber dazu führen, dass eine Aktualisierung {reevaluation} nicht dasselbe Snapshot ergibt, Knoten im Snapshot verändert, verschoben oder vom Dokument entfernt sein können.

STRING_TYPE

Das Ergebnis ist eine Zeichenkette {string} so wie in [XPath 1.0] definiert. Eine Dokumentänderung beschädigt die Zeichenkette {string} nicht, kann aber dazu führen, dass die Zeichenkette {string} nicht mehr mit dem aktuellen Dokument verbunden ist.

UNORDERED_NODE_ITERATOR_TYPE

Das Ergebnis ist ein Knotenset {node set} so wie in [XPath 1.0] definiert, das iterativ entstehen und Knoten in keiner bestimmten Folge erzeugen kann. Eine Dokumentänderung zerstört die Iteration.
Dies {UNORDERED_NODE_ITERATOR_TYPE} ist der Vorgabetyp der dann zurückgegeben wird, wenn das Ergebnis ein Knotenset und ANY_TYPE angefordert ist.

UNORDERED_NODE_SNAPSHOT_TYPE

Das Ergebnis ist ein entsprechend [XPath 1.0] definiertes Knotenset {node set} das als eine Snapshotliste {snapshot list} von Knoten in keiner besonderen Reihenfolge entsteht. Eine Dokumentänderung kann das Snapshot nicht beschädigen, kann aber dazu führen, dass eine Aktualisierung nicht dasselbe Snapshot ergibt und Knoten im Snapshot verändert, verschoben oder vom Dokument entfernt sein könnten.

Attribute

booleanValue ist vom Typ boolean, readonly

Der Wert dieses {Attributes} ist ein booleansches Resultat.

Ausnahmen auf Wiederherstellung

XPathException

TYPE_ERR: wird gesetzt, wenn resultType kein BOOLEAN_TYPE ist.

invalidIteratorState vom Typ boolean, readonly

Bedeutet, dass der Iterator zerstört wurde. Logisch wahr {true}, wenn resultType ein UNORDERED_NODE_ITERATOR_TYPE oder ein ORDERED_NODE_ITERATOR_TYPE ist und das Dokument seit Rückgabe dieses Resultats verändert wurde.

numberValue vom Typ double, readonly

Der Wert dieses {Attributs} ist ein numerisches Ergebnis. Wenn der der DOM-Bindung innewohnende Typ "double" nicht exakt ein IEEE 754-konformes Ergebnis des XPath-Ausdrucks unterstützt, dann liegt es an der Definition der Bindung {selbst} anzugeben, wie der numerische XPath-Typ in die native verbindliche Zahl umgewandelt wird.

Ausnahmen auf Wiederherstellung

XPathException

TYPE_ERR: wird gesetzt, wenn resultType kein NUMBER_TYPE ist.

resultType vom Typ unsigned short, readonly

Ein Kodewert repräsentiert den Typ des Ergebnisses, wie durch die Typkonstante definiert ist.

singleNodeValue vom Typ Node, readonly

Der Wert dieses {Attributs ist ein} Einzelknoten, kann auch null sein.

Ausnahmen auf Wiederherstellung

XPathException

TYPE_ERR: wird gesetzt wenn resultType weder ein ANY_UNORDERED_NODE_TYPE noch ein FIRST_ORDERED_NODE_TYPE ist.

snapshotLength vom Typ unsigned long, readonly

{Ist} die Anzahl der Knoten im Ergebnis-Snapshot. Gültige Werte für snapshotItem zählen von 0 bis snapshotLength-1 inklusive.

Ausnahmen auf Wiederherstellung

XPathException

TYPE_ERR: wird gesetzt wenn resultType weder ein UNORDERED_NODE_SNAPSHOT_TYPE noch ein ORDERED_NODE_SNAPSHOT_TYPE ist.

stringValue vom Typ DOMString, readonly

Der Wert dieses {Attributs} ist vom Typ Zeichenkette.

Ausnahmen auf Wiederherstellung

XPathException

TYPE_ERR: wird gesetzt, wenn resultType kein STRING_TYPE ist.

Methoden

iterateNext

Iteriert und gibt den nächsten Knoten vom Knotenset zurück oder null, wenn es keine weiteren Knoten gibt.

Return Value

Node	Gibt den nächsten Knoten zurück.

Ausnahmen

XPathException	TYPE_ERR: wird gesetzt, wenn resultType weder ein UNORDERED_NODE_ITERATOR_TYPE noch ein ORDERED_NODE_ITERATOR_TYPE ist.
DOMException	INVALID_STATE_ERR: Das Dokument wurde verändert seitdem das Ergebnis zurückgegeben wurde.

Keine Parameter

snapshotItem

Gibt den indexten Eintrag {indexth item} der Snapshot-Kollektion zurück. Ist index größer oder gleich der Anzahl von Knoten in der Liste, gibt diese Methode null zurück. Abweichend vom Iteratorergebnis wird der Snapshot nicht zerstört, ist aber möglicherweise nicht mehr mit dem aktuellen Dokument verbunden, wenn dieses verändert wurde.

Parameter

index vom Typ unsigned long

Der Index {im Sinne von "Zählerwert"} der Snapshot-Kollektion.

Rückgabewert

Node	Der Knoten an der indexten Stelle in der {Knotenliste} NodeList, oder null, wenn der Index ungültig ist.

Ausnahmen

XPathException

TYPE_ERR: wird gesetzt, wenn resultType weder ein UNORDERED_NODE_SNAPSHOT_TYPE noch ein ORDERED_NODE_SNAPSHOT_TYPE ist.

Die XPathNamespace-Schnittstelle wird zurückgegeben von der XPathResult-Schnittstelle um den XPath-Namensraumknotentyp zu repräsentieren, dem DOM fehlt. Es gibt keinen öffentlichen {public} Konstruktor für diesen Knotentyp. Es wird versucht, {den Knotentyp} in die Hierarchie zu platzieren oder ein NamedNodeMap resultiert in einer DOMException mit dem Kodewert HIERARCHY_REQUEST_ERR. Dieser Knoten ist read only, so Methoden oder Einstellungen von Attributen die verändert wurden, der Knoten in eine DOMException mit dem Kodewert NO_MODIFICATION_ALLOWED_ERR resultiert.

Die Kernspezifikation {core specification} beschreibt Attribute der Node-Schnittstelle, das jedoch, unterschiedlich für verschiedene Knotentypen, beschreibt jedoch nicht XPATH_NAMESPACE_NODE, so dass es hier eine Beschreibung dieser Attribute für diesen Knotentyp gibt. Alle Attribute von Node, die nicht in diesem Abschnitt beschrieben sind, haben einen null- oder false-Wert.

ownerDocument stimmt überein mit dem ownerDocument von ownerElement auch wenn das Element später angebunden wurde.

nodeName ist immer die Zeichenkette "#namespace".

prefix ist der Präfix des Namensraums repräsentiert durch den Knoten.

localName ist dasselbe wie prefix.

nodeType ist gleich zu XPATH_NAMESPACE_NODE.

namespaceURI ist der Namensraum-URI des Namensraums repräsentiert durch den Knoten.

nodeValue ist dasselbe wie namespaceURI.

adoptNode, cloneNode, und importNode funktionieren nicht bei diesem Knoten wobei DOMException mit dem Kodewert NOT_SUPPORTED_ERR gesetzt wird.

Hinweis: In zukünftigen Versionen der XPath-Spezifikation kann die Definition eines Namensraumknotens inkompatibel verändert werden, in diesem Fall können inkompatible Veränderungen an den Feldwerten erforderlich werden um Versionen über XPath 1.0 hinaus zu implementieren.

IDL Definition

interface XPathNamespace : Node {

  // XPathNodeType
  const unsigned short      XPATH_NAMESPACE_NODE           = 13;

  readonly attribute Element         ownerElement;
};

Definitionsgruppe {definition group} XPathNodeType

Eine Ganzzahl steht für den Knotentyp.

Hinweis: Es gibt gegenwärtig nur einen Knotentyp der in XPath spezifisch ist. Die Anzahl in dieser Liste muss nicht mit den Werten kollidieren, die mit den Core-Knotentypen verbunden sind.

Vordefinierte Konstanten

XPATH_NAMESPACE_NODE

Der Knoten ist vom Typ Namespace.

Attribute

ownerElement vom Typ Element, readonly

{Das ist} das Element, an dem der Namensraum sichtbar war als es angefordert wurde. Dies bewirkt keine Veränderung an einem zurückgegebenen Namensraumknoten auch wenn das Dokument so verändert wird, dass der Namensraum aus dem Bereich dieses element-Knotens verschwindet und der Knoten nicht mehr von XPath gefunden wird.