Métodos do conector do Chromium

Níveis de método do conector do Chromium

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

Navegar

Inicia a página da Web com base na URL especificada.

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?
URL	URL da página da web.	Entrada de dados	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.	Entrada de dados	Números inteiros	Nenhum valor padrão	Não
Retornar	Se verdadeiro, a página da Web foi iniciada. Caso contrário, se for falso, a página da Web não foi iniciada.	Saída de dados	Booliano	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:

Clique no ícone de configurações de método ( ).
Na janela ESCOLHER TELAS, selecione a tela necessária.
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
CorresponderTodos os Filhos	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.	Entrada de dados	Booliano	Nenhum valor padrão	Não	Os elementos podem ser encontrados na seção MATCH CHILDREN da janela do conector do Chromium.
Tempo limite	Especifica o tempo em segundos após o qual a operação expira.	Entrada de dados	Números inteiros	Nenhum valor padrão	Não

Métodos de nível de tela

Encerrar

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?
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.	Saída de dados	Booliano	Nenhum valor padrão	Não aplicável

ObterCampos

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

Para especificar os campos, siga as etapas a seguir.

Clique no ícone de configurações de método ( ).
Na janela ESCOLHA ELEMENTOS DE FORMULÁRIO, selecione os campos obrigatórios.
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

Obter URL

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 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?
XPath	XPath da página da Web capturada.	Entrada de dados	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 em se a tela foi renderizada com sucesso 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
CorresponderTodos os Filhos	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.	Entrada de dados	Booliano	Nenhum valor padrão	Não	Você pode encontrar os elementos capturados na seção MATCH CHILDREN da janela do conector do Chromium.
Retornar	Se for verdadeiro, a tela será renderizada com sucesso. Caso contrário, se for falso, a tela falhou ao ser renderizada com sucesso.	Saída de dados	Booliano	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?
rolar para dentro da exibição	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, não rolará para o elemento capturado.	Entrada de dados	Booliano	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.	Saída de dados	Booliano	Não aplicável	Não aplicável

ObterHTML interno

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

ObterTextoInner

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

ObterHTML externo

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

ObterTextoOutro

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 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?
Retornar	Se verdadeiro, o elemento capturado foi carregado. Else, se falso, o elemento capturado falhou ao carregar.	Saída de dados	Booliano	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.	Entrada de dados	Cadeia de caracteres protegida	Nenhum(a)	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, em seguida, 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.	Entrada de dados	Booliano	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 as 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?
Chaves	Usa as teclas de atalho.	Entrada de dados	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, não limpará o valor existente.	Entrada de dados	Booliano	Nenhum valor padrão	Não
TypeDelay	Define o atraso de digitação entre cada tecla.	Entrada de dados	Duplo	Nenhum valor padrão	Não

ObterContagemDeInstância

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

ObterHTML externo

Obtém o HTML externo do elemento capturado.

SendKeys

Simula pressionamentos de tecla em páginas da Web e janelas.

Entradas: LimparValorExistente; TypeDelay

Simular evento de 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 contextmenu em um elemento, o elemento já deve ter o evento contextmenu 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
Evento do mouse	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 de página da Web, esse elemento já deve ter o evento do mouse definido no HTML.	Entrada de dados	Tipo de evento do mouse	clique	Sim	O método oferece suporte a esses eventos de mouse. clique dblclick mousedown mouseup passar o mouse mousemove mouseout contextmenu
BotãoDoMouse	Simula o clique do botão do mouse no elemento capturado da página da Web.	Entrada de dados	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

SimularEvento

Simula o evento HTML que você especifica em uma página Google do Chrome ou em 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?
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	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim