ui_wait_for_element
Schermo, finestre e interfaccia · macOS · Windows
Effetto: lettura. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Sincronizzazione deterministica: sostituisce tutti gli sleep. Interroga ripetutamente un elemento finché non raggiunge state (present|enabled|focused|absent) o finché non scade il tempo. Un timeout è un errore ESPLICITO, mai un falso successo. Restituisce {satisfied, waited_ms, element_ref?, bounds?, role?, label?, enabled_unknown?}. state:'enabled' è soddisfatto a meno che l'app non pubblichi AXEnabled=false; se l'app non pubblica affatto AXEnabled il risultato contiene enabled_unknown:true — l'attesa non si è bloccata, ma nulla è stato effettivamente verificato sullo stato di abilitazione.
Input obbligatori
Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — macOS
{
"properties": {
"app_bundle_id": {
"description": "Bundle id of the app to look in (e.g. com.apple.Safari). Narrows the search and makes it faster.",
"type": "string"
},
"label": {
"description": "Visible label or title of the element.",
"type": "string"
},
"match": {
"description": "How to compare label: \"exact\" (default) or \"contains\".",
"enum": [
"exact",
"contains"
],
"type": "string"
},
"poll_ms": {
"description": "Default 150.",
"type": "integer"
},
"role": {
"description": "Accessibility role of the element (e.g. AXButton, AXTextField).",
"type": "string"
},
"state": {
"description": "Default present.",
"enum": [
"present",
"enabled",
"focused",
"absent"
],
"type": "string"
},
"timeout_ms": {
"description": "Default 5000.",
"type": "integer"
},
"window_id": {
"description": "Window to look in, from list_windows. Narrows the search to one window.",
"type": "string"
}
},
"required": [],
"type": "object"
}Esempio documentale
Esempio di documentazione per ui_wait_for_element. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"label": "Save"
}Windows
Scopo
Attende tramite interfaccia utente e restituisce un risultato strutturato per l’uso nelle chiamate successive. rispetta i timeout e segnala esplicitamente gli errori. Parametri, valori e forme tecniche da mantenere invariati: waited_ms, element_ref, satisfied, {satisfied,waited_ms,element_ref?,bounds?}, enabled, focused, present|enabled|focused|absent.
Input obbligatori
Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — Windows
{
"properties": {
"app": {
"description": "Scope to this app: process name (e.g. notepad) or a window-title substring.",
"type": "string"
},
"label": {
"description": "Name/HelpText/Value to match.",
"type": "string"
},
"match": {
"description": "Default contains.",
"enum": [
"exact",
"contains"
],
"type": "string"
},
"poll_ms": {
"description": "Default 150.",
"type": "integer"
},
"role": {
"description": "UIA control type, e.g. Button, Edit, MenuItem, CheckBox.",
"type": "string"
},
"state": {
"description": "Default present.",
"enum": [
"present",
"enabled",
"focused",
"absent"
],
"type": "string"
},
"timeout_ms": {
"description": "Default 5000.",
"type": "integer"
}
},
"required": [],
"type": "object"
}Esempio documentale
Esempio di documentazione per ui_wait_for_element. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"label": "Save"
}