GUIA DO UTILIZADOR UA PRO

Guia de iniciação

Comece pela primeira regra e conheça âmbitos, modos aleatórios, recurso alternativo e migração da configuração.

Aplica-se à versão: 1.4.5 · Guia atualizado: 16 de novembro de 2026

Este guia abrange a versão 1.4.5. Verifique a versão disponível na fonte de instalação escolhida.

O UA Pro permite definir o User-Agent (UA) para todos os sites, domínios específicos ou um único separador. Escolha primeiro as páginas afetadas por uma regra e depois a forma como o UA é gerado. Quando existem várias regras, a extensão seleciona uma regra da página principal por ordem de prioridade; os recursos comuns da página herdam primeiro o UA da página principal.

01Compreender o UA e os recursos da página

Um UA descreve a identidade que o navegador envia aos sites e inclui normalmente o navegador, o sistema operativo e o dispositivo. O UA Pro pode modificar o User-Agent dos pedidos web comuns e fornecer o valor correspondente para navigator.userAgent nas páginas comuns.

Escolher um UA móvel permite observar o que um site devolve a UAs móveis, mas não transforma um computador num telemóvel nem altera automaticamente o tamanho do ecrã, o motor do navegador, o IP ou a impressão digital completa do navegador.

Suponha que a barra de endereço apresenta https://shop.example.com/product:

Termo Significado neste exemplo
Página principal A página do produto aberta na barra de endereço
Domínio da página principal shop.example.com, sem protocolo nem caminho
Domínio pai Em relação a shop.example.com, example.com é um domínio pai
Subdomínio img.shop.example.com é um subdomínio de shop.example.com
Recursos da página Imagens, scripts, estilos, pedidos API, iframes de rede comuns e outros elementos carregados pela página
Domínio do recurso O domínio de destino de um pedido de recurso, como cdn.example.net

Neste guia, «domínio da página principal» significa o nome de anfitrião da página na barra de endereço. Não é um domínio de primeiro nível como .com, nem necessariamente um domínio registado como example.com.

02Três conceitos de configuração independentes

Definição Pergunta a que responde Exemplos
Âmbito Que páginas usam esta regra? Global, domínio example.com, separador atual
Modo UA De onde vem o conteúdo do UA? UA integrado, personalizado, acrescentar texto, UA aleatório
Modo aleatório Quando se escolhe o modo aleatório, quando é sorteado um novo valor? Em cada carregamento de página, por separador

Por exemplo, «âmbito de domínio + UA aleatório + por separador» significa que cada separador que visita páginas nesse âmbito guarda o seu próprio resultado aleatório para a regra. Não significa que todos os separadores que visitam o domínio partilhem um UA permanente.

2.1 Âmbito

Âmbito O que afeta Duração e relação de substituição
Global Páginas comuns de sites sem uma regra de prioridade superior A configuração é mantida; regras de domínio ou separador podem sobrepor-se
Domínio Páginas cujo domínio principal corresponde ao domínio indicado ou a um dos seus subdomínios A configuração é mantida; regras de domínio mais específicas ou de separador podem sobrepor-se
Separador O separador em que a regra foi criada Prioridade máxima; continua a aplicar-se quando esse separador navega para outros sites e termina quando é fechado

«Âmbito global + aleatório por separador» continua a ser uma regra global; guardar resultados aleatórios separadamente não a transforma numa regra de separador com prioridade máxima.

2.2 Modo UA

Modo Como é gerado o UA Adequado para
UA integrado Escolhe um UA entre navegadores ou dispositivos predefinidos Utilizar rapidamente uma identidade predefinida
Personalizado Usa a cadeia UA completa introduzida Usar um UA específico ou guardar uma lista própria de UAs
Acrescentar texto Adiciona um espaço e o texto indicado após o UA predefinido do navegador Adicionar um identificador ao UA predefinido
UA aleatório Sorteia um UA do conjunto de candidatos selecionado Atribuir valores aleatórios por carregamento de página ou por separador

Acrescentar texto baseia-se no UA predefinido do navegador, não num UA substituído do domínio pai nem no UA global. Por exemplo, se a regra global for um UA personalizado e uma regra de domínio acrescentar MyTest, esse domínio usa «UA predefinido do navegador + espaço + MyTest». As regras não se acumulam.

O conjunto de candidatos aleatórios pode vir de UAs integrados, uma lista personalizada, uma lista de textos a acrescentar ou uma combinação destas fontes; também pode escolher categorias específicas. Os textos a acrescentar são primeiro combinados com o UA predefinido do navegador e depois entram no sorteio. Se o conjunto estiver vazio ou não tiver conteúdo válido, a regra não pode ser uma regra válida da página principal.

03Prioridade das regras da página principal

Regra de separador → regra de domínio válida mais específica → regras de domínios pai, nível a nível → regra global → UA predefinido do navegador.

É usada a primeira regra ativa por esta ordem que consiga produzir um UA válido; as regras seguintes não são combinadas com ela. Não existe prioridade adicional entre modos fixos e aleatórios.

Ordem de verificação Exemplo quando a página principal é news.shop.example.com
1 Regra do separador atual
2 Regra válida para news.shop.example.com
3 Regra válida para shop.example.com
4 Regra válida para example.com
5 Regra global válida
6 Nenhuma das anteriores é válida; usar o UA predefinido do navegador

«Válida» exige duas condições: a regra está ativa e consegue produzir um UA permitido e não vazio. Regras em pausa, UAs não permitidos e conjuntos vazios de candidatos aleatórios são ignorados.

3.1 Correspondência de domínios

Ao definir example.com, as seguintes páginas principais correspondem:

Domínio da página principal Corresponde?
example.com Sim
www.example.com Sim
shop.example.com Sim
a.shop.example.com Sim
otherexample.com Não
example.com.other.net Não
example.net Não

Introduza example.com no campo de domínio; não introduza https://, um caminho, parâmetros de consulta nem uma porta. Atualmente a configuração é por domínio, não por caminho de URL.

A versão 1.4.5 não oferece uma opção para corresponder apenas a esse nome de anfitrião exato e excluir todos os subdomínios. Se quiser afetar apenas o ramo shop.example.com, introduza shop.example.com, mas os respetivos subdomínios continuam incluídos.

Na versão atual, a forma de compatibilidade *.example.com também abrange o próprio example.com e os seus subdomínios, não apenas os subdomínios. Se existirem regras válidas example.com e *.example.com, a primeira tem prioridade; quando está em pausa, a segunda pode assumir. Normalmente, os novos utilizadores só precisam da forma simples do domínio.

3.2 Diferença entre colocar em pausa e remover

Ação ou estado Significado
Pausa Mantém a configuração, mas exclui-a temporariamente da correspondência; pode ser retomada
Remover Elimina a regra; recrie-a se necessário
Substituída A regra continua ativa, mas aplica-se à página atual uma regra de prioridade superior
Inválida O conteúdo atual não consegue produzir um UA válido; corrija o conteúdo ou o conjunto de candidatos

Após colocar uma regra em pausa ou removê-la, a extensão continua à procura de outras regras válidas. Portanto, a pausa não é uma regra de exclusão que obrigue a página a usar o UA predefinido do navegador.

Suponha que as únicas regras ativas e válidas são UA-G global, UA-P para example.com e UA-C para shop.example.com:

Ação Resultado ao abrir shop.example.com
As três regras ativas UA-C
Colocar em pausa a regra do subdomínio UA-P
Colocar também em pausa a regra do domínio pai UA-G
Colocar também em pausa a regra global UA predefinido do navegador
Adicionar uma regra de separador válida UA-T Esse separador usa UA-T

UA-G, UA-P, UA-C e UA-T são apenas etiquetas para diferentes conteúdos de UA.

04Dois modos aleatórios

4.1 Em cada carregamento de página

É sorteado um valor uma vez por cada carregamento completo da página principal pela rede; os recursos comuns da página reutilizam esse resultado. Uma atualização ou navegação completa origina novo sorteio; os pedidos da página, como imagens, APIs e iframes, não originam cada um um novo sorteio da página principal.

Por exemplo, suponha que o conjunto de candidatos contém UA-A, UA-B e UA-C:

