Pinar
InicioPlanesNovedadesAyuda
Entrar
⌘ K

Primeros pasosCapturas y pinsAgentes de IAProyectos y coleccionesNube y planesPrivacidad y datos
Primeros pasos
Capturas y pins
Capturas de elemento, área, página completa e iframePins, comentarios y coloresCapturar una página completaLocalizadores inteligentes y selección del DOMEnmascarar áreas sensiblesCopiar, ver y reabrir una captura
Agentes de IA
Proyectos y colecciones
Nube y planes
Privacidad y datos
Ayuda/Capturas y pins

Localizadores inteligentes y selección del DOM

Entiende cómo un pin sigue a un elemento después de que la página cambia y por qué Pinar puede pedir una colocación manual.

5 min
Ejemplo visual: La selección inteligente recuadra el elemento bajo el cursor para recorrer el DOM con las flechas antes de fijar el pin.

En esta guía

  1. 1Huellas resistentes
  2. 2Confianza y ambigüedad
  3. 3Reserva de selector y coincidencias en competencia
1

Huellas resistentes

Un pin de elemento combina un selector estable, camino DOM, tag, id, name, test id, role, clases, texto, etiqueta y geometría. Al reabrir, Pinar evalúa selector, estructura, semántica y geometría en lugar de confiar en un camino frágil.

2

Confianza y ambigüedad

Una coincidencia puede ser exact, probable, ambiguous o unresolved. Cuando dos candidatos son demasiado similares, Pinar conserva alternativas en lugar de encajar el pin en el elemento equivocado. Los destinos de iframe de origen cruzado pueden permanecer unresolved.

3

Reserva de selector y coincidencias en competencia

En el momento de la captura, Pinar prefiere un selector que coincida de forma única con el nodo por id, data-testid o data-test, o tag más name. Si ninguno de esos es único, guarda un camino CSS estructural. Los nombres de clase que parecen generados se omiten de la huella para que los módulos CSS con hash no se conviertan en la única señal.

Al reabrir, se fusionan y ordenan los candidatos de las estrategias stable-selector, structure, semantic y geometry. La confianza exact exige un acierto de selector estable o de estructura con puntuación alta; las coincidencias semánticas y geométricas se quedan en probable. Cuando las dos puntuaciones viables más altas difieren en un margen estrecho, el resultado es ambiguous y no se elige ningún elemento.

  • Un selector posicional :nth-of-type puntúa más bajo cuando otros nodos comparten el mismo tag, texto y clases.
  • Los pins de área se rechazan como destinos de elemento y permanecen unresolved durante la puntuación del localizador.
  • Cuando el contentDocument de un iframe no se puede leer, la reubicación se detiene con un aviso cross-origin-frame en lugar de adivinar.
¿Aún necesitas contexto?Ver todo de la categoría

En esta página

Huellas resistentesConfianza y ambigüedadReserva de selector y coincidencias en competencia
Apoya el desarrollo Fair Source

¿Prefieres apoyar directamente el desarrollo con código público? Patrocina en GitHub o invita un café.

Invítame un caféPatrocinar en GitHub
Pinar·© 2026·Pinar v0.3.6
Terms of ServicePrivacy Policy