Métodos do conector do Chromium

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 9 min. de leitura
  • Os métodos do conector do Chromium executam tarefas diferentes nas aplicações, nas telas e nos elementos das telas dos navegadores Google Chrome e Microsoft Edge.

    Níveis de método do conector do Chromium

    Métodos de nível de aplicação

    Métodos de nível de tela

    Métodos de nível de elemento

    Métodos de nível de aplicação

    Navegar

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

    Para fornecer entradas, consulte Configurar propriedades da porta
    Tabela 1. Parâmetros do método de navegação
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    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 for verdadeiro, a página da web foi iniciada. Caso contrário, se for falso, a página da web não foi iniciada. Dados esgotados Booleano Não aplicável Não aplicável

    Aguardar qualquer tela

    Define um atraso antes que as telas especificadas sejam carregadas.

    Para especificar a tela, siga estas etapas:
    1. Clique no ícone de configurações do método (ícone de configurações do método).
    2. Na janela ESCOLHER TELAS, selecione a tela necessária.
    3. Clique em OK.
    Para fornecer entradas para os campos, consulte Configurar propriedades da porta.
    Tabela 2. Parâmetros do método de navegação
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Corresponder a todos os secundários Se for verdadeiro, antes de carregar a tela, o método corresponderá aos elementos capturados da página da Web. Caso contrário, se for falso, o método não corresponderá a nenhum elemento. Dados em Booleano Nenhum valor padrão Não Os elementos podem ser encontrados na seção MATCH CHILDREN da janela do Chromium Connector.
    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 de nível de tela

    Fechar

    Fecha a janela da tela capturada.

    Foco

    Define o foco na janela capturada.
    Tabela 3. Parâmetros do método de navegação
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Se verdadeiro, o foco foi definido na janela capturada. Caso contrário, se for falso, o foco não foi definido na janela capturada. Dados esgotados Booleano Nenhum valor padrão Não aplicável

    Obter campos

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

    Para especificar os campos, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do método).
    2. Na janela ESCOLHA 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? Anotações
    Nome do campo ou elemento Campo ou elemento para o qual o método retorna o valor. Dados esgotados 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? Anotações
    Retornar Retorna o HTML interno da tela capturada. Dados esgotados Object 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? Anotações
    Retornar Retorna a origem da página da tela capturada. Dados esgotados 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? Anotações
    Retornar Retorna a captura de tela da tela configurada. Dados esgotados 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? Anotações
    Retornar Retorna o título da página da web capturada. Dados esgotados Cadeia de caracteres Nenhum valor padrão Não aplicável

    Obter URL

    Retorna o URL da página da Web que foi capturado.
    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? Anotações
    Retornar Retorna o URL da página da Web que foi capturado. Dados esgotados 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 Configurar 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? Anotações
    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. Dados esgotados Cadeia de caracteres Não aplicável Não aplicável

    Foi criado

    Retorna o valor booliano com base na renderização bem-sucedida da tela na aplicação Web.

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

    Tabela 11. Parâmetros do método IsCreated
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Tipo padrão Obrigatório? Anotações
    Corresponder a todos os secundários Se for verdadeiro, antes que a tela seja renderizada, o método tentará corresponder a todos os elementos capturados. Caso contrário, se for falso, nenhuma correspondência será feita. Dados em Booleano Nenhum valor padrão Não Você pode encontrar os elementos capturados na seção MATCH CHILDREN da janela do Chromium Connector.
    Retornar Se for verdadeiro, a tela será renderizada com sucesso. Caso contrário, se for falso, a tela não foi renderizada com sucesso. Dados esgotados Booleano Não aplicável Não aplicável

    Métodos de nível de elemento

    Clique em

    Executa uma operação de clique no elemento.

    Foco

    Define o foco no elemento.

    Para fornecer entradas para os campos, consulte Configurar 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? Anotações
    scrollIntoView Se for verdadeiro, o método usará a barra de rolagem para navegar até o elemento capturado na página da Web. Caso contrário, se for falso, ele não rolará para o elemento capturado. Dados em Booleano Nenhum valor padrão Não
    Retornar Se for verdadeiro, o método definirá o foco no elemento. Caso contrário, se for falso, o método falhou ao definir o foco no elemento. Dados esgotados Booleano 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? Anotações
    Retornar Retorna o HTML interno do elemento capturado. Dados esgotados 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? Anotações
    Retornar Retorna o texto interno no elemento capturado. Dados esgotados 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? Anotações
    Retornar Retorna o HTML externo do elemento capturado. Dados esgotados 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? Anotações
    Retornar Retorna o conteúdo de texto do elemento capturado. Dados esgotados Cadeia de caracteres Nenhum valor padrão Não aplicável

    Foi criado

    Retorna o status booliano de se o elemento capturado foi carregado.
    Tabela 17. Parâmetro do método IsCreated
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Se verdadeiro, o elemento capturado foi carregado. Caso contrário, se for falso, o elemento capturado falhou ao carregar. Dados esgotados Booleano Nenhum valor padrão Não aplicável

    Definir Senha

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

    Para fornecer entradas para os campos, consulte Configurar 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 protegida. Dados em Cadeia de caracteres protegida Nenhum Sim Como ele aceita a senha como uma cadeia de caracteres protegida, ele só mostra 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 do teclado, como caracteres, números e símbolos para caixas de texto dentro de uma aplicação. Dados em Booleano Falso Sim
    Dica:
    Se o método SetPassword falhar ao inserir a senha no campo de senha, defina o valor como Verdadeiro e execute o método novamente.

    SendKeys

    Passa teclas de atalho para o elemento capturado.

    Para fornecer entradas para os campos, consulte Configurar 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? Anotações
    Chaves Usa as teclas de atalho. Dados em Cadeia de caracteres Nenhum valor padrão Não
    LimparValorExistente Se for verdadeiro, o método limpará qualquer valor existente no campo. Caso contrário, se for falso, o valor existente não será removido. Dados em Booleano Nenhum valor padrão Não
    TypeDelay 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.

    SendKeys

    Simula o pressionamento de teclas em páginas da Web e janelas.
    Entradas
    LimparValorExistente
    TypeDelay

    Simular evento do mouse

    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 evento de menu de contexto em um elemento, o elemento já deve ter o evento de menu de contexto definido no HTML.
    Para fornecer entradas para os campos, consulte Configurar 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 de página da Web capturado. No momento em que o evento do mouse ocorre em um elemento da 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 do mouse.
    • clique
    • dblclick
    • mousedown
    • mouseup
    • passar o mouse
    • mousemove
    • mouseout
    • menu de contexto
    Botão do mouse Simula o clique do botão do mouse no elemento capturado da página da web. Dados em Tipo de Botão do Mouse Esquerda Sim O método oferece suporte a essas ações de botão do mouse.
    • esquerda
    • meio
    • direita

    Simular evento

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

    Para fornecer entradas para os campos, consulte Configurar 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? Anotações
    EventName Nome do evento HTML. O método oferece suporte aos eventos fornecidos e você deve inserir o nome do evento exatamente conforme especificado.

    Eventos HTML

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