Get Value
Get Value
Sección titulada «Get Value»Tipo: page-get-value · Paquete: Browser v1.0.9 · Salida: string
Lee el valor de un campo de formulario —un <input>, <select> o <textarea>— y lo devuelve como texto. Úsala para verificar qué hay escrito en un campo, leer un valor precargado, o confirmar lo que el bot acaba de escribir.
Cómo funciona
Sección titulada «Cómo funciona»Localiza el campo por su selector, espera a que exista (hasta timeout) y devuelve su propiedad value (lo que el campo contiene ahora), que no siempre es lo mismo que su texto visible.
- En un
<select>, devuelve elvaluede la opción elegida (no su texto visible). En un<select multiple>, el de la primera elegida. - El valor no se escribe en el log: el log solo dice de qué campo se leyó.
Parámetros requeridos
Sección titulada «Parámetros requeridos»| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
selector | selector | — | El campo input/select/textarea a leer. |
Parámetros opcionales
Sección titulada «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). |
timeout | number | 30000 | Máximo en ms a esperar el elemento. Vacío, 0 o negativo: el de la configuración del proyecto o, si no hay, 30000. |
Devuelve un string con el valor del campo; "" si el campo está vacío.
Ejemplo
Sección titulada «Ejemplo»Page Fill selector = (#cantidad) value = "10"Page Get Value selector = (#cantidad) → output: cantidadActualIf condition = cantidadActual != "10" └─ then: Throw message = "El campo no aceptó el valor esperado"Errores comunes
Sección titulada «Errores comunes»| Mensaje | Causa y solución |
|---|---|
Error: Node is not an <input>, <textarea> or <select> element | El selector apunta a otro elemento (una etiqueta, un contenedor). Captura el campo, o usa Get Text si quieres el texto visible. |
Timeout 30000ms exceeded | El campo no apareció a tiempo. Revisa el selector o espera antes con Wait For. |
'page' debe ser una ZoanPageSession. | page está vacío fuera de un body. |
Actividades relacionadas
Sección titulada «Actividades relacionadas»- Get Text — texto visible de elementos que no son campos.
- Fill Field — escribir un valor en el campo.