Acciones

Written By Matias Carcamo

Last updated 15 days ago

Este documento describe todas las acciones disponibles en el Monitoreo sintético dVirtualUser.

Acciones Disponibles

1. open_url

Descripción: Abre una URL en el navegador y espera a que la página cargue completamente.

Parámetros:

  • target (requerido): URL a abrir

  • param (opcional): Estado esperado de la página ("complete", "none"). Por defecto es "complete"

  • wait_presence (opcional): Tiempo de espera en segundos para que la página cargue

2. ios_accept_alert

Descripción: Acepta una alerta en dispositivos iOS.

Parámetros:

  • No requiere parámetros adicionales

3. click

Descripción: Hace clic en un elemento web especificado.

Parámetros:

  • target (requerido): Selector del elemento a hacer clic

  • wait_presence (opcional): Tiempo de espera en segundos

  • flags (opcional): Flags especiales como "ignore_scroll_to", "android_timeout_popup_check"

  • offset_x (opcional): Desplazamiento horizontal para el clic

  • offset_y (opcional): Desplazamiento vertical para el clic

4. go_to_prev_page

Descripción: Navega a la página anterior en el historial del navegador.

Parámetros:

  • No requiere parámetros adicionales

5. clear_input

Descripción: Limpia el contenido de un campo de entrada.

Parámetros:

  • target (requerido): Selector del elemento a limpiar

6. ios_write

Descripción: Escribe texto en un elemento en dispositivos iOS.

Parámetros:

  • target (requerido): Selector del elemento donde escribir

  • param (requerido): Texto a escribir

  • flags (opcional): Flags especiales como "click_before_write"

7. write

Descripción: Escribe texto en un campo de entrada web.

Parámetros:

  • target (requerido): Selector del elemento donde escribir

  • param (requerido): Texto a escribir

  • flags (opcional): Flags especiales como "click_before_write"

8. sleep

Descripción: Pausa la ejecución por un tiempo especificado.

Parámetros:

  • param (requerido): Tiempo de pausa en segundos

9. upload_file

Descripción: Sube un archivo a un elemento de tipo file.

Parámetros:

  • target (requerido): Selector del elemento de tipo file

  • param (requerido): Ruta del archivo a subir

10. scroll

Descripción: Hace scroll en la página, ya sea hacia un elemento específico o por desplazamiento.

Parámetros:

  • target (opcional): Selector del elemento hacia el cual hacer scroll

  • offset_x (opcional): Desplazamiento horizontal en píxeles

  • offset_y (opcional): Desplazamiento vertical en píxeles

11. wait_not_present

Descripción: Espera hasta que un elemento no esté presente o visible en la página.

Parámetros:

  • target (requerido): Selector del elemento a esperar que desaparezca

  • wait_presence (opcional): Tiempo máximo de espera en segundos

12. wait_click

Descripción: Espera hasta que un elemento sea clickeable.

Parámetros:

  • target (requerido): Selector del elemento a esperar

  • wait_presence (opcional): Tiempo máximo de espera en segundos

13. wait_element

Descripción: Espera hasta que un elemento esté presente en la página.

Parámetros:

  • target (requerido): Selector del elemento a esperar

  • wait_presence (opcional): Tiempo máximo de espera en segundos

14. execute_script

Descripción: Ejecuta código JavaScript en la página.

Parámetros:

  • param (requerido): Código JavaScript a ejecutar

15. wait_clickable

Descripción: Espera hasta que un elemento sea clickeable usando WebDriverWait.

Parámetros:

  • target (requerido): Selector CSS del elemento a esperar

16. compare_vars

Descripción: Compara dos variables almacenadas.

Parámetros:

  • variable1 (requerido): Primera variable a comparar

  • variable2 (requerido): Segunda variable a comparar

17. compare_text

Descripción: Compara el texto de un elemento con un valor esperado.

Parámetros:

  • target (requerido): Selector del elemento a comparar

  • param (requerido): Texto esperado

18. switch_frame

Descripción: Cambia el contexto a un iframe específico.

Parámetros:

  • index (opcional): Índice del iframe

  • id (opcional): ID del iframe

  • name (opcional): Nombre del iframe

  • option (opcional): Opción especial ("parent", "default")

  • target (opcional): Selector del iframe

19. check_url

Descripción: Verifica que la URL actual coincida con la esperada.

Parámetros:

  • param (requerido): URL esperada

20. switch_tab

Descripción: Cambia a una pestaña específica del navegador.

Parámetros:

  • target (requerido): Índice de la pestaña o "last_tab"

21. store

Descripción: Almacena información de un elemento en una variable.

Parámetros:

  • target (requerido): Selector del elemento

  • name (requerido): Nombre de la variable donde almacenar

  • store_type (opcional): Tipo de almacenamiento ("attribute", "text")

  • store_param (opcional): Nombre del atributo si store_type es "attribute"

22. delete_stored_variable

Descripción: Elimina una variable almacenada.

Parámetros:

  • name (requerido): Nombre de la variable a eliminar

