Key Press

Tipo: page-key-press · Paquete: Browser v1.0.9

Envía una tecla o una combinación a la página, como Enter, Tab, Escape, F5 o atajos como Control+a. Útil para confirmar formularios con Enter, moverte entre campos con Tab, cerrar diálogos con Escape o disparar atajos de teclado de la aplicación.

Cómo funciona

Si indicas un selector, primero espera a que el elemento exista (hasta timeout), lo enfoca y luego envía la(s) tecla(s). Si lo omites, la tecla se envía a la página (al elemento que tenga el foco), de inmediato. Las teclas usan los nombres de Playwright (ver tabla), y las combinaciones se unen con +: se mantienen pulsados los modificadores y se pulsa la última tecla.

Antes de enviarlas, la actividad normaliza los nombres sin distinguir mayúsculas, así que puedes escribir los atajos de forma natural:

Escribes	Se envía
`ctrl`, `control`	`Control`
`alt` · `shift`	`Alt` · `Shift`
`win`, `meta`	`Meta`
`enter`, `return`	`Enter`
`esc`, `escape`	`Escape`
`del`, `delete` · `ins`, `insert`	`Delete` · `Insert`
`pgup`, `pageup` · `pgdn`, `pagedown`	`PageUp` · `PageDown`
`left`, `right`, `up`, `down`	`ArrowLeft`, `ArrowRight`, `ArrowUp`, `ArrowDown`
`tab`, `space`, `backspace`, `home`, `end`, `f1`…`f12`	`Tab`, `Space`, `Backspace`, `Home`, `End`, `F1`…`F12`
Una sola letra (`A`)	En minúscula (`a`)

Cualquier otro nombre se envía tal cual. Para escribir texto usa Type Text o Fill Field: esta actividad es para teclas sueltas y atajos.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`keys`	`string`	—	Tecla o combinación. Ej: `Tab`, `Enter`, `Escape`, `F5`, `Control+a`, `Shift+Tab`, `Control+Shift+i`.

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`).
`selector`	`selector`	—	Elemento a enfocar antes de enviar la tecla. Si se omite, va a la página.
`timeout`	`number`	`30000`	Máximo en ms a esperar el elemento (solo con `selector`). Vacío, `0` o negativo: el de la configuración del proyecto o, si no hay, `30000`.

Nombres de teclas comunes

Tecla	`keys`
Enter / Intro	`Enter`
Tabulador	`Tab`
Escape	`Escape`
Flechas	`ArrowDown`, `ArrowUp`, `ArrowLeft`, `ArrowRight`
Funciones	`F1` … `F12`
Seleccionar todo	`Control+a`
Tab inverso	`Shift+Tab`

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

Buscar y confirmar con Enter:

Page Fill   selector = (#buscar)   value = "factura 2026"
Page Key Press   selector = (#buscar)   keys = "Enter"
Page Wait For   selector = (.resultados)   state = visible

Errores comunes

Mensaje	Causa y solución
`'keys' es obligatorio.`	`keys` está vacío.
`Unknown key: "…"`	El nombre de la tecla no existe. Usa los nombres de las tablas de esta página o revisa la ortografía.
`Timeout 30000ms exceeded`	Con `selector`, el elemento 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

Type Text — escribir texto (no teclas especiales).
Click — alternativa para confirmar pulsando un botón.