XPath-Tester

Funktionsweise des XPath-Testers

Der XPath-Tester ist ein Werkzeug zur Überprüfung von XPath-Ausdrücken auf XML- oder HTML-Inhalten. Nach der Eingabe des Dokuments und des gewünschten Pfads ermittelt das Tool alle passenden Elemente und stellt diese strukturiert dar.

Für jeden übereinstimmenden Node liefert die Ausgabe detaillierte Metadaten:

• Typ: Die Art des gefundenen Knotens.
• Name: Der Bezeichner des Elements oder Attributs.
• Pfad: Der genaue Pfad zum gefundenen Element.
• Vorschau: Ein Auszug des Werts, der direkt über die Schaltfläche „Ergebnis kopieren“ in die Zwischenablage übernommen werden kann.

Zusätzlich zeigt die Oberfläche statistische Werte wie „Zeichen“ für die Länge des Eingabedokuments und „Ergebnisse“ für die Anzahl der gefundenen Treffer an.

Unterschiede zwischen XML- und HTML-Modus

Bei der Auswertung von XPath-Ausdrücken ist die Wahl des passenden Eingabetyps entscheidend, da XML und HTML unterschiedlichen strukturellen Regeln folgen. Das Tool bietet hierfür die Optionen „XML“ und „HTML“.

+----------------------------------+----------------------------------+
| XML-Modus                        | HTML-Modus                       |
+----------------------------------+----------------------------------+
| Strikte Einhaltung der XML-      | Fehlertolerante Analyse          |
| Spezifikation und Namespaces     |                                  |
+----------------------------------+----------------------------------+
| Erfordert wohlgeformte Dokumente | Erlaubt einfache Pfade wie `//a` |
| ohne Syntaxfehler                | auf Standard-Tags                |
+----------------------------------+----------------------------------+

Im XML-Modus müssen alle Elemente korrekt geschlossen und Namespaces exakt deklariert sein. Der HTML-Modus hingegen verzeiht unvollständige Strukturen und erleichtert das schnelle Auffinden von Elementen in Web-Dokumenten.

Umgang mit XML-Namespaces

Namespaces verhindern Namenskonflikte in XML-Dokumenten, erschweren jedoch oft die manuelle Abfrage. Dieser Tester unterstützt die Auswertung von Namespaces direkt über den XPath-Ausdruck.

Wenn im XML-Dokument Namespace-Präfixe deklariert sind, können diese im XPath-Feld verwendet werden, beispielsweise in der Form //x:item. Falls das Dokument einen Standard-Namespace ohne explizites Präfix definiert, folgt die Abfrage //item automatisch der im Dokument hinterlegten Deklaration. Dies vereinfacht die Erstellung von Abfragen, da keine komplexen lokalen Namensprüfungen wie //*[local-name()='item'] formuliert werden müssen.

Strategien gegen Timeouts und Performance-Grenzen

Um die Reaktionsfähigkeit der Webseite unter allen Umständen zu gewährleisten, gelten für die Verarbeitung feste Grenzwerte:

• Zeitlimit: Die Auswertung eines XPath-Ausdrucks wird nach genau 2 Sekunden abgebrochen.
• Dokumentengröße: Das Eingabefeld für XML/HTML fasst maximal 500.000 Zeichen.
• Ausdruckslänge: Der XPath-Ausdruck darf eine Länge von 4.000 Zeichen nicht überschreiten.

Wenn eine Abfrage das Zeitlimit überschreitet, gibt das Tool die Meldung „Die Ausführung dieses XPaths hat zu lange gedauert. Bitte grenzen Sie den Ausdruck ein oder nutzen Sie ein kleineres Beispiel.“ aus.

Zur Vermeidung von Timeouts sollten Ausdrücke so spezifisch wie möglich formuliert werden. Vermeiden Sie nach Möglichkeit extrem breit gefächerte Suchmuster wie //* auf tief verschachtelten, großen Dokumenten. Nutzen Sie stattdessen direkte Pfadangaben, um den Suchbaum für die Engine einzugrenzen.

Fehlerbehebung und Systemmeldungen

Beim Testen von Dokumenten und Pfaden fängt das Tool typische Fehlerquellen ab und gibt präzise Rückmeldungen aus:

• Dokument zu groß: Überschreitet der Text die Kapazität, erscheint „Dieses Dokument ist zu groß für den Online-Test. Bitte versuchen Sie es mit einem kleineren Ausschnitt.“.
• Ungültiger XPath: Syntaxfehler im Pfad erzeugen die Meldung „Dieser XPath-Ausdruck ist ungültig.“.
• Zu langer XPath: Bei Überschreitung der Zeichengrenze im Suchfeld erscheint „Dieser XPath-Ausdruck ist zu lang für diesen Test.“.
• Parser-Fehler: Ist das XML- oder HTML-Dokument fehlerhaft aufgebaut, meldet das System „Dieses Dokument konnte nicht analysiert werden.“.
• Auswertungsfehler: Kann der Pfad strukturell nicht verarbeitet werden, zeigt das Tool „Dieser XPath konnte nicht ausgewertet werden.“ an.
• Keine Treffer: Findet die Engine keine Übereinstimmung, erscheint „Keine Ergebnisse.“.
• Ergebnisbegrenzung: Um den Browser nicht zu überlasten, werden maximal 200 Treffer gleichzeitig gerendert. Bei Überschreitung dieser Grenze erscheint der Hinweis „Die ersten {max} Ergebnisse werden angezeigt.“.

Datenschutz und lokale Verarbeitung

Die Verarbeitung der eingegebenen Daten erfolgt vollständig lokal im Webbrowser des Nutzers. Weder die XML- oder HTML-Dokumente noch die eingegebenen XPath-Ausdrücke werden an externe Server übertragen oder auf den Systemen von BroBroGo gespeichert.

Da keine Netzwerkübertragung der Daten stattfindet, eignet sich das Tool für die Analyse von Dokumenten direkt im Browser. Es ist jedoch zu beachten, dass das Tool keine Live-Verbindungen zu externen Webseiten herstellt. Es bildet weder die Echtzeit-Struktur noch das gerenderte DOM oder die Netzwerkanfragen von im Internet aufgerufenen Seiten ab. Es verarbeitet ausschließlich den statischen Text, der direkt in das Eingabefeld kopiert wurde.

Häufig gestellte Fragen (FAQ)

Kann ich XPath sowohl auf HTML als auch auf XML anwenden?
Ja. Der XML-Modus beachtet die strengen XML-Namespace-Regeln. Der HTML-Modus ist toleranter und erlaubt es, einfache Pfade wie //a auf normale Tags anzuwenden.

Wie funktionieren XML-Namespaces?
In Ihrem XML deklarierte Namespace-Präfixe können direkt im XPath verwendet werden (z. B. //x:item). Bei Standard-Namespaces folgt auch //item der Deklaration im Dokument.

Warum kann eine Abfrage ein Timeout verursachen?
Sehr große Dokumente oder sehr breit gefächerte Ausdrücke können viel Rechenleistung erfordern. Das Tool bricht die Auswertung nach 2 Sekunden ab, damit die Seite reaktionsfähig bleibt. Grenzen Sie den Pfad ein oder nutzen Sie ein kleineres XML-Beispiel.

Gibt es eine Begrenzung für die Anzahl der angezeigten Treffer?
Ja, das Tool begrenzt die Anzeige aus Performancegründen auf die ersten 200 Treffer und gibt in diesem Fall die Meldung „Die ersten {max} Ergebnisse werden angezeigt.“ aus.