Select Option

Select Option

Tipo: page-select  ·  Paquete: Browser v1.0.9

Elige una opción en una lista desplegable HTML (<select>). La opción se identifica por su valor (el atributo value de cada <option>), por su texto visible o por su posición, según by. Admite también selección múltiple.

Solo para <select> nativos

Esta actividad funciona con listas desplegables HTML estándar (<select>). Muchos sitios modernos usan desplegables “falsos” hechos con <div> y JavaScript: en esos casos, no uses Select Option, sino un Click para abrir el desplegable y otro Click sobre la opción.

Cómo funciona

Localiza el <select> por su selector, espera a que sea visible y esté habilitado, y elige la opción que coincida con value según by. Luego dispara los eventos input y change, como si la persona la hubiera elegido.

by dice cómo se interpreta value (desde la versión 1.0.8; antes solo se buscaba por el atributo value):

by	En el Designer	value es…	Para <option value="CO">Colombia</option>
value (predeterminado)	Valor	El atributo value de la opción, exacto.	"CO"
label	Texto visible	El texto que ve la persona, exacto.	"Colombia"
index	Posición	La posición de la opción, empezando en 0.	0 si es la primera

• by no distingue mayúsculas (Label sirve igual que label); vacío equivale a value.
• Si la lista es múltiple (<select multiple>), pasa una lista en value para elegir varias (todas se interpretan con el mismo by); las que no estén en la lista quedan sin elegir.
• Si ninguna opción coincide, la actividad sigue esperando a que aparezca (las listas que se llenan después de cargar la página) y falla al agotar timeout.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El elemento <select>.
value	string | List	—	La opción a elegir: su valor, su texto visible o su posición, según by. Para selección múltiple, una lista.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
page	ZoanPageSession	—	La sesión de página. Omítela dentro de un body; fuera, pasa la variable de la sesión (p. ej. page = page).
by	string	"value"	Cómo identifica value a la opción: value · label · index (ver tabla). Desde la versión 1.0.8.
timeout	number	30000	Máximo en ms a esperar. Vacío, 0 o negativo: el de la configuración del proyecto o, si no hay, 30000.

Salida

Esta actividad no devuelve ningún valor. Para leer la opción elegida, usa Get Value.

Ejemplo

Page Select   selector = (#pais)   value = "CO"                                  // <option value="CO">Colombia</option>
Page Select   selector = (#pais)   value = "Colombia"   by = label              // por el texto visible
Page Select   selector = (#cuota)  value = 2            by = index              // la tercera opción
Page Select   selector = (#moneda) value = cliente["moneda"]                    // valor que viene de un dato
Page Select   selector = (#temas)  value = new List<string> { "rpa", "ia" }     // selección múltiple
Page Get Value   selector = (#pais)   → output: paisElegido

Errores comunes

Mensaje	Causa y solución
'value' es obligatorio.	value está vacío.
Select falló: Timeout 30000ms exceeded. … | coincidencias: 1 (…)	El <select> existe, pero ninguna opción coincide (lo más común: pasaste el texto visible sin by = label, o al revés), o la lista está deshabilitada. Revisa las opciones y by.
Select falló: … | coincidencias: 0 (…)	No encontró el <select>. Revisa el selector.
Select falló: Error: Element is not a <select> element	El selector apunta a un desplegable hecho con <div>. Usa Click para abrirlo y elegir.
'…' no es una posición de opción válida: usa un número entero desde 0.	Con by = index, value no es un entero mayor o igual a 0.
'by' debe ser value, label o index (llegó '…').	by tiene otro valor. Elige uno de los tres.
'page' debe ser una ZoanPageSession.	page está vacío fuera de un body.

Actividades relacionadas

• Click — para desplegables no nativos (hechos con div/JS).
• Get Value — leer la opción seleccionada actualmente.