Modo de automação do navegador

A UiPath oferece suporte a vários métodos para automatizar navegadores, cada um adequado para diferentes ambientes de implantação e destinos de navegadores. A configuração do Modo de automação do navegador permite que você escolha qual método usar — seja para um escopo de fluxo de trabalho específico por meio da atividade Use Application/Browser ou como um padrão para todo o projeto em Configurações de projeto moderno de Automação de interface gráfica > Aplicativo/Navegador.

Métodos de automação

A UiPath fornece três métodos de automação subjacentes, expostos como cinco modos:

A Extensão de navegador injeta a extensão da UiPath no navegador para interagir com as páginas da Web diretamente. Requer que a extensão seja instalada, mas fornece a cobertura de automação mais rica e é compatível com todos os quatro principais navegadores suportados: Chrome, Edge, Firefox e Safari.

O WebDriver usa o protocolo W3C WebDriver para abrir e controlar uma sessão de navegador dedicada por meio de um binário de driver específico do navegador (chromedriver, msedgedriver, geckodriver). Funciona sem a extensão UiPath e é compatível com todos os quatro navegadores principais. Uma variante sem periféricos executa o navegador sem uma janela visível.

A Automação do Chromium usa o Protocolo Chrome DevTools (CDP) para controlar navegadores baseados no Chromium diretamente, sem necessidade de download de extensão ou driver. É a mais simples de configurar no Chrome e no Edge. Uma variante sem periféricos também está disponível.

Modos disponíveis

Extensão de navegador

Usa a extensão de navegador da UiPath para automatizar o navegador de destino. A extensão injeta scripts em páginas da web para interagir com a página e relata informações do elemento de volta para o Robô.

• Requer: extensão do navegador UiPath instalada e habilitada no perfil do navegador de destino
• Navegadores compatíveis: Chrome, Edge, Firefox, Safari
• Janela do navegador: Visível

Esse é o modo padrão. Escolha-o para automação padrão attended ou unattended em que o navegador é executado na mesma máquina que o robô e a instalação da extensão for possível.

Observação:

Para automatizar páginas no modo Anônimo (privado), abra chrome://extensions, localize a extensão UiPath e habilite Permitir em navegação anônima e Permitir acesso às URLs de arquivo.

WebDriver com GUI

Abre uma nova sessão de navegador visível controlada pelo protocolo W3C WebDriver. O UiPath se comunica com o navegador por meio de um servidor WebDriver específico do navegador.

• Requer: binário do WebDriver compatível com a versão do navegador instalado
• Navegadores compatíveis: Chrome, Edge, Firefox
• Janela do navegador: Visível

Observação:

O WebDriver cria um novo user-data-dir para cada sessão e não pode se conectar a uma instância do navegador já aberta na área de trabalho do usuário. Isso torna o WebDriver inadequado para a automação Attended. Para automação unattended, isso não é uma limitação.

WebDriver em modo headless

Igual ao WebDriver com GUI, mas o navegador é executado sem uma janela visível.

• Requer: binário do WebDriver compatível com a versão do navegador instalado
• Navegadores compatíveis: Chrome, Edge, Firefox
• Janela do navegador: Nenhuma (sem periféricos)

Observação:

Algumas operações que exigem uma janela visível — como arrastar e soltar nativo ou simulação de mouse de hardware — não são compatíveis no modo sem periféricos.

Como o WebDriver com GUI, esse modo cria um novo user-data-dir e não pode se conectar a um navegador já aberto. Um binário compatível do WebDriver deve ser baixado no runtime. O modo de navegação anônima é compatível sem configuração adicional.

Automação do Chromium

Usa o protocolo Chrome DevTools (CDP) para controlar o navegador diretamente. Nenhuma instalação de extensão ou binário do WebDriver é necessário — a UiPath inicia e gerencia a sessão do navegador internamente.

• Requer: processo de navegador iniciado com o sinalizador --remote-debugging-port=0
• Navegadores compatíveis: Chrome, Edge e todos os navegadores baseados no Chromium
• Janela do navegador: Visível

Escolha este modo para a configuração mais simples no Chrome ou Edge. Não é compatível com o Firefox ou o Safari.

Observação:

A automação do Chromium cria um novo user-data-dir para cada sessão e não pode se conectar a uma instância do navegador já aberta na área de trabalho do usuário. Isso a torna inadequada para automação Attended. Para automação unattended, isso não é uma limitação.

O modo de navegação anônima é compatível sem configuração adicional.

Automação do Chromium em modo headless

Igual ao ChromiumAutomation, mas o navegador é executado sem uma janela visível.

• Requer: processo de navegador iniciado com o sinalizador --remote-debugging-port=0
• Navegadores compatíveis: Chrome, Edge e todos os navegadores baseados no Chromium
• Janela do navegador: Nenhuma (sem periféricos)

Esse modo combina a configuração zero com execução sem periféricos, tornando-o adequado para automação não assistida em servidores ou pipelines de CI/CD.

Observação:

