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.
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:
- Clique no ícone Configurações de método (
).
- Na janela ESCOLHER TELAS, selecione a tela necessária.
- 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 |
|
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.
- Clique no ícone Configurações de método (
).
- Na janela ESCOLHER 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 |
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.
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 portaTabela 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. |
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 portaTabela 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 |