Ação Um resultado possível
Abrir a página pela primeira vez O documento principal e os recursos comuns usam UA-A
A página pede depois imagens e APIs Continua UA-A
Muda apenas uma âncora ou uma rota interna de SPA Continua UA-A
Atualizar a página Novo sorteio; pode usar UA-C
Navegar completamente para outra página que ainda corresponde a esta regra Novo sorteio; pode usar UA-B

«Sortear novamente» não significa obter necessariamente um valor diferente. Da mesma forma, quando os botões de voltar ou avançar do navegador repõem diretamente um documento em cache sem novo carregamento do documento principal pela rede, isso não pode ser tratado simplesmente como um novo sorteio.

Nos redirecionamentos, a regra aplicável continua a ser determinada pela página de destino. Na mesma navegação e com a mesma regra, cada passo do redirecionamento não provoca novos sorteios; se o domínio de destino corresponder a outra regra, aplica-se essa regra.

4.2 Por separador

O resultado aleatório é guardado por «regra + separador». Enquanto a configuração não mudar e o separador não for fechado, as atualizações e navegações completas sob a mesma regra continuam a usar esse resultado.

Por exemplo, configure o modo aleatório «por separador» para example.com:

Ação Um resultado possível
O separador 1 abre example.com Esta regra associa UA-A ao separador 1
O separador 1 atualiza ou acede a shop.example.com, sem regra mais específica Continua com UA-A
O separador 2 abre example.com É guardada uma associação para o separador 2; pode ser UA-B ou ainda UA-A
O separador 1 acede a other.net, que não tem regra, e não existe regra global Usa o UA predefinido do navegador
O separador 1 regressa a example.com Repõe o UA-A original desta regra
Fechar o separador 1 e abri-lo novamente A associação original do separador é eliminada e pode ser atribuída novamente

Se existir uma regra shop.example.com separada, mesmo que ambas selecionem o mesmo conjunto de candidatos, continuam a ser regras diferentes e guardam associações aleatórias separadamente. Após alterações aos parâmetros da regra ou à biblioteca de candidatos, ou após reiniciar o navegador, os resultados aleatórios podem ser reatribuídos.

4.3 Combinações de âmbito e modo

A tabela descreve o comportamento depois de uma regra obter a prioridade da página principal. Os modos fixos incluem UA integrado, Personalizado e Acrescentar texto.

Âmbito Modos fixos Aleatório em cada carregamento de página Aleatório por separador
Global As páginas correspondentes usam o UA desta regra Sorteado em cada carregamento da página principal pela rede Cada separador guarda a sua associação para esta regra global
Domínio As páginas do domínio correspondente e dos seus subdomínios usam este UA Sorteado em cada carregamento da página principal pela rede dentro do âmbito correspondente Cada separador guarda a sua associação para esta regra de domínio
Separador Este separador usa este UA, mesmo depois de navegar para outros sites Este separador sorteia em cada carregamento da página principal pela rede Este separador mantém um resultado aleatório fixo para a regra, preservado durante atualizações e navegação entre sites

Em todas as combinações, os recursos comuns da página herdam primeiro o UA da página principal. O modo aleatório determina a duração do valor e não altera a prioridade das regras.

05Recursos da página e alternativa pelo domínio do recurso

5.1 Os recursos herdam primeiro quando a página principal tem uma regra

Suponha que existem estas regras:

  • shop.example.com → UA-Shop.
  • cdn.example.net → UA-CDN.

Ao abrir shop.example.com e a página carregar cdn.example.net/photo.png, a imagem usa UA-Shop. Mesmo que o domínio de destino do recurso tenha uma regra própria, esta não substitui a regra da página principal. Assim, o documento principal e os recursos comuns da página mantêm o mesmo UA.

Se abrir cdn.example.net diretamente na barra de endereço de um novo separador, passa a ser o domínio da página principal e pode corresponder à sua própria regra UA-CDN.

5.2 Quando entra em vigor a opção de alternativa

Alternativa pelo domínio do recurso em «Mais» está desativada por predefinição. É uma opção global independente e aplica-se a todos os modos UA.

Só entra em vigor quando a página principal não tem UA válido de separador, domínio ou global e permite que os recursos procurem uma regra de domínio válida com base no seu próprio domínio de destino. Os domínios dos recursos seguem a mesma lógica: prevalece a regra mais específica e, quando uma regra filha está em pausa, é herdada a regra pai.

