ANVÄNDARGUIDE FÖR UA PRO

Kom igång

Börja med din första regel och lär dig om omfattning, slumpningslägen, reservregler för resurser och flytt av konfiguration.

Gäller version: 1.4.5 · Guiden uppdaterad: 16 november 2026

Guiden gäller version 1.4.5. Kontrollera vilken version som finns hos den installationskälla du väljer.

Med UA Pro kan du ange User-Agent (UA) för alla webbplatser, vissa domäner eller en enda flik. Välj först vilka sidor en regel gäller och sedan hur UA-värdet skapas. När flera regler finns väljer tillägget en regel för huvudsidan efter prioritet; vanliga sidresurser ärver först huvudsidans UA.

01Förstå UA och sidans resurser

En UA beskriver den identitet som webbläsaren skickar till webbplatser och innehåller vanligen webbläsare, operativsystem och enhet. UA Pro kan ändra User-Agent i vanliga webbförfrågningar och ge motsvarande värde för navigator.userAgent på vanliga sidor.

En mobil UA låter dig se vad en webbplats returnerar för mobila UA-värden, men förvandlar inte en dator till en telefon och ändrar inte automatiskt skärmstorlek, webbläsarmotor, IP eller webbläsarens fullständiga fingeravtryck.

Anta att adressfältet visar https://shop.example.com/product:

Begrepp Betydelse i detta exempel
Huvudsida Produktsidan som öppnats i adressfältet
Huvudsidans domän shop.example.com, utan protokoll eller sökväg
Överordnad domän I förhållande till shop.example.com är example.com en överordnad domän
Underdomän img.shop.example.com är en underdomän till shop.example.com
Sidresurser Bilder, skript, stilmallar, API-förfrågningar, vanliga nätverksbaserade iframe-ramar och annat som sidan läser in
Resursdomän Måldomänen för en resursförfrågan, till exempel cdn.example.net

I guiden betyder ”huvudsidans domän” värdnamnet för sidan i adressfältet. Det är inte en toppdomän som .com och inte nödvändigtvis en registrerad domän som example.com.

02Tre oberoende inställningsbegrepp

Inställning Fråga den besvarar Exempel
Omfattning Vilka sidor använder regeln? Globalt, domänen example.com, aktuell flik
UA-läge Varifrån kommer UA-innehållet? Inbyggd UA, anpassad, lägg till text, slumpmässig UA
Slumpningsläge När slumpning valts, när dras ett nytt värde? Vid varje sidladdning, per flik

Till exempel betyder ”domänomfattning + slumpmässig UA + per flik” att varje flik som besöker sidor inom domänens omfattning lagrar sitt eget slumpresultat för regeln. Det betyder inte att alla flikar som besöker domänen delar en permanent UA.

2.1 Omfattning

Omfattning Vad som påverkas Livslängd och överordning
Globalt Vanliga webbsidor utan en regel med högre prioritet Konfigurationen sparas; domän- eller flikregler kan ha företräde
Domän Sidor vars huvudsidedomän matchar den angivna domänen eller någon av dess underdomäner Konfigurationen sparas; mer specifika domänregler eller flikregler kan ha företräde
Flik Fliken där regeln skapades Högsta prioritet; gäller även när fliken navigerar till andra webbplatser och upphör när fliken stängs

”Global omfattning + slumpning per flik” är fortfarande en global regel; separat lagring av slumpresultat gör den inte till en högst prioriterad flikregel.

2.2 UA-läge

Läge Hur UA skapas Lämpligt för
Inbyggd UA Väljer en UA bland förinställda webbläsare eller enheter Att snabbt använda en förinställd identitet
Anpassad Använder hela UA-strängen du anger Att använda en viss UA eller spara en egen UA-lista
Lägg till text Lägger till ett blanksteg och angiven text efter webbläsarens standard-UA Att lägga till ett identifierande märke till standard-UA
Slumpmässig UA Drar en UA ur den valda kandidatpoolen Att tilldela slumpvärden per sidinläsning eller flik

Lägg till text utgår från webbläsarens standard-UA, inte en åsidosatt UA för en överordnad domän eller en global UA. Om den globala regeln exempelvis är en anpassad UA och en domänregel lägger till MyTest, använder domänen ”webbläsarens standard-UA + blanksteg + MyTest”. Reglerna staplas inte.

