Localizadores inteligentes e seleção DOM
Entenda como um pin acompanha um elemento depois que a página muda e por que o Pinar pode pedir posicionamento manual.
5 minNeste guia
Impressões resilientes
Um pin de elemento combina seletor estável, caminho DOM, tag, id, name, test id, role, classes, texto, label e geometria. Ao reabrir, o Pinar avalia seletor, estrutura, semântica e geometria em vez de confiar em um único caminho frágil.
Confiança e ambiguidade
Uma correspondência pode ser exata, provável, ambígua ou não resolvida. Quando dois candidatos são parecidos demais, o Pinar mantém alternativas em vez de encaixar o pin no elemento errado. Alvos em iframe de outra origem podem ficar não resolvidos.
Fallback de seletor e correspondências concorrentes
Na captura, o Pinar prefere um seletor que case o nó de forma única por id, data-testid ou data-test, ou tag mais name. Se nenhum for único, guarda um caminho CSS estrutural. Classes que parecem geradas saem da impressão para módulos CSS com hash não virarem o único sinal.
Na reabertura, candidatos das estratégias de seletor estável, estrutura, semântica e geometria são unidos e ranqueados. Confiança exata exige um acerto alto de seletor estável ou estrutura; semântica e geometria permanecem prováveis. Quando as duas melhores pontuações viáveis diferem por uma margem estreita, o resultado fica ambíguo e nenhum elemento é escolhido.
- Um seletor posicional :nth-of-type perde pontos quando outros nós compartilham a mesma tag, texto e classes.
- Pins de área são rejeitados como alvos de elemento e permanecem não resolvidos na pontuação do localizador.
- Quando o documento interno de um iframe não é legível, a realocação para com um aviso de frame de outra origem em vez de adivinhar.