A página principal tem um UA válido? Opção O próprio recurso corresponde a uma regra de domínio válida? UA dos recursos comuns
Sim Desativada ou ativada Sim ou não Herda o UA da página principal
Não Desativada Sim ou não UA predefinido do navegador
Não Ativada Sim UA gerado pela regra do domínio do recurso
Não Ativada Não UA predefinido do navegador

Quando a página principal não tem uma regra válida, o respetivo documento principal continua a usar o UA predefinido do navegador; a alternativa dos recursos nunca atribui um valor à página principal. Uma regra global válida também significa que a página principal tem um UA válido, pelo que impede a alternativa de assumir os recursos comuns.

5.3 Exemplo de alternativa

Abra news.example.org sem regra de separador, de domínio da página principal ou global. Existe também cdn.example.net → UA-CDN:

Pedido Alternativa desativada Alternativa ativada
Documento principal news.example.org UA predefinido UA predefinido
API news.example.org/api UA predefinido UA predefinido
cdn.example.net/app.js UA predefinido UA-CDN
img.cdn.example.net/photo.png UA predefinido UA-CDN, herdado da regra do domínio pai do recurso
other.net/font.woff, sem regra correspondente UA predefinido UA predefinido

Se for adicionado um UA-G global, todos os pedidos comuns acima passam a ser regidos pelo UA-G da página principal e o UA-CDN do recurso deixa de assumir.

5.4 Alternativa com modos aleatórios

Modo da regra do domínio do recurso Como é obtido o valor quando a alternativa é permitida
Modos fixos Usa o UA configurado na regra do recurso
Aleatório em cada carregamento de página O resultado é guardado por «este carregamento da página anfitriã + regra do recurso»; os recursos desse carregamento que correspondem à mesma regra partilham-no
Aleatório por separador O resultado é guardado por «separador anfitrião + regra do recurso»; o mesmo separador continua a usá-lo após atualizações

Por exemplo, se cdn.example.net usar um modo aleatório e tanto img.cdn.example.net como js.cdn.example.net o herdarem, ambos partilham essa associação. Se img.cdn.example.net tiver a sua própria regra válida, pertence a outra regra e pode usar um UA diferente.

Outros separadores que visitam o domínio do recurso não substituem as associações aleatórias de recursos já guardadas para a página atual. Ativar a alternativa permite que diferentes regras de recursos na mesma página usem UAs diferentes; se quiser manter uma página comum coerente como um todo, normalmente deixe-a desativada (predefinição).

06Configurar a primeira regra

  1. Abra o site que pretende configurar e clique no ícone UA Pro na barra de ferramentas.
  2. Se estiver disponível, clique no botão para configurar uma regra para o site atual ou crie uma nova regra em «Mais».
  3. Escolha um âmbito: «Separador» para um teste temporário apenas no separador atual, «Domínio» para vários separadores do mesmo site ou «Global» como predefinição para todos os sites.
  4. Se escolheu Domínio, verifique o campo do domínio. Por exemplo, se estiver em www.example.com e quiser incluir shop.example.com, introduza example.com.
  5. Escolha um modo. Em «Integrado», escolha um navegador ou dispositivo; em «Personalizado», introduza um UA completo; em «Acrescentar texto», apenas o texto a acrescentar; em «Aleatório», escolha um conjunto de candidatos e um modo aleatório.
  6. Em «Rever e aplicar», verifique o âmbito e o conteúdo e clique em «Aplicar» ou «Guardar e aplicar». Aguarde a confirmação «Regra guardada e ativada».
  7. Atualize a página web e verifique a regra ativa apresentada no ecrã inicial. As páginas existentes têm de ser atualizadas para que tanto o documento principal como os scripts adotem o novo UA.

Na lista pode editar, colocar em pausa, retomar ou remover regras. Uma regra substituída por outra continua ativa, mas não tem prioridade atualmente; uma regra em pausa não participa na correspondência. Se aparecer um aviso de ausência de UA válido, verifique o conteúdo personalizado ou o conjunto de candidatos aleatórios.

Um UA personalizado deve ser uma única linha de conteúdo válido para um cabeçalho de pedido, sem quebras de linha nem caracteres de controlo. Novos conteúdos personalizados ou textos a acrescentar podem ser guardados numa lista por categoria, para seleção posterior ou utilização como candidatos aleatórios.

07Ativar o painel flutuante de UA

Abra Mais e ative Painel flutuante de UA. Está desativada por predefinição e pode aparecer em páginas HTTP/HTTPS acessíveis.

UA da página: o valor que o JavaScript da página lê de navigator.userAgent.

UA do pedido: o User-Agent observado pelo navegador para este pedido do documento principal.

Isto apresenta o UA da página atual na barra de endereço do navegador. Não inclui o UA de pedidos de imagens, scripts, APIs ou outros recursos, como recursos CDN.

Se ambos os valores estiverem disponíveis e forem exatamente iguais, são apresentados numa linha. Caso contrário, são apresentados separadamente.

Se a janela tiver sido ativada depois de a página carregar, atualize a página para captar o pedido principal. Quando o pedido não está disponível, a janela apresenta esse estado em vez de usar o valor configurado.

Para mover a janela, arraste a pega ou uma etiqueta. Arraste a margem esquerda ou direita para ajustar a largura e a superior ou inferior para ajustar a altura. Faça duplo clique numa margem para repor o tamanho automático apenas nessa dimensão. O botão semicircular ajusta a opacidade do fundo. O botão de fecho desativa a janela em todas as páginas.

Se um User-Agent for comprido, o texto continua automaticamente na linha seguinte numa janela estreita. A janela aumenta em altura quando necessário. Desloque-se dentro da janela se o texto ultrapassar a altura do ecrã. A largura e a altura definidas manualmente mantêm-se até serem repostas.

A janela tenta manter o mesmo tamanho enquanto carrega os valores de uma nova página. Mostra um indicador de carregamento, nunca os valores da página anterior. Uma navegação completa recria a página, pelo que a janela pode desaparecer por instantes.

Alterar uma regra não muda uma página já carregada nem o cabeçalho enviado com o pedido original. Atualize para verificar a nova regra. Um proxy ou servidor pode alterar cabeçalhos dos pedidos após a observação pelo navegador. A janela não pode aparecer em páginas protegidas do navegador nem em lojas de extensões.

O menu Mais também contém Guia para novos utilizadores; clique em UA Pro na parte inferior desse menu para abrir o site.

08Configurar objetivos comuns

Objetivo Como configurar Notas
Experimentar um UA móvel apenas no separador atual Separador + UA móvel integrado Continua a aplicar-se quando o separador visita outros sites; termina ao fechá-lo
Usar um UA fixo em todo um site Domínio example.com + UA integrado ou personalizado Inclui todos os subdomínios e também se aplica a outros separadores
Usar um UA diferente para uma secção de loja Mantenha a regra pai e adicione uma regra shop.example.com Sem uma regra de prioridade superior, a regra filha tem prioridade; quando é colocada em pausa, a regra pai pode assumir
Usar um UA predefinido para todos os sites com uma exceção Defina UA-G globalmente e UA-D no domínio de destino Onde não se aplica outra regra de prioridade superior, o domínio de destino usa UA-D e as restantes páginas usam UA-G
Sortear um UA para um site em cada atualização Domínio + UA aleatório + em cada carregamento de página Os recursos desse carregamento partilham-no; um sorteio pode repetir-se
Manter o UA de um site estável em cada separador Domínio + UA aleatório + por separador Cada regra guarda uma associação separada em cada separador
Definir UAs apenas para recursos externos pelo domínio de destino Crie uma regra de domínio do recurso e ative a alternativa dos recursos A página anfitriã não pode ter UA válido de separador, domínio ou global
Desativar temporariamente uma regra de subdomínio Clique em «Colocar em pausa» A página usa a regra válida restante com maior prioridade, como uma regra de separador, outra regra de domínio correspondente ou a regra global. Se nenhuma se aplicar, usa o UA predefinido do navegador

09Cópia de segurança e migração

As funções de importação e exportação em «Mais» permitem guardar ou migrar regras globais e de domínio, a biblioteca personalizada, a biblioteca de textos a acrescentar e a opção de alternativa pelo domínio do recurso.

As regras de separador e as associações aleatórias já sorteadas não fazem parte desta exportação de configuração persistente. A importação não reconstrói os separadores originais nem o seu estado aleatório.

