web_wait_for

Automatisation web · macOS · Windows

Effet: écriture. É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

Attend (par sondage, non par pause fixe) qu’un élément apparaisse sur la page, ou que le délai expire. À utiliser pour les pages SPA qui s’hydratent après le chargement. Préférez `selector` (un sélecteur CSS, p. ex. "input[name=password]"). `condition` accepte aussi la forme "document.querySelector('...')" ; toute AUTRE condition JavaScript exécute du code arbitraire sur la page (même pouvoir que web_eval) : elle exige confirm=true, et sans lui vous obtenez un aperçu qui n’exécute rien. Elle est désactivée lorsque LMCP est en mode lecture seule. Renvoie met:true/false.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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": {
    "condition": {
      "description": "Alternative to selector: \"document.querySelector('...')\" is accepted as-is; any other JS expression runs arbitrary code on the page (same power as web_eval).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to run a `condition` that is arbitrary JavaScript. Without it, returns a preview and runs nothing. Not needed for `selector` or the document.querySelector('...') form.",
      "type": "boolean"
    },
    "selector": {
      "description": "CSS selector to wait for (preferred; treated as data, never executed). e.g. .feed",
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait (default 15).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour web_wait_for. 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,
  "selector": "h1",
  "session": "demo-browser"
}

Windows

Objectif

Attend (par sondage, non par pause fixe) qu’un élément apparaisse (ou qu’une condition de la page soit remplie), ou que le délai expire. PRÉFÉREZ le paramètre `selector` : un sélecteur CSS attendu comme donnée (p. ex. selector "input[name=password]"). `condition` accepte aussi la forme documentée "document.querySelector('SEL')" pour compatibilité, ou tout autre JavaScript à évaluer sur la page, ce qui exige confirm=true (sans lui vous obtenez un aperçu et rien ne s’exécute). Renvoie met:true/false.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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 — Windows

{
  "properties": {
    "condition": {
      "description": "Alternative to selector: \"document.querySelector('SEL')\" (compat), or any other JavaScript.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to run a `condition` that is arbitrary JavaScript. Without it, returns a preview and runs nothing. Not needed for `selector` or the document.querySelector('SEL') form.",
      "type": "boolean"
    },
    "selector": {
      "description": "CSS selector to wait for (preferred; treated as data, never executed). e.g. .feed, input[name=password]",
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait (default 15).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

{
  "confirm": false,
  "selector": "h1",
  "session": "demo-browser"
}