Pinar
InícioPlanosNovidadesAjuda
Entrar
⌘ K

Comece aquiCapturas e pinsAgentes de IAProjetos e coleçõesNuvem e planosPrivacidade e dados
Comece aqui
Capturas e pins
Capturas de elemento, área, página inteira e iframePins, comentários e coresCapturar uma página inteiraLocalizadores inteligentes e seleção DOMMascarar áreas sensíveisCopiar, visualizar e reabrir uma captura
Agentes de IA
Projetos e coleções
Nuvem e planos
Privacidade e dados
Ajuda/Capturas e pins

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 min
Exemplo visual: A seleção inteligente contorna o elemento sob o cursor para você percorrer o DOM com as setas antes de pinar.

Neste guia

  1. 1Impressões resilientes
  2. 2Confiança e ambiguidade
  3. 3Fallback de seletor e correspondências concorrentes
1

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.

2

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.

3

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.
Ainda precisa de contexto?Ver todos da categoria

Neste artigo

Impressões resilientesConfiança e ambiguidadeFallback de seletor e correspondências concorrentes
Apoie o desenvolvimento Fair Source

Prefere apoiar diretamente o desenvolvimento com código público? Patrocine no GitHub ou pague um café.

Pague um caféApoiar no GitHub
Pinar·© 2026·Pinar v0.3.6
Termos de ServiçoPolítica de Privacidade