web_click

Automatisation web · 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

Clique sur un élément de la page actuelle. `target` est un sélecteur CSS ou un texte visible (résolu à chaque appel). Clics qui SOUMETtent d'abord un aperçu du formulaire - appelez à nouveau avec confirm:true pour exécuter ; les liens/boutons simples cliquent directement. Renvoie {url, title, navigated, url_as_of} : `url_as_of` est "réglé" lorsque la page a fini de changer, et "before_click" avec navigation_pending:true lorsque le clic a démarré une navigation qui n'était pas terminée - dans ce cas url/title sont la page AVANT le clic, PAS la destination, donc ne les lisez pas comme « le clic n'a rien fait » et réessayez (la page est déjà en train de changer) ; lisez la destination avec web_read ou attendez-la avec web_wait_for. « navigated:false » signifie que le clic n'a modifié aucune page.

Entrées requises

target

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 déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

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": {
    "confirm": {
      "description": "Required (true) to perform a click that submits a form.",
      "type": "boolean"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "target": {
      "description": "CSS selector or visible text of the element to click.",
      "type": "string"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour web_click. 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.

{
  "confirm": false,
  "session": "demo-browser",
  "target": "button[aria-label='Open navigation']"
}

Windows