web_click

Automazione web · macOS · Windows

Effetto: esecuzione. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Fa clic su un elemento della pagina corrente. target è un selettore CSS o un testo visibile, risolto nuovamente a ogni chiamata. I clic che inviano un modulo mostrano prima un’anteprima: richiamare con confirm:true per eseguirli; link e pulsanti normali vengono attivati direttamente. Restituisce {url, title, navigated, url_as_of}. url_as_of vale "settled" quando la pagina ha terminato di cambiare, oppure "before_click" insieme a navigation_pending:true quando il clic ha avviato una navigazione non ancora conclusa. In quest’ultimo caso url/title descrivono la pagina precedente al clic, non la destinazione: non interpretarli come prova che il clic non abbia funzionato e non ripetere il clic, perché la pagina sta già cambiando. Leggere la destinazione con web_read o attenderla con web_wait_for. navigated:false significa che il clic non ha cambiato pagina.

Input obbligatori

target

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per web_click. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows