Localisateurs intelligents et sélection DOM

Un pin d’élément combine un sélecteur stable, un chemin DOM, une balise, un id, un name, un test id, un role, des classes, du texte, un label et la géométrie. À la réouverture, Pinar évalue le sélecteur, la structure, la sémantique et la géométrie, plutôt que de se fier à un chemin fragile unique.

Une correspondance peut être exacte, probable, ambiguë ou non résolue. Lorsque deux candidats sont trop similaires, Pinar conserve des alternatives au lieu d’accrocher le pin au mauvais élément. Les cibles d’iframe cross-origin peuvent rester non résolues.

Au moment de la capture, Pinar préfère un sélecteur qui correspond de façon unique au nœud par id, data-testid ou data-test, ou tag plus name. Si aucun n’est unique, il stocke à la place un chemin CSS structurel. Les noms de classe qui semblent générés sont retirés de l’empreinte afin que les modules CSS hachés ne deviennent pas le seul signal.

À la réouverture, les candidats des stratégies stable-selector, structure, semantic et geometry sont fusionnés et classés. Une confiance exacte exige un sélecteur stable ou un hit de structure à score élevé ; les correspondances sémantiques et géométriques restent probables. Lorsque les deux meilleurs scores viables diffèrent de moins d’une marge étroite, le résultat est ambigu et aucun élément n’est choisi.

• Un sélecteur positionnel :nth-of-type est moins bien noté lorsque d’autres nœuds partagent la même balise, le même texte et les mêmes classes.
• Les pins de zone sont rejetés comme cibles d’élément et restent non résolus pendant le scoring du localisateur.
• Lorsqu’un iframe contentDocument est illisible, la relocalisation s’arrête avec un avertissement cross-origin-frame au lieu de deviner.