Utilice el objeto wait para esperar una sesión particular o un estado de pantalla. Por ejemplo, puede esperar hasta que el cursor se encuentre en una posición particular o hasta que haya texto presente en una posición determinada antes de continuar con la ejecución de la macro.
Las funciones de espera se utilizan frecuentemente en combinación con funciones asíncronas como connect() y sendKeys().
NOTA:Todas las funciones tienen tiempo de espera como parámetro opcional y tienen un valor de tiempo de espera predeterminado de 10 segundos (10000 ms).
Importante: Todas las funciones de espera requieren la clave ‘yield’ enfrente de ellas. Esto permite bloquear la ejecución de la macro hasta que se cumplan las condiciones para la función de espera.
[parameter] denota un parámetro opcional.
Tabla 5-36 Esperando a host
|
MÉTODOS |
|
|---|---|
|
setDefaultTimeout(timeout) |
Establece el valor de tiempo de espera predeterminado para todas las funciones. Parámetros {Number} tiempo de espera predeterminado para todas las funciones de espera en milisegundos. Devuelve Nada Arroja {RangeError} Si el tiempo de espera especificado es menor de cero. |
|
forConnect([timeout]) |
Espera una solicitud de conexión para completar. Parámetros {Number} en milisegundos. Devuelve {Promise} Rellenada si la sesión ya está conectada o cuando se realiza la conexión. Rechazada si expira el tiempo de espera. |
|
forDisconnect([timeout]) |
Espera una solicitud de desconexión para completar. Parámetros {Number} tiempo de espera en milisegundos. Devuelve {Promise} Rellenada si la sesión ya está desconectada o cuando se desconecta finalmente. Rechazada si expira el tiempo de espera. |
|
forFixedTime([timeout]) |
Espera de forma incondicional un tiempo fijo. Tiempo en milisegundos (ms) Parámetros {Number} tiempo de espera en milisegundos. Devuelve {Promise}Rellenada tras lapsos de tiempo |
|
forScreenChange([timeout]) |
Espera a que cambie la pantalla de host. Esta función se devuelve cuando se detecta una actualización de pantalla. No ofrece garantías sobre el número de actualizaciones posteriores que pueden recibirse antes de que se complete la pantalla. Es aconsejable esperar repetidamente hasta que el contenido de la pantalla coincida con algunos criterios de detención conocidos. Parámetros {Number} tiempo de espera en milisegundos. Devuelve {Promise} Se resuelve si la pantalla cambia. Rechazada si expira el tiempo de espera. |
|
forCursor(position, [timeout]) |
Espera a que el cursor llegue a la posición especificada. Parámetros {Position} La posición que especifica la fila y la columna, {Number} tiempo de espera en milisegundos Devuelve {Promise} Rellenada si el cursor ya está colocado o cuando se coloca finalmente. Rechazada si expira el tiempo de espera. |
|
forText(text, position, [timeout]) |
Espera hasta que el texto esté colocado en una posición específica de la pantalla Parámetros {String} texto a esperar {Position} Posición que especifica la fila y la columna, {Number}tiempo de espera en milisegundos Devuelve {Promise} Rellenada si el texto ya se encuentra en la posición especificada o cuando se coloque allí. Rechazada si expira el tiempo de espera. Arroja {rangeError} si la posición no es válida. |
|
forHostPrompt(text, column,[timeout]) |
Espera a un símbolo de sistema esté colocado en una columna particular en la pantalla. Parámetros {String} pregunta de texto a esperar {Number} columna en la que se espera el cursor {Number} tiempo de espera en milisegundos. Devuelve {Promise} Rellenada si las condiciones ya se cumplen o cuando por fin se cumplen las condiciones. Rechazada si expira el tiempo de espera. Arroja {RangeError} si la columna está fuera de rango. |