Kandidatpoolen kan komma från inbyggda UA-värden, en anpassad lista, en lista med tilläggstext eller en kombination av dessa; du kan även välja vissa kategorier. Kandidater med tilläggstext kombineras först med webbläsarens standard-UA och ingår sedan i dragningen. Om poolen är tom eller saknar giltigt innehåll kan regeln inte bli en giltig regel för huvudsidan.

03Regelprioritet för huvudsidan

Flikregel → mest specifika giltiga domänregel → överordnade domänregler, nivå för nivå → global regel → webbläsarens standard-UA.

Den första aktiverade regeln i denna ordning som kan skapa en giltig UA används, och senare regler kombineras inte med den. Fasta och slumpmässiga lägen har ingen ytterligare inbördes prioritet.

Kontrollordning Exempel när huvudsidan är news.shop.example.com
1 Aktuell flikregel
2 Giltig regel för news.shop.example.com
3 Giltig regel för shop.example.com
4 Giltig regel för example.com
5 Giltig global regel
6 Inget av ovanstående är giltigt; använd webbläsarens standard-UA

”Giltig” innebär två villkor: regeln är aktiverad och kan skapa en tillåten UA som inte är tom. Pausade regler, otillåtna UA-värden och tomma slumpmässiga kandidatpooler hoppas över.

3.1 Så matchas domäner

När du anger example.com matchar följande huvudsidor:

Huvudsidans domän Matchar?
example.com Ja
www.example.com Ja
shop.example.com Ja
a.shop.example.com Ja
otherexample.com Nej
example.com.other.net Nej
example.net Nej

Ange example.com i domänfältet; ange inte https://, en sökväg, frågeparametrar eller en port. Konfigurationen gäller för närvarande per domän, inte per URL-sökväg.

Version 1.4.5 erbjuder inget alternativ för att matcha endast exakt det värdnamnet och utesluta alla underdomäner. Om du bara vill påverka grenen shop.example.com anger du shop.example.com, men dess underdomäner ingår fortfarande.

Kompatibilitetsformen *.example.com omfattar i den aktuella versionen även själva example.com och dess underdomäner, inte bara underdomänerna. Om både giltiga regler example.com och *.example.com finns har den första företräde; när den pausas kan den andra ta över. Nya användare behöver vanligtvis bara den vanliga domänformen.

3.2 Skillnad mellan att pausa och ta bort

Åtgärd eller tillstånd Betydelse
Pausa Behåller konfigurationen men utesluter den tillfälligt från matchning; kan återupptas
Ta bort Tar bort regeln; skapa den igen vid behov
Åsidosatt Regeln är fortfarande aktiverad, men en regel med högre prioritet gäller för den aktuella sidan
Ogiltig Det aktuella innehållet kan inte skapa en giltig UA; rätta innehållet eller kandidatpoolen

När en regel pausas eller tas bort fortsätter tillägget att söka efter andra giltiga regler. Därför är pausning inte en uteslutningsregel som tvingar sidan att använda webbläsarens standard-UA.

Anta att de enda aktiverade, giltiga reglerna är globalt UA-G, example.com satt till UA-P och shop.example.com till UA-C:

Åtgärd Resultat när shop.example.com öppnas
Alla tre reglerna aktiverade UA-C
Pausa underdomänregeln UA-P
Pausa även den överordnade domänregeln UA-G
Pausa även den globala regeln Webbläsarens standard-UA
Lägg till en giltig flikregel UA-T Den fliken använder UA-T

UA-G, UA-P, UA-C och UA-T är bara beteckningar för olika UA-innehåll.

04Två slumpningslägen

4.1 Vid varje sidladdning

Ett värde dras en gång för varje fullständig nätverksinläsning av huvudsidan; vanliga sidresurser återanvänder resultatet. Uppdatering eller fullständig navigering ger en ny dragning; förfrågningar inom sidan, som bilder, API:er och iframe-ramar, utlöser inte var sin ny dragning för huvudsidan.

Anta att kandidatpoolen innehåller UA-A, UA-B och UA-C:

