Fill Field

Fill Field

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

Limpia un campo de entrada (input o textarea) y escribe el valor indicado de una sola vez. Es la forma rápida y recomendada de llenar formularios: asigna el valor directamente, sin simular pulsaciones de teclas.

Cómo funciona

Localiza el campo por su selector, espera a que sea visible, esté habilitado y sea editable, borra lo que tuviera y coloca el nuevo valor. Dispara el evento input del campo, pero no eventos de teclado individuales (es casi instantáneo). Si una página necesita reaccionar a cada tecla (autocompletados, máscaras que validan al teclear), usa Type Text en su lugar.

• Sirve con <input>, <textarea> y elementos editables (contenteditable). Para listas <select> usa Select Option; para casillas, Check / Uncheck.
• Un value vacío deja el campo vacío: útil para borrarlo.
• Acepta una credencial en value: escribe su valor sin que aparezca en el playbook ni en el log (el log solo dice qué campo se llenó).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El campo de entrada a llenar.
value	string | credential	—	El texto a escribir. Admite expresiones (ej. cliente["nombre"]) y credenciales.

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.

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

Page Fill   selector = (#usuario)   value = credential("portal")["user"]
Page Fill   selector = (#clave)     value = credential("portal")["password"]
Page Fill   selector = (#buscar)    value = "factura 2026"
Page Click  selector = (#btnBuscar)

Fill vs Type

• Fill Field: rápido, asigna el valor de golpe. Tu opción por defecto para formularios.
• Type Text: lento, tecla por tecla. Úsalo solo cuando la página depende de los eventos de cada pulsación.

Credenciales sin exponer

Para usuarios y contraseñas, usa credential("nombre")["campo"] en value: el valor real nunca queda en el playbook ni en los logs. Ver Uso de credenciales.

Errores comunes

Mensaje	Causa y solución
Fill falló: Timeout 30000ms exceeded. … | coincidencias: 0 (…)	No encontró el campo. Revisa el selector o espera antes con Wait For.
Fill falló: … | coincidencias: 1 (el elemento existe pero la acción no se completó: …)	El campo está oculto, deshabilitado o es de solo lectura. Espera a que se habilite.
Fill falló: Error: Element is not an <input>, <textarea> …	El selector apunta a un contenedor o a la etiqueta, no al campo. Captura el input.
'page' debe ser una ZoanPageSession.	page está vacío fuera de un body.

Actividades relacionadas

• Type Text — escribir tecla por tecla.
• Get Value — leer el valor actual de un campo.
• Select Option — elegir en una lista desplegable.