Type Text

Type Text

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

Escribe texto carácter por carácter, simulando pulsaciones reales de teclado. Es más lenta que Fill Field, pero genera un evento por cada tecla — necesario cuando la página reacciona al teclear: autocompletados que muestran sugerencias, campos con máscara, buscadores que filtran en vivo.

Cómo funciona

Espera a que el campo indicado por el selector exista en la página, lo enfoca y teclea el texto letra a letra, con una pausa (delay) entre teclas. A diferencia de Fill Field, no borra primero el contenido: escribe a partir de donde esté el cursor. Si necesitas el campo vacío, usa antes Fill Field con value = "".

• Duración aproximada: número de caracteres × delay (con el valor por defecto, 20 caracteres tardan 1 s).
• Acepta una credencial en text: la teclea sin que aparezca en el playbook ni en el log.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El campo donde teclear.
text	string | credential	—	El texto a teclear. Admite expresiones 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).
delay	number	50	Pausa entre teclas en ms. Más alto = más “humano” y fiable en páginas sensibles; 0 teclea sin pausa.
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

Escribir en un buscador con autocompletado y luego elegir la sugerencia:

Page Type    selector = (#busquedaCiudad)   text = "Bogotá"   delay = 80
Page Wait For   selector = (.sugerencia)    state = visible
Page Click   selector = (.sugerencia)

¿Cuál usar?

Empieza con Fill Field (rápido). Cambia a Type Text solo si el campo no reacciona como esperas — señal de que la página necesita los eventos de cada tecla.

Errores comunes

Mensaje	Causa y solución
Type falló: Timeout 30000ms exceeded. … | coincidencias: 0 (…)	No encontró el campo. Revisa el selector o espera antes con Wait For.
Type falló: … | coincidencias: 2 (el selector es ambiguo: …)	El selector coincide con varios elementos. Hazlo más específico o agrega un índice.
'page' debe ser una ZoanPageSession.	page está vacío fuera de un body.

Actividades relacionadas

• Fill Field — escribir rápido, de una sola vez.
• Key Press — enviar teclas especiales (Enter, Tab, atajos).