ui_keystroke
Écran, fenêtres et interface · macOS · Windows
Effet: exécution. État: disponibilité conditionnelle.
«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.
macOS
Objectif
Envoie une combinaison de touches, par ex. "cmd+maj+5", "return", "cmd+,", "escape". Modificateurs : cmd, shift, alt/option, ctrl, fn. Le dernier jeton est la clé. Renvoie {sent, delivery:"posted_not_confirmed"} — `sent` signifie que les événements clés ont été PUBLIÉS, PAS que l'application a agi en conséquence : CGEvent ne comporte aucune confirmation delivery et l'effet d'une frappe est arbitraire, donc rien ne peut être relu pour le prouver. Confirmez l'effet avec ui_get_element / ui_read_tree plutôt que de faire confiance à « sent ». Les modificateurs sont libérés après le combo, donc un ui_type suivant n'est pas avalé. unknown_key si la clé n'est pas reconnue. Nécessite une autorisation d’accessibilité.
Entrées requises
keys
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — macOS
{
"properties": {
"keys": {
"description": "e.g. cmd+shift+5, return, cmd+,",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Exemple documentaire
Exemple de documentation pour ui_keystroke. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"keys": "escape"
}Windows
Objectif
Envoie une combinaison de touches à l'application ciblée, par ex. "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape". Modificateurs : ctrl, shift, alt, win (cmd est accepté comme alias pour ctrl). Le dernier jeton est la clé. unknown_key si la clé n'est pas reconnue.
Entrées requises
keys
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — Windows
{
"properties": {
"keys": {
"description": "e.g. ctrl+s, return, ctrl+shift+n",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Exemple documentaire
Exemple de documentation pour ui_keystroke. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"keys": "escape"
}