web_click

Automação Web · macOS · Windows

Efeito: execução. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Clica em um elemento na página atual. `target` é um seletor CSS ou texto visível (resolvido a cada chamada). Clica primeiro em SUBMIT uma visualização do formulário - chama novamente com confirm:true para executar; links/botões simples clicam diretamente. Retorna {url,title,navigated,url_as_of}: `url_as_of` é "estabelecido" quando a página termina de mudar, e "before_click" junto com navigation_pending:true quando o clique inicia uma navegação que não havia terminado — nesse caso url/título são a página BEFORE o clique, NOT a destino, portanto não os leia como 'o clique não fez nada' e tente novamente (a página já está mudando); leia o destino com web_read ou espere com web_wait_for. `navigated:false` significa que o clique não alterou nenhuma página.

Entradas obrigatórias

target

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para web_click. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows