Ir para o conteúdo

Tela de Exibição

Usando os métodos abaixo, você poderá interagir com a tela.

Obtendo o tamanho da tela e a janela de exibição

Usando o método display size e get viewport size, você pode respectivamente, obter a dimensão da tela (largura e altura) em pixels e a largura e a altura atuais da janela de exibição.

# Definindo uma variável para receber o tamanho da tela.
tamanho_tela = bot.display_size()

# Imprima o tamanho da tela em pixels.
print(tamanho_tela)

# Definindo uma variável para receber o tamanho da viewport.
tamanho_janela_exibição = bot.get_viewport_size()

# Imprima o tamanho da viewport
print(tamanho_janela_exibição)
import org.openqa.selenium.Dimension;

// Definindo uma variável para receber o tamanho da tela.
Dimension tamanhoTela = displaysize ();

// Imprima o tamanho da tela em pixels.
System.out.println(tamanhoTela);

// Definindo uma variável para receber o tamanho da viewport.
Dimension tamanhoJanelaExibição = getViewportSize();

// Imprima o tamanho da viewport contendo a atual a largura e a altura da viewport.
System.out.println(tamanhoJanelaExibição);

Configurando a resolução de tela

Com o método set screen resolution, você poderá configurar as dimensões do navegador.

# Definindo a largura e a altura para abrir o navegador com as dimensões desejadas.
bot.set_screen_resolution(600, 1200)
// Definindo a largura e a altura para abrir o navegador com as dimensões desejadas.
setScreenResolution(600, 1200);

Obtendo uma captura de tela

Com o método get screenshot, é possível fazer uma captura de tela e salvá-la em qualquer diretório passando o caminho como um parâmetro.

# Tire uma captura de tela, salve o arquivo se o caminho for passado e retorne o objeto Image.
bot.get_screenshot(filepath ='meu_screenshot_com_metodo_get_screenshot.png')

Dica

O método possui um parâmetro opcional region que é uma tupla com valores de esquerda(left), superior(top), largura(width) e altura(height) para cortar uma parte da tela. Saiba mais na documentação completa da API.

// Tire uma captura de tela e retorne o objeto MarvinImage.
MarvinImage screen = getScreenshot();

Obtendo uma captura parcial da tela

Como vimos acima, é possível tirar uma captura de tela utilizando a tela inteira como referência. Usando o método screen cut e passando como parâmetro as coordenadas x e y junto com a largura e a altura, somente a área indicada será coletada.

# Capturando parte da tela.
screen_cut = bot.screen_cut(x=702, y=380, width=120, height=80)

# A variável `screen_cut` é o objeto Image retornado da captura de tela.
import dev.botcity.framework.web.Region;

Region region = new Region(702, 380, 120, 80);

// Capturando parte da tela.
MarvinImage screen = screenCut(region);

// A variável `screen` é o objeto MarvinImage retornado da captura de tela.

Salvando uma captura de tela

O método save screenshot tem praticamente a mesma funcionalidade que os métodos get_screenshot e screenshot.

A única diferença é que ele não retorna um objeto de imagem. Ao invés disso, a imagem será salva no disco.

# Tire e salve uma captura de tela.
bot.save_screenshot("screenshot.png")
// Tire e salve uma captura de tela.
saveScreenshot("screenshot.png");

Maximizando a janela do navegador

# Maximize a janela.
bot.maximize_window()
// Maximize a janela.
maximizeWindow();