23. set_custom_variable

Descripción: Establece una variable personalizada con el texto de un elemento.

Parámetros:

  • target (requerido): Selector del elemento

  • name (requerido): Nombre de la variable personalizada

  • custom_variable_type (requerido): Tipo de variable ("string", "number", "date", "integer")

  • regex (opcional): Expresión regular para procesar el texto

24. check_email

Descripción: Verifica el contenido de un email.

Parámetros:

  • param (requerido): Parámetros específicos para verificación de email

25. select

Descripción: Selecciona una opción de un elemento select.

Parámetros:

  • target (requerido): Selector del elemento select

  • param (requerido): Valor o texto de la opción a seleccionar

26. check_value

Descripción: Verifica el valor de un elemento.

Parámetros:

  • target (requerido): Selector del elemento

  • param (requerido): Valor esperado

27. count

Descripción: Cuenta elementos que coinciden con un selector y almacena el resultado.

Parámetros:

  • target (requerido): Selector de los elementos a contar

  • name (requerido): Nombre de la variable donde almacenar el conteo

28. mouseover

Descripción: Realiza una acción de pasar el mouse sobre un elemento.

Parámetros:

  • target (requerido): Selector del elemento

29. screenshot

Descripción: Toma una captura de pantalla.

Parámetros:

  • No requiere parámetros adicionales

30. modify_store_variable

Descripción: Modifica una variable almacenada existente.

Parámetros:

  • name (requerido): Nombre de la variable a modificar

  • param (requerido): Nuevo valor o operación a realizar

31. check_file

Descripción: Verifica que un archivo haya sido descargado.

Parámetros:

  • param (requerido): Nombre o patrón del archivo a verificar

32. mobile_list_all_elements

Descripción: Lista todos los elementos disponibles en una aplicación móvil.

Parámetros:

  • No requiere parámetros adicionales

33. execute_android_command

Descripción: Ejecuta un comando específico de Android.

Parámetros:

  • param (requerido): Comando de Android a ejecutar

34. android_tap

Descripción: Realiza un tap en una aplicación Android.

Parámetros:

  • target (requerido): Coordenadas o selector del elemento

  • param (opcional): Parámetros adicionales del tap

35. android_click

Descripción: Hace clic en un elemento de una aplicación Android.

Parámetros:

  • target (requerido): Selector del elemento Android

36. ios_click

Descripción: Hace clic en un elemento de una aplicación iOS.

Parámetros:

  • target (requerido): Selector del elemento iOS

37. android_scroll

Descripción: Realiza scroll en una aplicación Android.

Parámetros:

  • target (opcional): Selector del elemento hacia el cual hacer scroll

  • param (opcional): Dirección o parámetros del scroll

38. android_swipe

Descripción: Realiza un gesto de swipe en una aplicación Android.

Parámetros:

  • target (opcional): Selector del elemento

  • param (opcional): Dirección o parámetros del swipe

39. android_write

Descripción: Escribe texto en un elemento de una aplicación Android.

Parámetros:

  • target (requerido): Selector del elemento Android

  • param (requerido): Texto a escribir

40. android_hide_keyboard

Descripción: Oculta el teclado virtual en Android.

Parámetros:

  • No requiere parámetros adicionales

41. android_back

Descripción: Presiona el botón de retroceso en Android.

Parámetros:

  • No requiere parámetros adicionales

42. debug_print_html

Descripción: Imprime el HTML de la página actual para depuración.

Parámetros:

  • No requiere parámetros adicionales

43. check_api_response

Descripción: Verifica la respuesta de una API.

Parámetros:

  • param (requerido): Parámetros para verificar la respuesta de la API

44. enter_maintenance

Descripción: Entra en modo de mantenimiento.

Parámetros:

  • param (opcional): Parámetros específicos del modo de mantenimiento

45. windows_click

Descripción: Hace clic en un elemento de una aplicación Windows.

Parámetros:

  • target (requerido): Selector del elemento Windows

Parámetros Comunes

execute_if

Parámetro condicional que permite ejecutar una acción sólo si se cumple una condición específica. Soporta las siguientes condiciones:

  • store [variable] exists: Ejecuta si la variable existe

  • store [variable] not_exists: Ejecuta si la variable no existe

  • store [variable] equals [value]: Ejecuta si la variable es igual al valor

  • store [variable] less_than [value]: Ejecuta si la variable es menor que el valor

  • store [variable] greater_than [value]: Ejecuta si la variable es mayor que el valor

  • store [variable] is_empty: Ejecuta si la variable está vacía

flags

Parámetro que permite especificar comportamientos especiales para las acciones:

  • ignore_scroll_to: No hace scroll automático al elemento

  • click_before_write: Hace clic en el elemento antes de escribir

  • android_timeout_popup_check: Verifica y cierra popups de timeout en Android

Notas Importantes

  1. Todas las acciones requieren el parámetro type que especifica el tipo de acción a ejecutar.

  2. El parámetro target generalmente se refiere a un selector CSS, XPath, o identificador específico de la plataforma.