Åtgärd Ett möjligt resultat
Öppna sidan första gången Huvuddokumentet och vanliga resurser använder UA-A
Sidan begär därefter bilder och API:er Fortfarande UA-A
Bara ett ankare eller en intern SPA-rutt ändras Fortfarande UA-A
Uppdatera sidan Ny dragning; kan använda UA-C
Navigera fullständigt till en annan sida som fortfarande matchar regeln Ny dragning; kan använda UA-B

”Dra igen” betyder inte att värdet nödvändigtvis blir annorlunda. När webbläsarens bakåt- eller framåtknapp återställer ett cachat dokument direkt utan ny nätverksinläsning av huvuddokumentet kan det inte heller bara räknas som en ny dragning.

Vid omdirigering bestäms tillämplig regel fortfarande av målsidan. Inom samma navigering och regel utlöser inte varje omdirigeringssteg upprepade dragningar; om måldomänen matchar en annan regel tillämpas den i stället.

4.2 Per flik

Slumpresultatet lagras per ”regel + flik”. Så länge konfigurationen inte ändras och fliken inte stängs fortsätter uppdateringar och fullständiga navigeringar under samma regel att använda resultatet.

Konfigurera exempelvis slumpning ”per flik” för example.com:

Åtgärd Ett möjligt resultat
Flik 1 öppnar example.com Regeln binder UA-A till flik 1
Flik 1 uppdaterar eller går till shop.example.com, utan mer specifik regel Fortsätter med UA-A
Flik 2 öppnar example.com En bindning lagras för flik 2; den kan vara UA-B eller fortfarande UA-A
Flik 1 går till other.net, som saknar regel, och ingen global regel finns Använder webbläsarens standard-UA
Flik 1 återvänder till example.com Återställer regelns ursprungliga UA-A
Stäng flik 1 och öppna den igen Den ursprungliga flikbindningen rensas och kan tilldelas på nytt

Om en separat regel shop.example.com finns är det fortfarande olika regler som lagrar slumpbindningar separat, även om båda väljer samma kandidatpool. När regelparametrar eller kandidatbiblioteket ändras, eller webbläsaren startas om, kan slumpresultaten tilldelas på nytt.

4.3 Kombinationer av omfattning och läge

Tabellen beskriver beteendet när en regel har fått prioritet för huvudsidan. Fasta lägen omfattar Inbyggd UA, Anpassad och Lägg till text.

Omfattning Fasta lägen Slumpning vid varje sidladdning Slumpning per flik
Globalt Matchande sidor använder regelns UA Dras vid varje nätverksinläsning av huvudsidan Varje flik lagrar sin egen bindning för denna globala regel
Domän Sidor på den matchande domänen och dess underdomäner använder denna UA Dras vid varje nätverksinläsning av huvudsidan inom det matchande området Varje flik lagrar sin egen bindning för denna domänregel
Flik Denna flik använder denna UA även efter navigering till andra webbplatser Denna flik drar ett värde vid varje nätverksinläsning av huvudsidan Denna flik behåller ett fast slumpresultat för regeln även vid uppdateringar och navigering mellan webbplatser

I alla kombinationer ärver vanliga sidresurser först huvudsidans UA. Slumpningsläget avgör värdets livslängd och ändrar inte regelprioriteten.

05Sidresurser och reservregel för resursdomän

5.1 Resurser ärver först när huvudsidan har en regel

Anta att följande regler finns:

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

När du öppnar shop.example.com och sidan läser in cdn.example.net/photo.png, använder bilden UA-Shop. Även om resursens måldomän har en egen regel åsidosätter den inte huvudsidans regel. Därmed använder huvuddokumentet och vanliga sidresurser samma UA.

Om du öppnar cdn.example.net direkt i adressfältet i en ny flik är den då huvudsidans domän och kan matcha sin egen UA-CDN-regel.

5.2 När reservomkopplaren gäller

Reservregel för resursens domän under ”Mer” är avstängd som standard. Det är en oberoende global omkopplare som gäller alla UA-lägen.

Den gäller bara när huvudsidan saknar giltig flik-, domän- eller global UA och låter resurser söka en giltig domänregel utifrån sin egen måldomän. Resursdomäner följer samma logik: den mer specifika regeln har företräde och när en underordnad regel är pausad ärvs den överordnade.

