Intelligente Locator und DOM-Auswahl
Verstehe, wie ein Pin einem Element folgt, nachdem sich die Seite ändert, und warum Pinar eine manuelle Platzierung anfordern kann.
5 Min.In dieser Anleitung
Robuste Fingerprints
Ein Element-Pin kombiniert einen stabilen Selektor, DOM-Pfad, Tag, id, name, test id, role, Klassen, Text, Label und Geometrie. Beim erneuten Öffnen bewertet Pinar Selektor, Struktur, Semantik und Geometrie, statt einem einzelnen fragilen Pfad zu vertrauen.
Konfidenz und Mehrdeutigkeit
Ein Treffer kann exact, probable, ambiguous oder unresolved sein. Wenn zwei Kandidaten zu ähnlich sind, behält Pinar Alternativen, statt den Pin auf das falsche Element zu setzen. Cross-Origin-iframe-Ziele können unresolved bleiben.
Selektor-Fallback und konkurrierende Treffer
Zum Capture-Zeitpunkt bevorzugt Pinar einen Selektor, der den Knoten eindeutig über id, data-testid oder data-test oder über Tag plus name trifft. Ist keiner davon eindeutig, speichert Pinar stattdessen einen strukturellen CSS-Pfad. Klassennamen, die generiert wirken, werden aus dem Fingerprint entfernt, damit gehashte CSS-Modules nicht zum einzigen Signal werden.
Beim erneuten Öffnen werden Kandidaten der Strategien stable-selector, structure, semantic und geometry zusammengeführt und bewertet. Exact-Konfidenz erfordert einen hoch bewerteten stable-selector- oder structure-Treffer; semantic- und geometry-Treffer bleiben probable. Unterscheiden sich die beiden besten gültigen Scores um weniger als eine schmale Marge, ist das Ergebnis ambiguous und es wird kein Element gewählt.
- Ein positionaler :nth-of-type-Selektor wird niedriger bewertet, wenn andere Knoten denselben Tag, Text und dieselben Klassen teilen.
- Flächen-Pins werden als Elementziele abgelehnt und bleiben während der Locator-Bewertung unresolved.
- Wenn ein iframe-contentDocument unlesbar ist, stoppt die Relokation mit einer cross-origin-frame-Warnung, statt zu raten.