Ir para o conteúdo

Navegação

Usando os métodos abaixo, você poderá manipular a navegação no navegador e também gerenciar diferentes paginas e abas.

Iniciar o navegador

Você pode iniciar o navegador selecionado. Esse método não abre o navegador, apenas define as configurações padrão e o deixa pronto para uso.

# Inicie o navegador selecionado.
bot.start_browser()

// Inicie o navegador selecionado.
startBrowser();

Pare o navegador

Invocar o stop browser irá finalizar e liberar o WebDriver.

Importante

Este método DEVE sempre ser chamado no final da automação para garantir a liberação adequada dos recursos usados pelo WebDriver.

Não fazer isso pode causar problemas de memória.

# Pare o navegador e limpe.
bot.stop_browser()

// Pare o navegador e limpe.
stopBrowser();

Você pode acessar uma URL usando o navegador selecionado.

# Abre o navegador no site da Botcity.
bot.browse("https://botcity.dev")

# Usar o navigate_to terá o mesmo efeito.
bot.navigate_to("https://botcity.dev")

// Abre o navegador no site da Botcity.
browse("https://botcity.dev");

// Usar o navigateTo terá o mesmo efeito.
navigateTo("https://botcity.dev");

Além de abrir o navegador em uma URL específica, também é possível navegar por novas páginas e interagir com páginas acessadas anteriormente durante o processo.

Voltar

# Acessando uma primeira página.
bot.browse("https://botcity.dev")

# Navegando para uma segunda página.
bot.navigate_to("https://blog.botcity.dev")

# Vai um passo para trás na história do navegador (neste caso, de volta à primeira página).
bot.back()

// Acessando uma primeira página.
browse("https://botcity.dev");

// Navegando para uma segunda página.
navigateTo("https://blog.botcity.dev");

// Vai um passo para trás na história do navegador (neste caso, de volta à primeira página).
back();

Avançar

# Vai um passo para frente na história do navegador.
bot.forward()

// Vai um passo para frente na história do navegador.
forward();

Atualizar

# Atualizando a página atual.
bot.refresh()

// Atualizando a página atual.
refresh();

Obtenha guias

Você pode obter uma lista de 'handlers' para as guias que estão abertas.

# Obtendo os manipuladores de guias.
abas_abertas = bot.get_tabs()
print(abas_abertas)

// Obtendo os manipuladores de guias.
List <String> abasAbertas = getTabs();

para (String aba: abasAbertas) {
    System.out.println(aba);
}

Ativar guia

Com o 'handler' da guia obtido, você pode ativar a guia e, assim, acessar o contexto dessa página. Isso pode ser útil quando você inicia operações em uma página e, em seguida, precisa continuar o processo em uma nova página que foi aberta.

# Obtendo a lista de manipuladores de guias.
abas_abertas = bot.get_tabs()

# Obtendo o identificador de uma nova guia aberta.
nova_aba = abas_abertas[1]

# Ativando a guia como o contexto atual.
bot.activate_tab(nova_aba)

// Obtendo a lista de manipuladores de guias.
List <String> abas_abertas = getTabs();

// Obtendo o identificador de uma nova guia aberta.
String nova_aba = abas_abertas.get(1);

// ativando a guia como o contexto atual.
activateTab(nova_aba);

Criar guia

Você pode criar uma nova guia e navegar para a URL fornecida.

# Iniciando o navegador.
bot.browse("https://google.com")

# Abrindo uma nova guia no navegador.
bot.create_tab("https://botcity.dev")

// Iniciando o navegador.
browse("https://google.com");

// Abrindo uma nova guia no navegador.
createTab("https://botcity.dev");

Criar janela

Além de criar uma nova aba na mesma janela, também é possível criar uma nova janela com a URL fornecida.

# Iniciando o navegador.
bot.browse("https://google.com")

# Abrindo uma nova janela.
bot.create_window("https://botcity.dev")

// Iniciando o navegador.
browse("https://google.com");

// Abrindo uma nova janela.
createWindow("https://botcity.dev");

Fechar a página

Você pode fechar facilmente a página ativa atual (aba ou janela).

# Fechando o contexto atual.
bot.close_page()

// Fechando o contexto atual.
closePage();