Integrando a extensão ao Selenium usando Node.js

Neste tutorial, mostraremos como integrar a extensão do navegador usando a biblioteca Selenium WebDriver e realizar tarefas automatizadas em um site específico.

Etapa 1: Instalação

1. Instale o Node.js e o npm (Node.js Package Manager) no seu computador. Você pode baixá-los no site oficial do Node.js.

2. Instale os pacotes necessários usando o npm:

npm install selenium-webdriver

Etapa 2: Alterando os parâmetros da extensão

Antes de iniciar a automação com a extensão, você precisa adicionar as configurações iniciais. É necessário adicionar clientKey ao arquivo defaultSettings.json.

Para isso, você deve baixar o arquivo da extensão.

Descompacte a extensão e, na raiz do arquivo descompactado, haverá um arquivo defaultSettings.json onde você pode alterar as configurações. Aqui você pode encontrar a descrição dos parâmetros.

Depois que as configurações forem alteradas com sucesso, você precisará compactá-lo novamente em um arquivo .zip.

Etapa 3: Configurando o Selenium WebDriver para funcionar com a extensão

Agora configure o Selenium WebDriver para usar o perfil do navegador criado.

Para fazer isso, crie um arquivo index.js com o seguinte conteúdo:

const { Builder, By, Key, until } = require('selenium-webdriver');
const chrome = require('selenium-webdriver/chrome');
const path = require('path');

(async function example() {
  // Caminho para o arquivo .zip da extensão
  const extensionPath = path.resolve(__dirname, './extension.zip');

  // Criando um objeto de opções do navegador
  const options = new chrome.Options();
  
  // Adicionando a extensão às opções do navegador
  options.addExtensions(extensionPath);

  // Criando uma instância do driver do navegador
  const driver = new Builder()
    .forBrowser('chrome')
    .setChromeOptions(options)
    .build();

  try {
    // Abrir a página do Google
    await driver.get('https://google.com/');
    
    // Exemplo: encontrar um elemento na página e interagir com ele
    const searchBox = await driver.findElement(By.name('q'));
    await searchBox.sendKeys('Selenium com extensão', Key.RETURN);
    
    // Aguardar os resultados da pesquisa
    await driver.wait(until.titleContains('Selenium com extensão'), 5000);
  } finally {
    // Fechar o navegador
    await driver.quit();
  }
})();

Etapa 4: Escrevendo ações automatizadas

Agora que a extensão do navegador está configurada, você pode usar os métodos do WebDriver para realizar ações automatizadas no seu site.

Exemplo de uma ação automatizada:

// Se você quiser clicar em um elemento na página
driver.findElement(By.xpath("//button[@id='my-button']")).click();

Etapa 5: Executando o script

Para executar nosso script automático, que abrirá o navegador e realizará as ações mencionadas acima, você precisa escrever no console:

node index.js

Para atualizar a extensão sem perda de dados, você precisa copiar todas as configurações e dados da versão antiga, baixar a nova versão da extensão, descompactá-la e substituir a versão antiga pela nova.

Esperamos que este guia tenha sido útil para você. Se tiver alguma dúvida, consulte a documentação oficial do Selenium e a documentação do seu navegador.