Regelinställningar
Denna sida ger detaljerad information om varje inställning på skärmen Redigera regel i RedirectWeb-appen.
Alternativ
Typ
Ange alternativet Typ för att styra hur appen hanterar omdirigering. Du kan välja mellan dessa:
- Original (Standard)
- Detta använder traditionella webb-API:er för att styra omdirigering. Dessutom används Tabs-API:et som en fallback.
- I Firefox används WebRequest-API:et för att hantera omdirigering.
- Du kan använda alla alternativ förutom Resurstyper och Begärandemetoder.
- ⚠️ Detta är långsammare än Declarative-typen och kan orsaka extra nätverksbegäranden.
- Detta använder traditionella webb-API:er för att styra omdirigering. Dessutom används Tabs-API:et som en fallback.
- DNR (Experimentell för Safari):
- Denna typ fungerar mycket snabbare än Original-typen eftersom den inte initierar en nätverksbegäran för käll-URL:en.
- Detta gör att du kan ange Resurstyper och Begärandemetoder.
- ⚠️ Du kan inte använda vissa alternativ, såsom Behandling av fångstgrupper och Exkluderade URL-mönster eftersom de ännu inte stöds av DNR-API:et.
- ⚠️ I Safari kan du för närvarande inte inkludera vertikala streck (
|) i ditt reguljära uttrycksmönster. Detaljer - ⚠️ Eftersom Safaris DNR-API fortfarande har vissa problem betraktar vi det fortfarande som en experimentell funktion för Safari. Du hittar listan över alla kända problem här.
Omdirigera från
Alternativet Omdirigera från låter dig ange ett URL-mönster för webbsidor du vill omdirigera från. Du kan välja antingen Wildcard eller Reguljärt uttryck.
Till exempel, om du anger https://example.com/* med Wildcard, matchar det https://example.com/ eller https://example.com/hello.
I alternativet Omdirigera till kan du referera till hela matchningen med $0 eller delmatchningar med $1, $2, ... Kontrollera detaljerna i URL-mönster på denna sida.
Resurstyper
Alternativet Resurstyper låter dig ange kategorier för webbbegäranden, såsom bilder, JavaScript och stilmallar, som regeln ska tillämpas på.
Till exempel, om du ställer in script, kan du omdirigera JavaScript-filerna som laddas av webbsidor.
För närvarande är dessa tillgängliga:
main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other
Standardinställningen är main_frame, vilket är den sida på toppnivå som laddas i en flik.
Kontrollera detaljerna för varje resurstyp i mdn web docs.
Begärandemetoder
Alternativet Begärandemetoder låter dig ställa in mål-HTTP-metoderna för käll-URL:en.
Alla metoder är inställda som standard.
Kontrollera detaljerna för varje metod i mdn web docs.
I Safari är detta alternativ eventuellt inte tillgängligt eftersom Apples implementering för DNR-typen inte verkar hantera det för närvarande. Vi har skickat feedback till Apple som FB14502272.
Målwebbläsare
Alternativet Målwebbläsare låter dig ange vilken webbläsare regeln ska eller inte ska tillämpas på.
- Det finns 2 typer av webbläsare du kan välja:
- Webbläsare du kan välja som standard: Du kan välja Safari, Chrome, Firefox, Edge, Opera, Arc, Brave och Vivaldi som standard. Detta skiljer inte på varianter av samma webbläsare, såsom Safari och Safari Technology Preview.
- Användardefinierade webbläsare: Genom att trycka på knappen Lägg till i popover-fönstret kan du välja vilken webbläsare som helst förutom Safari eller Safari Technology Preview som har RedirectWeb-tillägget installerat.
- Kryssrutan Alla utom valda låter dig rikta in dig på alla webbläsare utom de du har valt.
RedirectWeb kan inte skilja på om webbläsaren är Safari eller Safari Technology Preview eftersom appen kontrollerar tilläggets föräldraprocess för att upptäcka det, men dessa två webbläsare delar samma föräldraprocess (/sbin/launchd).
Omdirigera till
Alternativet Omdirigera till anger en mål-URL som du vill omdirigera till från käll-URL:en som matchades med alternativet Omdirigera från. Du kan också ersätta fångstgrupper med $1, $2, ... eller hela matchningen med $0. Dessa hjälper dig att dynamiskt ange målet. Kontrollera detaljerna i URL-mönster på denna sida.
Till exempel, om du ställer in följande regel:
- Omdirigera från:
https://google.com/*(Wildcard) - Omdirigera till:
https://apple.com/$1
och den matchar https://google.com/hello, så blir mål-URL:en https://apple.com/hello.
Dessutom kan du modifiera texterna i $1, $2, ... innan du gör ersättningar. Se avsnittet Behandling av fångstgrupper för detaljer.
Du kan ange ett anpassat URL-schema för att öppna en app. Här är exempel på appar som stöder djuplänkning:
- Figma:
figma://file/Your_Figma_ID - Firefox:
firefox://open-url?url=https://example.com/hello - Google Chrome:
googlechromes://example.com - Microsoft Edge:
microsoft-edge://example.com - Notion:
notion://www.notion.so/Your_Note_ID - Slack:
slack://open
Program
Om du vill ange en app som du vill öppna mål-URL:en med, använd kombinationsrutan Program. Detta är endast tillgängligt på macOS.
Du kan bara öppna en app som stöder App Sandbox. Se också till att appen stöder att öppna den URL du vill öppna.
Behandling av fångstgrupper
Alternativet Behandling av fångstgrupper låter dig ange hur de fångade grupperna som du kan ersätta i alternativet Omdirigera till med $1, $2... ska bearbetas.
Så här skapar du fångstgrupper:
- Wildcard: Texter som matchas med
*och?fångas automatiskt. - Reguljärt uttryck: Texter som matchas med den del av mönstret som finns inuti
()fångas.
Du kan välja en eller flera av följande processer:
- URL-kodning/avkodning: Detta tillämpar procentkodning eller avkodning på en fångstgrupp. Till exempel, om du kodar
https://example.com/hello, konverteras det tillhttps%3A%2F%2Fexample.com%2Fhello. Avkodning fungerar på motsatt sätt. - Base64-kodning/avkodning: Detta avkodar/kodar en text till Base64. Till exempel kan du koda
hellotillaGVsbG8=och avkoda det tillbaka tillhello. - Ersätt förekomster: Detta ersätter ett eller flera tecken i en grupp, matchat av ett Mål, med en Ersättning. Till exempel, om Grupp är
hellooch Mål ärloch Ersättning äry, ändras det tillheyyo.
Detta är för att bearbeta varje fångstgrupp och det påverkar inte vilka URL:er som exkluderas av Exkluderade URL-mönster. Antag till exempel att du har denna regel:
- Omdirigera från:
https://example.com/(hello.*) - Behandling av fångstgrupper:
- Grupp:
$1 - Mål:
.*(Reguljärt uttryck) - Ersättning:
hello
- Grupp:
- Exkluderat URL-mönster:
https://example.com/hello
I detta fall kommer https://example.com/hello_world inte att exkluderas medan https://example.com/hello kommer att exkluderas.
Exkluderade URL-mönster
Alternativet Exkluderade URL-mönster låter dig ange de URL:er som inte ska omdirigeras. Detta kan vara användbart för att undvika omdirigeringsloopar eller för att exkludera vissa delar av en webbplats från att omdirigeras.
Du kan ange exkluderade URL-mönster med antingen reguljära uttryck eller wildcard-mönstertyper.
Exempel
Alternativet Exempel låter dig testa din omdirigeringsregel genom att ange exempel-URL:er. Genom att lägga till en exempel-URL kan du kontrollera om regeln fungerar som förväntat innan du faktiskt tillämpar den.
Avancerat
- [DNR] Omdirigering av huvudram: Detta alternativ är endast tillgängligt för DNR-typen. Det låter dig ange hur omdirigering för resurstypen
main_frameska hanteras. Tillgängliga alternativ är:- Rå: Omdirigerar huvudramen till den angivna URL:en utan några modifieringar.
- Via mellansida: Omdirigerar huvudramen till en mellansida, som sedan omdirigerar till den angivna mål-URL:en. Detta är användbart för att öppna appar med djuplänkning eftersom mellansidan kan hantera mer komplex omdirigeringslogik.
Kommentarer
Alternativet Kommentarer låter dig lägga till valfria anteckningar eller kommentarer om din omdirigeringsregel. Detta kan vara användbart för att hålla reda på varför du skapade en viss regel eller för att ge sammanhang åt andra som kan se dina regler.
Du kan skriva kommentarer i följande format:
- Oformaterad text (Standard): Enkel text utan någon formatering.
- Markdown: Du kan använda GitHubs Markdown-syntax, inklusive vissa utökningar som GFM inte stöder. Du kan till exempel skapa rubriker, listor, länkar och mer.
- AsciiDoc: Du kan använda AsciiDoc-syntax för att formatera dina kommentarer.
URL-mönster
URL-mönster används för att matcha URL:er i alternativen Omdirigera från, Exkluderade URL-mönster och Behandling av fångstgrupper. För att ange dem kan du välja antingen Wildcard eller Reguljärt uttryck.
Wildcard
Wildcard är en enklare mönstertyp som låter dig använda * (matchar vad som helst) och ? (matchar ett enskilt tecken) som wildcards. Här är några exempel:
- För att matcha
https://example.com/hellokan du användahttps://example.com/*. Detta matchar alla strängar efterhttps://example.com/. - För att matcha
https://example.com/search?q=hellokan du användahttps://example.com/search?q=*. Detta matchar alla värden för parameternq. - För att matcha valfri URL som innehåller ordet
blogkan du använda*blog*.
Du kan också använda ersättning i Wildcard, vilket innebär att du kan referera till delar av den matchade URL:en med $1, $2, etc. Om du till exempel använder https://example.com/*-world-* och URL:en är https://example.com/hello-world-goodbye, skulle $1 vara "hello" och $2 vara "goodbye". $0 är också tillgängligt för att referera till hela den matchade URL:en.
Även om ersättning är en funktion i reguljära uttryck kan du också använda den för Wildcard eftersom RedirectWeb internt konverterar Wildcard till reguljära uttryck.
Reguljärt uttryck
Reguljära uttryck (Regex) är ett kraftfullt verktyg för att matcha mönster i text och används också i stor utsträckning inom programmering. Det låter dig definiera ett specifikt mönster som matchar en uppsättning strängar. Här är några exempel.
- För att matcha
https://example.com/hellokan du användahttps://example.com/.*. Detta matchar alla strängar efterhttps://example.com/. - För att matcha
https://example.com/search?q=hellokan du användahttps://example.com/search\?q=(.*). Detta matchar värdet påq-parametern och sparar det i en fångstgrupp. Du kan sedan referera till det med$1i alternativet Omdirigera till. - För att matcha valfri URL som innehåller ordet
blogkan du använda.*blog.*.
Du kan referera till fångstgrupperna i Omdirigera till eller Ersättning med $1, $2, ... eller $0 för att referera till hela matchningen.
RedirectWeb drivs av Apples Regex-motor.
Mer information om Regex-syntax finns i resurser som RegExr.