web_eval

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

Exécute du JavaScript arbitraire dans une session web et renvoie la valeur de la dernière expression, qui doit être une simple valeur JSON (le code asynchrone n’est pas attendu : renvoyez JSON.stringify(...) ou stockez le résultat et lisez-le lors d’un second appel). Nécessite confirm=true ; sans lui, vous obtenez un aperçu du code et rien ne s’exécute. Désactivé lorsque LMCP est en mode lecture seule. Outil pour utilisateurs avancés — une page pourrait fournir du code malveillant, préférez donc web_find / web_read / web_extract pour un usage normal.

Entrées requises

js

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": "Must be true to run the code. Without it, returns a preview and runs nothing.",
      "type": "boolean"
    },
    "js": {
      "description": "JavaScript to evaluate on the page; the last expression's value is returned.",
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    }
  },
  "required": [
    "js"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour web_eval. 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,
  "js": "document.title",
  "session": "demo-browser"
}

Windows