Utilizzare l'oggetto Wait per attendere un particolare stato di una sessione o di uno schermo. Ad esempio, è possibile attendere che il cursore si trovi in una determinata posizione o che in una certa posizione sia presente il testo sia presente un testo prima di continuare l'esecuzione della macro.
Le funzioni Wait sono spesso utilizzare insieme alle funzioni asincrone quali connect() e sendKeys().
NOTA:Tutte le funzioni accettano i timeout come parametro facoltativo e hanno un valore di timeout predefinito di 10 secondi (10000ms).
Importante: Tutte le funzioni Wait devono essere precedute dalla parola chiave "yield". Questo consente alla macro di bloccare l'esecuzione fino a quando sono soddisfatte le condizioni della funzione Wait.
[parameter] denota un parametro facoltativo.
Tabella 5-36 In attesa dell'host
|
METODI |
|
|---|---|
|
setDefaultTimeout(timeout) |
Imposta il valore di timeout per tutte le funzioni. Parametri {Number} timeout predefinito da utilizzare per tutte le funzioni Wait in millisecondi. Restituisce Nessun valore Genera {RangeError} Se il timeout specificato è minore di zero. |
|
forConnect([timeout]) |
Attende il completamento di una richiesta di connessione. Parametri {Number} in millisecondi. Restituisce {Promise} Completata se la sessione è già connessa o quando si verifica la connessione. Rifiutata in caso di timeout. |
|
forDisconnect([timeout]) |
Attende il completamento di una richiesta di disconnessione. Parametri {Number} timeout in millisecondi. Restituisce {Promise} Completata se la sessione è già disconnessa o quando si verifica la disconnessione. Rifiutata in caso di timeout. |
|
forFixedTime([timeout]) |
Attende incondizionatamente per il tempo stabilito. Il tempo è stabilito in millisecondi (ms) Parametri {Number} timeout in millisecondi. Restituisce {Promise} Completata quando il tempo scade |
|
forScreenChange([timeout]) |
Attende la modifica della schermata host. Questa funzione restituisce il risultato quando viene rilevato un aggiornamento di schermata. Non fornisce alcuna garanzia in merito al numero di aggiornamenti successivi che possono essere ricevuti prima che la schermata venga completata. Si consiglia di prolungare l'attesa finché il contenuto della schermata soddisfi determinati criteri di interruzione noti. Parametri {Number} timeout in millisecondi. Restituisce {Promise} Risolto se la schermata cambia. Rifiutata in caso di timeout. |
|
forCursor(position, [timeout]) |
Attende che il cursore arrivi alla posizione specificata. Parametri {Position} La posizione che specifica la riga e la colonna {Number} timeout in millisecondi Restituisce {Promise} Completata se il cursore è già posizionato o quando ha raggiunto la posizione. Rifiutata in caso di timeout. |
|
forText(text, position, [timeout]) |
Attende che il testo si trovi in una posizione specifica sullo schermo Parametri {String} testo previsto {Position} posizione che specifica la riga e la colonna {Number} timeout in millisecondi Restituisce {Promise} Completata se il testo è già nella posizione specificata o quando ha raggiunto la posizione. Rifiutata in caso di timeout. Genera {rangeError} se la posizione non è valida. |
|
forHostPrompt(text, column,[timeout]) |
Attende un prompt dei comandi posizionato in una colonna specifica sullo schermo. Parametri {String} testo del prompt previsto {Number} colonna in cui è previsto il cursore {Number} timeout in millisecondi. Restituisce {Promise} Completata se le condizioni sono già soddisfatte o quando vengono soddisfatte. Rifiutata in caso di timeout. Genera {rangeError} se la colonna è al di fuori dell'intervallo. |