Pular para o conteúdo principal
Docs
Acessar Studio
Runner
Painel de Administrador

Gerenciador de Chromium

Gerenciador de Chromium

O Gerenciador de Chromium permite instalar, gerenciar e selecionar a versão do Chromium que o Runner utilizará para as automações web. Isso é útil quando você precisa de uma versão específica do navegador para garantir compatibilidade com determinados sites ou sistemas.

Visão geral da tela​

A aba exibe:

  • Versão ativa — a versão do Chromium atualmente em uso (ou "Nenhuma versão ativa" se nenhuma foi selecionada)
  • Tabela de versões instaladas — lista todas as versões do Chromium baixadas no Runner
  • Substituir caminho do Chrome — opção para usar o Chromium gerenciado no lugar do Chrome instalado no sistema

Instalando uma nova versão​

  1. Clique em Instalar nova versão.
  2. No modal que abrir, selecione o ano da versão desejada.
  3. Aguarde o carregamento das versões disponíveis e selecione a versão específica no segundo dropdown.
  4. Clique em Baixar.
  5. Acompanhe o progresso da instalação pela barra de progresso e o indicador de MB baixados.
  6. Ao concluir, a mensagem "Download concluído com sucesso!" será exibida.
Versões já instaladas

Versões que já foram baixadas aparecem marcadas com o badge (Instalada) no dropdown de seleção. Você pode ter múltiplas versões instaladas ao mesmo tempo.

Definindo a versão ativa​

A versão ativa é a que o Runner usará por padrão nas automações web.

  1. Na tabela de versões instaladas, localize a versão desejada.
  2. Clique no botão de seleção (rádio) à esquerda da linha.

A versão selecionada passa a ser exibida como Versão ativa do Chromium no topo da aba.

Substituir caminho do Chrome​

Por padrão, o Runner pode usar o Chrome instalado no sistema operacional para as automações. Ao ativar Substituir caminho do Chrome, o Runner passa a usar exclusivamente a versão do Chromium selecionada no gerenciador — ignorando o Chrome do sistema.

Isso é recomendado quando:

  • Você precisa de uma versão específica do navegador para garantir compatibilidade
  • O Chrome do sistema foi atualizado e causou quebra em automações existentes
  • O ambiente não possui Chrome instalado

Para ativar:

  1. Selecione uma versão ativa na tabela.
  2. Ative o toggle Substituir caminho do Chrome.
Sem versão ativa selecionada

Se você ativar a substituição sem ter uma versão ativa, o Runner exibirá um aviso e as automações de navegador podem falhar. Selecione uma versão ativa antes de ativar esta opção.

Reinstalando ou removendo uma versão​

Na tabela de versões instaladas, cada linha possui dois botões de ação:

  • Reinstalar — baixa novamente a mesma versão. Útil se a instalação estiver corrompida. Requer confirmação.
  • Remover — exclui a versão do Chromium da máquina. Requer confirmação.
Removendo a versão ativa

Se você remover a versão que está definida como ativa, o Runner ficará sem uma versão do Chromium configurada. Defina outra versão como ativa ou reinstale a versão removida para continuar usando automações de navegador.

Cancelando um download​

Durante o download de uma nova versão, o botão Cancelar download fica disponível. Clique nele para interromper a instalação em andamento.

Solução de problemas​

Erro ao buscar versões (firewall bloqueando o download)​

Firewalls corporativos — especialmente o FortiGate — podem interceptar as requisições HTTPS do gerenciador e impedir o download de versões do Chromium. O sintoma é a mensagem "Erro ao buscar versões para [ano]" exibida no modal de instalação, mesmo após o bypass do Roberty ter sido liberado no firewall.

Nesses ambientes, o firewall realiza inspeção SSL com um certificado próprio, e o Node.js não confia nesse certificado por padrão. A solução é informar o certificado raiz da empresa ao Node.js via variável de ambiente.

Como resolver:

  1. Obtenha o Certificado A1 (certificado raiz do firewall) com o time de TI e converta-o para uma das extensões compatíveis: .crt, .cer ou .pem.
  2. Salve o certificado em um caminho fixo na máquina (ex.: C:\certs\empresa.crt).
  3. Abra as Variáveis de Ambiente do Windows:
    • Clique com o botão direito em Este Computador → Propriedades → Configurações avançadas do sistema → Variáveis de Ambiente.
  4. Em Variáveis do sistema, clique em Novo e adicione:
    • Nome: NODE_EXTRA_CA_CERTS
    • Valor: caminho completo para o certificado (ex.: C:\certs\empresa.crt)
  5. Clique em OK e reinicie o Runner.
dica

Após configurar a variável, tente buscar as versões novamente. O gerenciador passará a confiar no certificado do firewall e conseguirá listar e baixar as versões do Chromium normalmente.

Antivírus removendo arquivos do Chromium​

O antivírus — incluindo o Windows Defender — pode excluir o arquivo chrome_elf.dll ou outros arquivos críticos do Chromium, impedindo a inicialização do navegador. Quando isso acontece, o robô apresenta o seguinte erro:

Error: Could not connect to the Chrome DevTools Protocol (CDP) debugger after 30000ms.

Você pode confirmar o problema tentando abrir manualmente o executável do Chromium na pasta do Runner — se ele não abrir, o antivírus provavelmente removeu algum arquivo essencial.

Como resolver — exemplo no Windows Defender:

  1. Abra a Segurança do Windows e clique em Proteção contra vírus e ameaças.
  2. Em Configurações de proteção contra vírus e ameaças, clique em Gerenciar configurações.
  3. Role a página até a seção Exclusões e clique em Adicionar ou remover exclusões.
  4. Localize o caminho da pasta do Chromium do seu usuário:
    • Pressione Win + R
    • Digite %appdata%\roberty-v4\vendor\chromium e pressione Enter
    • Copie o caminho completo que aparece na barra de endereços do Explorer (ex.: C:\Users\seuUsuario\AppData\Roaming\roberty-v4\vendor\chromium)
  5. De volta em Exclusões, clique em Adicionar uma exclusão → Pasta e cole o caminho copiado.
Reinstale após configurar a exclusão

Após adicionar a exclusão, use a opção Reinstalar na tabela de versões para baixar novamente os arquivos que possam ter sido removidos pelo antivírus.

Próximos passos​