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.
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:
- Clique no ícone de configurações do método (ícone de configurações do
).
- 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 |
| 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 |
|
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.
- Clique no ícone de configurações do método (ícone de configurações do
).
- 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? |
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.
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 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 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. |
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 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? |
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 |
|