Har huvudsidan en giltig UA? Omkopplare Matchar resursen själv en giltig domänregel? UA för vanliga resurser
Ja Av eller på Ja eller nej Ärver huvudsidans UA
Nej Av Ja eller nej Webbläsarens standard-UA
Nej På Ja UA som genereras av resursdomänregeln
Nej På Nej Webbläsarens standard-UA

När huvudsidan saknar giltig regel använder dess huvuddokument fortfarande webbläsarens standard-UA; resursreservregeln tilldelar aldrig huvudsidan ett värde i gengäld. En giltig global regel räknas också som att huvudsidan har en giltig UA och hindrar därmed reservregeln från att ta över vanliga resurser.

5.3 Exempel på reservregel

Öppna news.example.org utan flikregel, domänregel för huvudsidan eller global regel. Det finns också cdn.example.net → UA-CDN:

Förfrågan Reservregel av Reservregel på
news.example.org huvuddokument Standard-UA Standard-UA
news.example.org/api API Standard-UA Standard-UA
cdn.example.net/app.js Standard-UA UA-CDN
img.cdn.example.net/photo.png Standard-UA UA-CDN, ärvd från resursens överordnade domänregel
other.net/font.woff, ingen matchande regel Standard-UA Standard-UA

Om en global UA-G läggs till styrs alla vanliga förfrågningar ovan av huvudsidans UA-G och resursens UA-CDN tar inte längre över.

5.4 Reservregel med slumpningslägen

Resursdomänregelns läge Hur värdet erhålls när reservregeln tillåts
Fasta lägen Använder UA som angetts i resursregeln
Slumpning vid varje sidladdning Resultatet lagras per ”denna inläsning av värdsidan + resursregel”; resurser under den inläsningen som matchar samma regel delar det
Slumpning per flik Resultatet lagras per ”värdflik + resursregel”; samma flik fortsätter använda det efter uppdatering

Om exempelvis cdn.example.net använder ett slumpningsläge och både img.cdn.example.net och js.cdn.example.net ärver det, delar de bindningen. Om img.cdn.example.net har en egen giltig regel hör den till en annan regel och kan använda en annan UA.

Andra flikar som besöker resursdomänen skriver inte över de slumpmässiga resursbindningar som redan lagrats för den aktuella sidan. När reservregeln aktiveras kan olika resursregler på samma sida använda olika UA-värden; om du vill att en vanlig sida ska vara konsekvent som helhet bör den normalt vara avstängd (standard).

06Skapa din första regel

  1. Öppna webbplatsen du vill konfigurera och klicka på UA Pro-ikonen i verktygsfältet.
  2. Klicka, om knappen finns, på knappen för att ange en regel för den aktuella webbplatsen, eller skapa en ny regel via ”Mer”.
  3. Välj omfattning: ”Flik” för ett tillfälligt test bara i aktuell flik, ”Domän” för flera flikar på samma webbplats eller ”Alla webbplatser” som standard för alla webbplatser.
  4. Om du valde Domän, kontrollera domänfältet. Om du exempelvis är på www.example.com och vill inkludera shop.example.com, anger du example.com.
  5. Välj läge. För ”Inbyggd” väljer du en webbläsare eller enhet; för ”Anpassad” anger du en fullständig UA; för ”Lägg till text” anger du bara texten som ska läggas till; för ”Slumpmässig” väljer du en kandidatpool och ett slumpningsläge.
  6. Kontrollera omfattning och innehåll under ”Granska och tillämpa” och klicka på ”Tillämpa” eller ”Spara och tillämpa”. Vänta på bekräftelsen ”Regel sparad och aktiverad”.
  7. Uppdatera webbsidan och kontrollera den aktuella regeln på startskärmen. Befintliga sidor måste uppdateras innan både huvuddokumentet och skripten använder den nya UA:n.

I regellistan kan du redigera, pausa, återuppta eller ta bort regler. En regel som åsidosätts av en annan förblir aktiverad men har inte prioritet just nu; en pausad regel deltar inte i matchningen. Kontrollera det anpassade innehållet eller kandidatpoolen om en varning om saknad giltig UA visas.

En anpassad UA bör bestå av en enda rad med giltigt innehåll för en begärandeheader, utan radbrytningar eller styrtecken. Nytt anpassat innehåll eller tilläggstext kan sparas i en lista per kategori, för senare val eller användning som slumpkandidater.

07Aktivera den flytande UA-panelen

