XPath online testen, auch hinter Shadow Roots

Der Tester läuft vollständig in deinem Browser. Das eingefügte Markup wird in ein Dokument geparst, das nie in die Seite eingehängt wird, und der Ausdruck läuft durch die XPath-Engine des Browsers, dasselbe document.evaluate, bei dem auch ein Playwright- oder Selenium-Locator landet. Kein Server ist beteiligt; das Nutzungsjournal hält nur fest, dass das Tool geöffnet wurde.

XPath 1.0, nicht mehr

Browser können XPath 1.0. Du bekommst Achsen, Prädikate, contains(), normalize-space(), starts-with(), text() und Positionsfilter. Du bekommst kein matches(), kein ends-with() und nichts aus XPath 2.0 oder später. Ein Ausdruck aus einem XML-Werkzeug kann im Browser also scheitern, ohne falsch zu sein. Der Tester zeigt in dem Fall die Fehlermeldung der Engine.

Die Shadow-Grenze

Ein XPath-Ausdruck endet an einer Shadow-Grenze. Eine Web-Komponente, die ihren Button in einer Shadow Root rendert, ist für //button aus dem Dokument unsichtbar. Deshalb versagt ein Locator, der auf einer Seite läuft, auf einem Portal aus Komponenten. Mit deklarativem Shadow DOM, dem template-Element mit shadowrootmode, ist das inzwischen auch auf serverseitig gerenderten Seiten üblich, Behördenportale und Banken eingeschlossen.

Der Tester geht damit so um wie die Wahrnehmungsschicht von Browserberg: Der Ausdruck wird im Dokument ausgewertet und dann noch einmal in jeder Shadow Root. Ein Treffer in einer Root wird mit einem zusammengesetzten Pfad gemeldet, erst der Pfad zum Host-Element, dann der Pfad in dessen Baum. Das ist die Adresse, mit der ein Agent etwas anklickt, das ein einfacher XPath nicht erreicht.

Eindeutigkeit

Im Produkt ist ein XPath eine Sprosse auf einer fünfstufigen Leiter der Elementidentität. Wird ein gespeicherter Plan erneut ausgeführt, werden die Sprossen der Reihe nach probiert, die passende wird protokolliert, und ein Ausdruck, der auf mehr als ein Element passt, wird als mehrdeutig abgelehnt statt stillschweigend auf den ersten Treffer aufgelöst. Darum zeigt der Tester die Trefferzahl so prominent. Eins ist die Zahl, die du willst.

Was der Tester nicht beurteilt

Er sucht im eingefügten Markup, nicht auf einer lebenden Seite. Was ein Skript nach dem Laden ergänzt, fehlt, solange du nicht den gerenderten DOM einfügst. Er sagt nichts darüber, ob ein gefundenes Element sichtbar, aktiv oder tatsächlich klickbar ist; das ist Aufgabe der Agenten-Sicht, in der Klickbarkeit aus vier Signalen mit protokolliertem Grund besteht und Erreichbarkeit ein Treffertest ist, keine Rechteckgeometrie. Und er sagt nicht, ob der Ausdruck das nächste Deployment überlebt. Ein Pfad aus generierten Klassennamen passt heute und morgen nicht mehr. Text, Rollen und stabile Attribute halten länger.