Métodos de conector Chromium

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura
  • Os métodos do conector Chromium executam tarefas diferentes nas aplicações, telas e elementos nas telas do Google Chrome e o. Microsoft Edge navegadores.

    Níveis do método do conector Chromium

    Métodos no nível da aplicação

    Métodos no nível da tela

    Métodos de nível de elemento

    Métodos no nível da aplicação

    Navegar

    Inicia a página da Web com base no URL especificado.

    Para fornecer entradas, consulte Configure as propriedades da porta
    Tabela 1. Navegue pelos parâmetros do método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    URL URL da página da web. Dados em Cadeia de caracteres Nenhum valor padrão Não
    Tempo limite Opção para especificar o tempo em segundos após o qual a operação expira. Dados em Inteiro Nenhum valor padrão Não
    Retornar Se verdadeiro, a página da Web foi iniciada. Caso contrário, se Falso, a página da Web não foi iniciada. Saída de dados Booliano Não aplicável Não aplicável

    WaitForAnyScreen

    Define um atraso antes que as telas especificadas sejam carregadas.

    Para especificar a tela, execute as seguintes etapas:
    1. Clique no ícone Configurações de método ( Ícone de configurações de método.).
    2. Na janela ESCOLHER TELAS, selecione a tela necessária.
    3. Clique em OK.
    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.
    Tabela 2. Navegue pelos parâmetros do método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    MatchAllChild Se verdadeiro, antes de carregar a tela, o método corresponderá aos elementos capturados da página da Web. Caso contrário, se Falso, o método não corresponde a nenhum elemento. Dados em Booliano Nenhum valor padrão Não Os elementos podem ser encontrados na seção CORRESPONDER SECUNDÁRIOS da janela Conector Chromium.
    Tempo limite Especifica o tempo em segundos após o qual a operação expira. Dados em Inteiro Nenhum valor padrão Não

    Métodos no nível da tela

    Fechar

    Fecha a janela da tela capturada.

    Foco

    Define o foco na janela capturada.
    Tabela 3. Navegue pelos parâmetros do método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Se verdadeiro, o foco foi definido na janela capturada. Caso contrário, se Falso, o foco não foi definido na janela capturada. Saída de dados Booliano Nenhum valor padrão Não aplicável

    GetFields

    Retorna os valores dos campos ou elementos especificados. Por exemplo, ele pode retornar o texto em um botão.

    Para especificar os campos, execute as etapas a seguir.
    1. Clique no ícone Configurações de método ( Ícone de configurações de método.).
    2. Na janela ESCOLHER ELEMENTOS DE FORMULÁRIO, selecione os campos obrigatórios.
    3. Clique em OK.
    Tabela 4. Parâmetros do método GetFields
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Nome do campo ou elemento Campo ou elemento para o qual o método retorna o valor. Saída de dados Cadeia de caracteres Nenhum valor padrão Não aplicável

    GetInnerHtml

    Retorna o HTML interno da tela capturada.
    Tabela 5. Parâmetros do método GetInnerHtml
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o HTML interno da tela capturada. Saída de dados Objeto Não aplicável Não aplicável

    GetPageSource

    Retorna a origem da página da tela capturada.
    Tabela 6. Parâmetros do método GetPageSource
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a origem da página da tela capturada. Saída de dados Cadeia de caracteres Não aplicável Não aplicável

    GetScreenshot

    Retorna a captura de tela da tela configurada.
    Tabela 7. Parâmetros do método GetScreenshot
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a captura de tela da tela configurada. Saída de dados Bitmap Nenhum valor padrão Não aplicável

    Obter título

    Retorna o título da página da Web capturada.
    Tabela 8. Parâmetro do método GetTitle
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o título da página da Web capturada. Saída de dados Cadeia de caracteres Nenhum valor padrão Não aplicável

    GetURL

    Retorna o URL da página da Web que foi capturada.
    Tabela 9. Parâmetros do método GetURL
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o URL da página da Web que foi capturada. Saída de dados Cadeia de caracteres Nenhum valor padrão Não aplicável

    GetValueByXPath

    Retorna o valor em um nó XML do caminho XML especificado.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.

    Tabela 10. Parâmetros do método GetValueByXPath
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    XPath XPath da página da web capturada. Dados em Cadeia de caracteres Nenhum valor padrão Não
    Retornar Retorna o valor do nó XML. Saída de dados Cadeia de caracteres Não aplicável Não aplicável

    ÉCriado

    Retorna o valor booliano com base no fato de a tela ser renderizada com sucesso na aplicação web.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.

    Tabela 11. Éparâmetros do método criado
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Tipo padrão Obrigatório? Anotações
    MatchAllChild Se verdadeiro, antes que a tela seja renderizada, o método tentará corresponder a todos os elementos capturados. Caso contrário, se Falso, nenhuma correspondência será feita. Dados em Booliano Nenhum valor padrão Não Você pode encontrar os elementos capturados na seção CORRESPONDER SECUNDÁRIOS da janela Conector Chromium.
    Retornar Se verdadeiro, a tela será renderizada com sucesso. Caso contrário, se Falso, a tela falhou ao renderizar com sucesso. Saída de dados Booliano Não aplicável Não aplicável

    Métodos de nível de elemento

    Clique

    Executa uma operação de clique no elemento.

    Foco

    Define o foco no elemento.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.
    Tabela 12. Parâmetros do método de foco
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    RollIntoView Se verdadeiro, o método usará a barra de rolagem para navegar até o elemento capturado na página da Web. Caso contrário, se Falso, não rolará até o elemento capturado. Dados em Booliano Nenhum valor padrão Não
    Retornar Se verdadeiro, o método definirá o foco no elemento. Caso contrário, se Falso, o método não conseguiu definir o foco no elemento. Saída de dados Booliano Não aplicável Não aplicável

    GetInnerHTML

    Retorna o HTML interno do elemento capturado.
    Tabela 13. Parâmetros do método GetInnerHTML
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o HTML interno do elemento capturado. Saída de dados Cadeia de caracteres Nenhum tipo padrão Não aplicável

    GetInnerText

    Retorna o texto interno no elemento capturado.
    Tabela 14. Parâmetros do método GetInnerText
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o texto interno no elemento capturado. Saída de dados Cadeia de caracteres Não aplicável Não aplicável

    GetOuterHTML

    Retorna o elemento HTML e seus atributos, marcadores de início e término do elemento capturado.
    Tabela 15. Parâmetros do método GetOuterHTML
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o HTML externo do elemento capturado. Saída de dados Cadeia de caracteres Nenhum valor padrão Não aplicável

    GetOuterText

    Retorna o conteúdo de texto do elemento capturado.
    Tabela 16. Parâmetros do método GetOuterText
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o conteúdo de texto do elemento capturado. Saída de dados Cadeia de caracteres Nenhum valor padrão Não aplicável

    ÉCriado

    Retorna o status booliano que indica se o elemento capturado foi carregado.
    Tabela 17. Parâmetro de método criado
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Se verdadeiro, o elemento capturado foi carregado. Caso contrário, se Falso, o elemento capturado falhou ao carregar. Saída de dados Booliano Nenhum valor padrão Não aplicável

    SetPassword

    Automatizar a inserção de senha com segurança no campo de senha de uma aplicação baseada na Web, por exemplo, inserir senha com segurança no campo de senha de um formulário de login.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.
    Tabela 18. Parâmetros do método SetPassword
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    Senha Aceita a senha como uma cadeia de caracteres segura. Dados em Cadeia de caracteres protegida Nenhum(a) Sim Como aceita a senha como uma cadeia de caracteres segura, ela mostra somente o tamanho da cadeia de caracteres quando você clica com o botão direito do mouse no parâmetro e clica em Visualizar dados .
    UseSendKeys SendKeys é um método usado para enviar entradas de teclado, como caracteres, números e símbolos, para caixas de texto dentro de uma aplicação. Dados em Booliano Falso(a) Sim
    Dica:
    . SetPassword o método falha ao inserir a senha no campo de senha, defina o valor como Verdadeiro e execute o método novamente.

    Chaves de envio

    Passa teclas de atalho para o elemento capturado.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.
    Tabela 19. Parâmetros do método SendKeys
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Chaves Usa as teclas de atalho. Dados em Cadeia de caracteres Nenhum valor padrão Não
    ValorExistente Se verdadeiro, o método limpa qualquer valor existente no campo. Caso contrário, se Falso, não limpará o valor existente. Dados em Booliano Nenhum valor padrão Não
    TypeAtraso Define o atraso de digitação entre cada tecla. Dados em Duplo Nenhum valor padrão Não

    GetInstanceCount

    Retorna uma contagem do número de instâncias em que o elemento está disponível.

    GetOuterHTML

    Obtém o HTML externo do elemento capturado.

    Chaves de envio

    Simula pressionamentos de tecla em páginas da web e janelas.
    Entradas
    ValorExistente
    TypeAtraso

    MouseEvent simulado

    Simula o evento do mouse especificado em um elemento em uma aplicação baseada na Web. Por exemplo, simule um clique com o botão direito do mouse em um elemento.
    Importante:
    Para simular um evento de mouse em um elemento, ele já deve ter esse evento específico definido no HTML da página da web. Por exemplo, para simular o. contextmenu evento em um elemento, o elemento já deve ter contextmenu Evento definido no HTML.
    Para fornecer entradas para os campos, consulte Configure as propriedades da porta
    Tabela 20. Parâmetros do método SimulateMouseEvent
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    MouseEvent Evento de mouse que ocorre no elemento da página da web capturado. No momento em que o evento do mouse ocorre em um elemento de página da web, esse elemento já deve ter o evento do mouse definido no HTML. Dados em MouseEventType clique Sim O método oferece suporte a esses eventos de mouse.
    • clique
    • dblclick
    • mousedown
    • mouseup
    • passar o mouse
    • mousemove
    • mouseout
    • contextmenu
    Botão do mouse Simula o clique do botão do mouse no elemento da página da web capturado. Dados em MouseButtonType Esquerda Sim O método oferece suporte a essas ações do botão do mouse.
    • esquerda
    • meio
    • direita

    SimulateEvent

    Simula o evento HTML que você especifica em um Google Página do Chrome ou um elemento na página.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta
    Tabela 21. Parâmetros do método SimulateEvent
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    EventName Nome do evento HTML. O método oferece suporte aos eventos fornecidos e você deve inserir o nome do evento exatamente como especificado.

    Eventos HTML

    • load
    • descarregar
    • Abortar
    • erro
    • selecionar
    • mudança
    • enviar
    • redefinir
    • foco
    • desfoque
    • redimensionar
    • rolar
    Dados em Cadeia de caracteres Nenhum(a) Sim