Pode importar um ficheiro de configuração local ou carregar um endereço de configuração remoto e confirmar a importação. Exporte primeiro uma cópia de segurança. Um objeto fornecido de regra global, regras de domínio, biblioteca personalizada ou biblioteca de textos acrescentados substitui a secção correspondente; secções em falta ou null mantêm os valores existentes. Em particular, uma regra global null não apaga uma regra global existente. A alternativa pelo domínio do recurso só é ativada quando o respetivo campo é true; com qualquer outro valor, incluindo um campo em falta ou null, fica desativada após a importação.

Na versão 1.4.5, o antigo modo aleatório domain é tratado como «Em cada carregamento de página»; as regras aleatórias antigas que não especificam uma estratégia aleatória são tratadas como «Por separador». Após a migração, verifique na interface o modo aleatório necessário.

10Perguntas frequentes e limites de utilização

Pergunta Explicação
Porque continua a página a mostrar o UA antigo logo após guardar? Os documentos existentes não são recarregados; atualize depois de guardar com êxito. Verifique também se uma regra de prioridade superior a substitui
Porque continua a ser usado um UA personalizado depois de colocar a regra filha em pausa? Uma regra de separador válida pode continuar a ter prioridade. Caso contrário, outra regra de domínio correspondente ou a regra global pode assumir. Após alterar a regra, atualize a página e verifique a regra ativa
Porque não funciona a minha regra do domínio do recurso? Verifique primeiro se a página principal já tem um UA válido, depois se a alternativa dos recursos está ativa e, por fim, se a regra do domínio do recurso é válida
Porque não muda o valor aleatório após uma atualização? O modo por separador mantém-no intencionalmente; o modo em cada carregamento também pode voltar a sortear o mesmo valor
Porque têm o mesmo UA os separadores abertos ao mesmo tempo? Os valores aleatórios podem repetir-se; primeiras navegações simultâneas também podem partilhar um valor de reserva sorteado antecipadamente
Porque continua a página a parecer a versão para computador depois de mudar para um UA móvel? Os sites também podem depender do tamanho do ecrã, de Client Hints ou de outras informações; alterar apenas o UA não garante uma disposição diferente

As primeiras navegações simultâneas preservam a navegação nativa do navegador: quando vários separadores novos abrem diretamente um URL ao mesmo tempo e o primeiro pacote é enviado antes da instalação da regra específica, podem usar o mesmo UA sorteado antecipadamente; depois cada separador guarda a sua própria associação. A extensão não acrescenta um intermediário de navegação nem converte os POST nativos de formulários noutro método de navegação.

As páginas HTTP/HTTPS comuns e os seus recursos são o principal alvo desta funcionalidade. Os pedidos de Service Workers partilhados nem sempre podem ser atribuídos a um único separador; a sincronização do UA para Client Hints, navigator em Workers e iframes com documentos sem carregamento de rede não está totalmente implementada nesta versão. A preservação do Server-Timing original de um site também ainda não está implementada nesta alteração. Não considere a modificação do UA uma falsificação completa da impressão digital do navegador.

A versão 1.4.5 usa as permissões webRequest e webNavigation para acompanhar a navegação da página principal e o UA efetivamente enviado. Não usa permissões de bloqueio de pedidos nem de depuração.

11Verificação da versão e referências

O ambiente de verificação final da versão 1.3.0 foi um perfil de teste isolado no Windows Edge 157.0.4341.42 com sites HTTP/HTTPS locais. A execução HTTPS completa passou 128 casos com 2527 asserções; a regressão dos limites HTTP passou 5 casos com 441 asserções. Estes testes verificam as combinações de regras descritas e o limite de concorrência indicado; não significam que todas as versões de navegadores e sites tenham sido abrangidas.

A janela da versão 1.4.5 foi testada em perfis isolados do Chrome e Edge com páginas HTTPS locais. Os testes abrangeram navegação, combinação de UAs idênticos da página e do pedido numa linha, redimensionamento e leituras diferidas. Não abrangem todos os sites.

Os registos detalhados dos testes são mantidos nos materiais do projeto. Verifique a versão instalável na Chrome Web Store ou na página de transferência offline; as versões disponíveis podem diferir deste guia.