HOWTO · Python
Cómo encontrar un elemento por texto usando Selenium en Python
Este tutorial demuestra cómo encontrar elementos por texto usando Selenium en Python. Aprenda varios métodos, incluidas las técnicas de XPath, selectores CSS y texto de enlace, para mejorar sus habilidades de automatización web. Perfecta tanto para principiantes como para desarrolladores experimentados, esta guía ofrece ejemplos prácticos y explicaciones claras que le ayudarán a navegar por páginas web complejas de manera eficiente.
En esta página
El localizador By.XPATH de Selenium es la opción general para encontrar un elemento de la página por su texto visible. Use los localizadores de texto de enlace para los anclajes; los selectores CSS no coinciden con texto por sí solos, así que combine una selección CSS con una comprobación de texto cuando sea necesario. Los fragmentos de localizadores siguientes usan las API de Selenium 4. Los ejemplos de navegador requieren Selenium y un controlador de navegador configurado; el ejemplo independiente de Python demuestra la coincidencia exacta de texto sin esas dependencias externas.
Método 1: Usar XPath para encontrar un elemento por texto
Use //*[text()='About Us'] cuando el objetivo sea un nodo de texto directo. Para texto que pueda contener espacios adicionales o elementos anidados, //*[normalize-space(.)='About Us'] compara el texto combinado de los descendientes del elemento después de recortar y contraer los espacios. Restrinja la etiqueta o los atributos cuando varios elementos puedan contener el mismo texto.
Ejecute este ejemplo independiente de coincidencia de texto:
from html.parser import HTMLParser
class LinkTextParser(HTMLParser):
def __init__(self):
super().__init__()
self.in_link = False
self.links = []
def handle_starttag(self, tag, attrs):
if tag == "a":
self.in_link = True
self.links.append("")
def handle_endtag(self, tag):
if tag == "a":
self.in_link = False
def handle_data(self, data):
if self.in_link:
self.links[-1] += data
html = '<a href="#about">About Us</a><a href="#help">Help</a>'
parser = LinkTextParser()
parser.feed(html)
matches = [link.strip() for link in parser.links if link.strip() == "About Us"]
print(matches[0])
About Us
Este ejemplo muestra la comparación de texto sobre una cadena HTML fija; no controla un navegador. En Selenium, espere el objetivo cuando la página lo renderice de forma asíncrona, por ejemplo con WebDriverWait(driver, 10).until(EC.visibility_of_element_located((By.XPATH, "//*[normalize-space(.)='About Us']"))). Cierre el controlador en un bloque finally para que la limpieza también se realice si una búsqueda falla.
Método 2: Usar selectores CSS para encontrar un elemento por texto
CSS no tiene un selector estándar de texto visible. Primero seleccione un conjunto pequeño y relevante de candidatos y luego compare su texto en el navegador. Por ejemplo, seleccione botones con document.querySelectorAll('button.action') y encuentre aquel cuyo textContent.trim() sea igual a la etiqueta solicitada. Una consulta amplia puede coincidir tanto con un contenedor como con su hijo, y textContent incluye el texto oculto de los descendientes, así que use un selector específico y verifique la visibilidad cuando esas distinciones importen. Selenium puede ejecutar esta comprobación con driver.execute_script(...); espere el contenedor relevante antes de consultar contenido dinámico.
Método 3: Usar texto de enlace y texto de enlace parcial
Para los elementos de anclaje, Selenium proporciona By.LINK_TEXT y By.PARTIAL_LINK_TEXT. Por ejemplo, driver.find_element(By.LINK_TEXT, "Python documentation") encuentra una etiqueta de enlace exacta, mientras que driver.find_element(By.PARTIAL_LINK_TEXT, "Python guide") encuentra un enlace que contiene esa frase. Estos localizadores no se aplican a botones, encabezados ni otros tipos de elementos. Use una espera explícita si el enlace se agrega después de la carga inicial de la página y prefiera el texto exacto cuando los enlaces tengan etiquetas similares.
Conclusión
Elija XPath para la coincidencia general de texto, especialmente cuando importen los espacios o las relaciones entre elementos. CSS puede reducir los candidatos, pero se requiere una comparación de texto separada. Los localizadores de texto de enlace son concisos para los anclajes. Si una búsqueda no encuentra el elemento esperado, confirme su texto y tipo, compruebe si coinciden varios elementos y espere el contenido renderizado en el cliente en lugar de depender de un retraso fijo.
Preguntas frecuentes
-
¿Cómo instalo Selenium para Python? Instale el paquete de Selenium con
python -m pip install selenium. Python incluye su módulotime; no es un paquete que se deba instalar. El control del navegador también necesita un navegador compatible y la configuración de su controlador. -
¿Qué navegadores puede controlar Selenium? Selenium puede controlar navegadores comunes como Chrome, Firefox, Safari y Edge mediante sus controladores de navegador. La disponibilidad depende de su sistema operativo y del navegador instalado.
-
¿Puede Selenium ejecutarse en modo headless? Sí. Establezca la opción headless del navegador en las opciones de su controlador antes de crear el controlador. El modo headless también necesita la configuración del navegador y del controlador.
-
¿Cuándo debería usar XPath o CSS? XPath puede coincidir con texto y navegar por las relaciones en el DOM. CSS selecciona por elemento, clase y atributos, pero no tiene coincidencia de texto estándar; agregue una comprobación de texto separada si es necesario.
-
¿Puede Selenium probar aplicaciones de una sola página? Sí. Espere el elemento o estado esperado después de que la aplicación se actualice. Una navegación correcta no garantiza que el contenido renderizado en el cliente esté listo.