Como a automação do Chromium, esse modo cria um novo user-data-dir e é bloqueado quando a Política de Grupo DeveloperToolsAvailability é definida como 2. O modo de navegação anônima é compatível sem configuração adicional.

Comparação

Requisitos de configuração

O que cada modo depende antes de poder ser executado.

Mode	Extensão necessária	WebDriver necessário	Sem periféricos	Configuração adicional
Extensão de navegador	✅	❌	❌	Instalar extensão UiPath
WebDriver com GUI	❌	✅	❌	Baixar binário do WebDriver
WebDriver em modo headless	❌	✅	✅	Baixar binário do WebDriver
Automação do Chromium	❌	❌	❌	Iniciar navegador com o sinalizador --remote-debugging-port=0
Automação do Chromium em modo headless	❌	❌	✅	Iniciar navegador com o sinalizador --remote-debugging-port=0

Capabilities

O que cada modo suporta durante a execução.

Mode	Automação assistida	Modo anônimo (sem configuração)	Navegadores compatíveis
Extensão de navegador	✅	❌	Chrome, Edge, Firefox, Safari
WebDriver com GUI	❌	✅	Chrome, Edge, Firefox
WebDriver em modo headless	❌	✅	Chrome, Edge, Firefox
Automação do Chromium	❌	✅	Chrome, Edge, baseado no Chromium
Automação do Chromium em modo headless	❌	✅	Chrome, Edge, baseado no Chromium

Escolher um modo

Cenário	Modo recomendado
Automação de área de trabalho padrão, a extensão pode ser instalada	Extensão de navegador
Automação Attended (trabalhar com o navegador já aberto do usuário)	Extensão de navegador
Não é possível instalar a extensão, o navegador precisa estar visível	WebDriver com GUI
Não é possível instalar a extensão sem exibição disponível	WebDriver em modo headless
Chrome ou Edge, configuração mais simples possível	Automação do Chromium
Automação não assistida ou de servidor no Chrome/Edge, sem exibição	Automação do Chromium em modo headless
Firefox ou Safari sem extensão	WebDriver com GUI ou WebDriver em modo headless
DeveloperToolsAvailability Política de grupo restringe ferramentas do desenvolvedor	Extensão de navegador ou WebDriver

Configure o modo

Para uma atividade específica

1. Adicione uma atividade Use Application/Browser ao seu fluxo de trabalho.
2. No painel Propriedades , localize o Modo de automação do navegador.
3. Selecione o modo desejado no menu suspenso.

Resultado: o modo selecionado se aplica a todas as atividades UIAutomation no escopo desse contêiner Use Application/Browser .

Como padrão do projeto

1. Abra as Configurações do projeto no ícone de engrenagem no painel Projeto .
2. Acesse Automação de interface gráfica Moderna > Aplicativo/Navegador.
3. Defina Modo de automação do navegador como seu padrão de preferência.
4. Selecione Salvar.

Resultado: novas atividades Use Application/Browser adicionadas ao projeto usam o modo selecionado, a menos que sejam substituídas em uma atividade específica.

A configuração no nível da atividade tem precedência sobre o padrão do projeto dentro do seu escopo.

Importante:

A propriedade Modo de automação do Navegador para a atividade Use Application/Browser e a configuração do projeto em Automação de Interface Gráfica Moderna > Aplicativo/Navegador estão disponíveis a partir do UIAutomation v26.10.0.

Limitações

• Os modos de Automação do Chromium são compatíveis apenas com navegadores baseados no Chromium. Usá-las com o Firefox ou Safari retorna um erro; não ocorre nenhum fallback automático.
• Os modos sem periféricos não são compatíveis com operações que dependem de uma janela visível ou renderização no nível do sistema operacional, como arrastar e soltar do mouse de hardware ou certas operações de captura de tela.
• O WebDriver e a automação do Chromium criam um novo user-data-dir para cada sessão. Eles não podem se conectar a um navegador já aberto na área de trabalho do usuário, tornando-os inadequados para a automação Attended. Isso não é uma limitação para a automação unattended.
• As sessões do WebDriver e do Chromium Automation usam um perfil de navegador isolado. As extensões, senhas salvas e cookies de sessão do usuário do perfil do navegador padrão estão indisponíveis.
• O WebDriver requer um binário específico do navegador (chromedriver, msedgedriver ou geckodriver) para ser baixado no runtime e mantido compatível com a versão do navegador instalado. A extensão do navegador e a automação do Chromium não têm essa dependência binária externa.
• A automação do Chromium é bloqueada quando a Política de Grupo DeveloperToolsAvailability é definida como 2 (Proibir o uso das Ferramentas de Desenvolvedor). Use a extensão de navegador ou o WebDriver em ambientes em que essa política é aplicada.
• A extensão do navegador requer uma configuração manual adicional para automatizar páginas no modo de navegação anônima: o usuário deve abrir chrome://extensions, localizar a extensão UiPath e habilitar Permitir em navegação anônima e Permitir acesso às URLs de arquivo. O WebDriver e a Automação do Chromium são compatíveis com o modo de navegação anônima sem qualquer configuração adicional.