Qué son los Localizadores en Selenium

Este artículo explica de forma sencilla y directa qué son los localizadores en Selenium WebDriver y por qué son la base de cualquier prueba automatizada.

Deberías aprender, a cómo identificar elementos web como botones, cuadros de texto o enlaces y los 8 tipos clásicos de localizadores: ID, Name, Class Name, Tag Name, Link Text y Partial Link Text, CSS Selector y XPath.

También conocerás que es un localizador relativo de Selenium 4, los que permiten encontrar elementos según su posición respecto a otros y verás ejemplos prácticos en Java para cada caso.

Por último, tienes un breve resumen de buenas prácticas para elegir los localizadores más confiables y evitar algunos errores habitualmente comunes.

Qué es un localizador

En Selenium WebDriver, los localizadores son estrategias o comandos que indican a Selenium qué elemento web (como un cuadro de texto, enlace o botón) debe interactuar.

Son la base de cualquier prueba automatizada: sin identificar correctamente los elementos, tu script NO podrá realizar ninguna acción.

Los localizadores permiten a Selenium encontrar e interactuar con los elementos en el Modelo de Objetos del Documento (DOM) de una página web, como ingresar texto, hacer clic en botones, seleccionar opciones de listas desplegables o verificar valores.

Por qué son importantes los localizadores

Permiten identificar elementos específicos en una página web y habilitan a Selenium para realizar operaciones como click, sendKeys, getText, entre otras.

La precisión de tu localizador define la fiabilidad de tu prueba: ¡localizador incorrecto, elemento incorrecto!

7 Localizadores clásicos de Selenium WebDriver

Esto son los 7 localizadores más usados con Selenium WebDriver: id, name, class name, tag name, link text y partial link text, selector css y xPath.

Ejemplos de cada tipo de localizador

1. Por ID

Cada elemento HTML puede tener un identificador único ID, por eso este es uno de los métodos más rápidos y confiables.

driver.findElement(By.id("email")).sendKeys("test@example.com");

2. Por Name

Se usa cuando los elementos tienen un atributo name definido, como en formularios. Localiza un elemento cuando utiliza un atributo NAME.

driver.findElement(By.name("userName")).sendKeys("Tutorial");

3. Por Class Name

Encuentra un elemento usando el valor del atributo class. Es útil si varios elementos comparten una misma clase CSS.

driver.findElement(By.className("inputtext")).click();

4. Por Tag Name

Busca elementos por su etiqueta HTML, como IMPUT, BUTTON, DIV, etc.

driver.findElement(By.tagName("button")).click();

5. Por Link Text / Partial Link Text

Solo funciona con enlaces de la etiqueta A. Busca el enlace por el texto visible que muestra.

driver.findElement(By.linkText("REGISTER")).click();

También se usa con enlaces, pero no requiere el texto completo: basta con una parte de él.

driver.findElement(By.partialLinkText("REG")).click();

6. Por CSS Selector

Permite localizar elementos con reglas CSS, combinando etiquetas, clases, ids o atributos.

driver.findElement(By.cssSelector("input#email"));
driver.findElement(By.cssSelector("input.inputtext[name='pass']"));

7. Por XPath

Usa rutas XPath para navegar por la estructura del HTML (DOM). Puede localizar elementos de manera muy específica, incluso con condiciones complejas.

driver.findElement(By.xpath("//input[@type='text' and @name='userName']"));

Localizadores Avanzados: Localizadores Relativos (Selenium 4)

Una de las adiciones más prácticas en Selenium 4 son los localizadores relativos, que permiten localizar elementos basándose en su posición visual relativa a otros elementos.

// Encontrar el campo de contraseña debajo del campo de nombre de usuario
WebElement passwordField = driver.findElement(
    RelativeLocator.with(By.tagName("input"))
        .below(usernameField)
);

// Encontrar el botón cancelar a la izquierda del botón enviar
WebElement cancelButton = driver.findElement(
    RelativeLocator.with(By.tagName("button"))
        .toLeftOf(submitButton)
);

// Encontrar etiqueta encima de un input (útil para validación de formularios)
WebElement label = driver.findElement(
    RelativeLocator.with(By.tagName("label"))
        .above(inputField)
        .near(inputField, 50) // dentro de 50 píxeles
);

Buenas prácticas a la hora de elegir localizadores

✅ Orden preferible: ID → Name → CSS → XPath (siguiendo este orden de fiabilidad).
✅ Usar atributos únicos y estables (evitar clases dinámicas).
✅ Evitar localizadores frágiles que se rompen con cambios en la UI.
✅ Validar localizadores usando las herramientas de desarrollo del navegador antes de escribir el script.

Conclusión

Un localizador es, la forma en que Selenium encuentra elementos en la aplicación web y debes saber, que existen 7 tipos principales de localizadores, cada uno diseñado para un escenario diferente.

Los más confiables son el ID o el Name y los más poderosos, selector CSS y XPath.

CONSEJO FINAL: Dedica tu tiempo a practicar con las Herramientas de Desarrollo (F12) de tu navegador. ¡El dominar los localizadores es la vía más rápida de escribir scripts de automatización estables!