Verwenden Sie das wait-Objekt, um auf einen bestimmten Sitzungs- oder Bildschirmstatus zu warten. Sie können beispielsweise darauf warten, dass der Cursor an einer bestimmten Position gefunden wird oder Text an einer bestimmten Position vorhanden ist, bevor Sie mit dem Ausführen des Makros fortfahren.
Wait-Funktionen werden häufig zusammen mit asynchronen Funktionen wie connect() oder sendKeys() verwendet.
HINWEIS:Alle Funktionen verwenden Wartezeiten als optionale Parameter und verfügen über einen Wartezeitwert von 10 Sekunden (10000 ms).
Wichtig: Allen wait-Funktionen muss das yield-Schlüsselwort voranstehen. Dadurch kann das Makro die Ausführung blockieren, bis die Bedingungen der wait-Funktion erfüllt wurden.
[parameter] Kennzeichnet einen optionalen Parameter.
Tabelle 5-36 Auf den Host warten
|
METHODEN |
|
|---|---|
|
setDefaultTimeout(timeout) |
Legt die Standardwartezeit für alle Funktionen fest. Parameter {Number} Standardwartezeit für alle wait-Funktionen in Millisekunden. Ausgabe Keine Ergebnis {RangeError} Wenn die angegebene Wartezeit kleiner als null ist. |
|
forConnect([timeout]) |
Wartet auf das Abschließen einer Verbindungsanforderung. Parameter {Number} in Millisekunden. Ausgabe {Promise} Wird ausgeführt, wenn die Sitzung bereits verbunden wurde oder die Verbindung zustande kommt. Wird abgelehnt, wenn die Wartezeit überschritten wurde. |
|
forDisconnect([timeout]) |
Wartet auf das Abschließen einer Anforderung zur Trennung einer Verbindung. Parameter {Number} Wartezeit in Millisekunden. Ausgabe {Promise} Wird ausgeführt, wenn die Verbindung der Sitzung bereits getrennt wurde oder endgültig getrennt wird. Wird abgelehnt, wenn die Wartezeit überschritten wurde. |
|
forFixedTime([timeout]) |
Wartet ohne Bedingungen für eine festgelegte Zeit. Die Zeit wird in Millisekunden (ms) angegeben. Parameter {Number} Wartezeit in Millisekunden. Ausgabe {Promise}Wird nach dem Verstreichen der Zeit ausgeführt. |
|
forScreenChange([timeout]) |
Wartet auf eine Änderung des Hostbildschirms. Diese Funktion gibt eine Rückmeldung, wenn eine Bildschirmaktualisierung erkannt wird. Sie bietet keine Informationen über die Anzahl nachfolgender Aktualisierungen, die möglicherweise bis zur vollständigen Aktualisierung des Bildschirms erfolgen. Es empfiehlt sich, wiederholt zu warten, bis der Bildschirminhalt mit einem bekannten Endkriterium übereinstimmt. Parameter {Number} Wartezeit in Millisekunden. Ausgabe {Promise} Aufgelöst, wenn der Bildschirm geändert wurde. Wird abgelehnt, wenn die Wartezeit überschritten wurde. |
|
forCursor(position, [timeout]) |
Wartet darauf, dass der Cursor die angegebene Position erreicht. Parameter {Position} Die Position, die die Zeile und die Spalte angibt, {Number} Wartezeit in Millisekunden. Ausgabe {Promise}Wird ausgeführt, wenn der Cursor die Position bereits erreicht hat oder sie endgültig erreicht. Wird abgelehnt, wenn die Wartezeit überschritten wurde. |
|
forText(text, position, [timeout]) |
Wartet darauf, dass sich der Text an einer bestimmten Position auf dem Bildschirm befindet. Parameter {String} Der zu erwartende Text. {Position} Die Position, die die Zeile und die Spalte angibt. {Number} Wartezeit in Millisekunden. Ausgabe {Promise} Wird ausgeführt, wenn sich der Text bereits an der angegebenen Position befand oder auf der Position angezeigt wird. Wird abgelehnt, wenn die Wartezeit überschritten wurde. Ergebnis {rangeError} Wenn die Position ungültig ist. |
|
forHostPrompt(text, column,[timeout]) |
Wartet auf eine Eingabeaufforderung in einer bestimmten Spalte auf dem Bildschirm. Parameter {String} Die zu erwartende Texteingabeaufforderung. {Number} Die Spalte, an der der Cursor erwartet wird. {Number} Wartezeit in Millisekunden. Ausgabe {Promise} Wird ausgeführt, wenn die Bedingungen bereits erfüllt wurden oder endgültig erfüllt werden. Wird abgelehnt, wenn die Wartezeit überschritten wurde. Ergebnis {rangeError} Wenn die Spalte außerhalb des Wertebereichs liegt. |