web_wait_for

Webautomatisierung · macOS · Windows

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Wartet (Abfrage, kein fester Sleep), bis ein Element auf der Seite erscheint, oder läuft in eine Zeitüberschreitung. Verwenden Sie es für SPA-Seiten, die nach dem Laden hydratisiert werden. Bevorzugen Sie `selector` (ein CSS-Selektor, z. B. "input[name=password]"). `condition` akzeptiert auch die Form "document.querySelector('...')"; jede ANDERE JavaScript-Bedingung führt beliebigen Code auf der Seite aus (dieselbe Macht wie web_eval): Sie erfordert confirm=true, und ohne es erhalten Sie eine Vorschau, die nichts ausführt. Ist deaktiviert, wenn LMCP im Nur-Lese-Modus ist. Gibt met:true/false zurück.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für web_wait_for. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Wartet (Abfrage, kein fester Sleep), bis ein Element erscheint (oder eine Seitenbedingung gilt), oder läuft in eine Zeitüberschreitung. BEVORZUGEN Sie den Parameter `selector`: ein CSS-Selektor, auf den als Daten gewartet wird (z. B. selector "input[name=password]"). `condition` akzeptiert aus Kompatibilitätsgründen auch die dokumentierte Form "document.querySelector('SEL')" oder beliebiges anderes JavaScript, das auf der Seite ausgewertet wird und confirm=true erfordert (ohne es erhalten Sie eine Vorschau und nichts wird ausgeführt). Gibt met:true/false zurück.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

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