Öppna Mer och aktivera Flytande UA-panel. Fönstret är avstängt som standard och kan visas på tillgängliga HTTP/HTTPS-sidor.

Sidans UA: värdet som sidans JavaScript läser från navigator.userAgent.

Begärans UA: User-Agent som webbläsaren observerade för denna begäran om huvuddokumentet.

Detta visar UA för den aktuella sidan i webbläsarens adressfält. Det omfattar inte UA för begäranden om bilder, skript, API:er eller andra resurser, såsom CDN-resurser.

Om båda värdena är tillgängliga och exakt lika visas de på en rad. Annars visas de separat.

Om fönstret aktiverades efter att sidan lästs in, uppdatera sidan för att fånga dess huvudbegäran. När begäran inte är tillgänglig visar fönstret detta i stället för att använda det konfigurerade värdet.

Flytta fönstret genom att dra i handtaget eller en etikett. Dra vänster eller höger kant för att justera bredden och över- eller underkanten för att justera höjden. Dubbelklicka på en kant för att återställa automatisk storlek bara för den dimensionen. Halvcirkelknappen justerar bakgrundens opacitet. Stängningsknappen stänger av fönstret på alla sidor.

Om en User-Agent är lång fortsätter texten automatiskt på nästa rad i ett smalt fönster. Fönstret blir högre vid behov. Rulla inne i fönstret om texten är högre än skärmen. Manuellt angiven bredd och höjd behålls tills de återställs.

Fönstret försöker behålla samma storlek medan värden för en ny sida laddas. Det visar en laddningsindikator, aldrig den föregående sidans värden. En fullständig navigering skapar sidan på nytt, så fönstret kan försvinna kortvarigt.

Att ändra en regel ändrar inte en redan inläst sida eller headern som skickades med dess ursprungliga begäran. Uppdatera för att kontrollera den nya regeln. En proxy eller server kan ändra förfrågningsheaders efter att webbläsaren observerat dem. Fönstret kan inte visas på skyddade webbläsarsidor eller i butiker för webbläsartillägg.

Menyn Mer innehåller också Användarguide; klicka på UA Pro längst ned i menyn för att öppna webbplatsen.

08Konfigurera vanliga mål

Mål Så ställer du in det Anmärkningar
Prova en mobil UA endast i aktuell flik Flik + inbyggd mobil UA Gäller även när fliken går till andra webbplatser; upphör när den stängs
Använd en fast UA för en hel webbplats Domän example.com + inbyggd eller anpassad UA Inkluderar alla underdomäner och gäller även andra flikar
Använd en annan UA för en butiksdel Behåll den överordnade regeln och lägg till en regel för shop.example.com Utan en regel med högre prioritet har den underordnade regeln företräde; när den pausas kan den överordnade regeln ta över
Använd en standard-UA för alla webbplatser med ett undantag Ange UA-G globalt och UA-D för måldomänen Där ingen annan regel med högre prioritet gäller använder måldomänen UA-D och andra sidor UA-G
Välj en slumpmässig UA för en webbplats vid varje uppdatering Domän + slumpmässig UA + vid varje sidladdning Resurser i den inläsningen delar värdet; en dragning kan upprepas
Behåll UA för en webbplats stabil i varje flik Domän + slumpmässig UA + per flik Varje regel lagrar en separat bindning i varje flik
Ange UA-värden bara för externa resurser efter måldomän Skapa en resursdomänregel och aktivera reservregel för resurser Värdsidan får inte ha en giltig flik-, domän- eller global UA
Inaktivera en underdomänregel tillfälligt Klicka på ”Pausa” Sidan använder den återstående giltiga regeln med högst prioritet, till exempel en flikregel, en annan matchande domänregel eller den globala regeln. Om ingen gäller använder den webbläsarens standard-UA

09Säkerhetskopiering och flytt

Import och export under ”Mer” kan säkerhetskopiera eller flytta globala regler, domänregler, det anpassade biblioteket, biblioteket med tilläggstext och omkopplaren för resursdomänens reservregel.

Flikregler och redan dragna slumpbindningar ingår inte i denna export av beständig konfiguration. Importen återskapar inte de ursprungliga flikarna eller deras slumptillstånd.

Du kan importera en lokal konfigurationsfil eller läsa in en fjärradress för konfiguration och bekräfta importen. Exportera först en säkerhetskopia. Ett angivet objekt för global regel, domänregler, anpassat bibliotek eller bibliotek med tilläggstext ersätter motsvarande avsnitt; saknade avsnitt eller avsnitt med null lämnar befintliga värden oförändrade. En global regel med null raderar särskilt inte en befintlig global regel. Reservregel för resursens domän är aktiverad bara när fältet är true; vid alla andra värden, inklusive saknat fält eller null, är den av efter importen.

I 1.4.5 behandlas det äldre slumpningsläget domain som ”Vid varje sidladdning”; äldre slumpregler utan angiven slumpstrategi behandlas som ”Per flik”. Kontrollera önskat slumpningsläge i gränssnittet efter flytten.

10Vanliga frågor och användningsbegränsningar

Fråga Förklaring
Varför visar sidan fortfarande den gamla UA:n direkt efter att jag sparat? Befintliga dokument läses inte in på nytt; uppdatera efter att sparandet lyckats. Kontrollera även om en regel med högre prioritet åsidosätter den
Varför används en anpassad UA fortfarande efter att jag pausat den underordnade regeln? En giltig flikregel kan fortfarande ha företräde. Annars kan en annan matchande domänregel eller den globala regeln ta över. Uppdatera sidan efter regeländringen och kontrollera den aktiva regeln
Varför fungerar inte min resursdomänregel? Kontrollera först om huvudsidan redan har en giltig UA, sedan om reservregeln för resurser är på och till sist om resursdomänregeln är giltig
Varför ändras inte slumpvärdet efter en uppdatering? Läget per flik behåller det avsiktligt; läget vid varje sidinläsning kan också dra samma värde igen
Varför har flikar som öppnas samtidigt samma UA? Slumpvärden kan upprepas; samtidiga första navigeringar kan också dela ett reservvärde som dragits i förväg
Varför ser sidan fortfarande ut som datorversionen efter byte till en mobil UA? Webbplatser kan också använda skärmstorlek, Client Hints eller annan information; enbart byte av UA garanterar inte en annan sidlayout

Samtidiga första navigeringar bevarar webbläsarens inbyggda navigering: när flera nya flikar öppnar en URL direkt samtidigt och det första paketet skickas innan den särskilda regeln installeras kan de använda samma UA som dragits i förväg; därefter lagrar varje flik sin egen bindning. Tillägget lägger inte till någon navigeringsförmedling och ändrar inte inbyggda formulär-POST till en annan navigeringsmetod.

Vanliga HTTP/HTTPS-sidor och deras resurser är huvudmålet för funktionen. Förfrågningar från delade Service Workers kan inte alltid hänföras till en enda flik; UA-synkronisering för Client Hints, navigator i Workers och iframe-ramar med dokument utan nätverksinläsning är inte fullständigt implementerad i denna version. Att bevara en webbplats ursprungliga Server-Timing är inte heller implementerat i denna ändring. Betrakta inte UA-ändring som fullständig förfalskning av webbläsarens fingeravtryck.

Version 1.4.5 använder behörigheterna webRequest och webNavigation för att följa huvudsidans navigering och den UA som faktiskt skickats. Den använder varken behörighet att blockera förfrågningar eller felsökningsbehörighet.

11Versionskontroll och referenser

Den slutliga verifieringsmiljön för 1.3.0 var en isolerad testprofil i Windows Edge 157.0.4341.42 med lokala HTTP/HTTPS-webbplatser. Den fullständiga HTTPS-körningen klarade 128 fall med 2527 assertioner; HTTP-gränsregressionen klarade 5 fall med 441 assertioner. Dessa verifierar regelkombinationerna ovan och den angivna samtidighetsgränsen; det innebär inte att alla webbläsarversioner och webbplatser täckts.

Fönstret i version 1.4.5 testades i isolerade Chrome- och Edge-profiler med lokala HTTPS-sidor. Testerna omfattade navigering, sammanfogning av identiska sid- och begärans-UA på en rad, storleksändring och fördröjd avläsning. De täcker inte alla webbplatser.

Detaljerade testprotokoll finns i projektmaterialet. Kontrollera den installerbara versionen i Chrome Web Store eller på nedladdningssidan för offlineinstallation; tillgängliga versioner kan skilja sig från guiden.