Regelindstillinger
Denne side giver detaljerede oplysninger om hver indstilling på skærmen Rediger regel i Redirect Web-appen.
Indstillinger
Type
Angiv Type-indstillingen for at styre, hvordan appen håndterer omdirigering. Du kan vælge mellem disse:
- Original (Standard)
- Denne bruger traditionelle Web API'er til at styre omdirigering. Derudover bruger den Tabs API som en fallback.
- I Firefox bruger den WebRequest API til at håndtere omdirigering.
- Du kan bruge alle indstillingerne bortset fra Ressourcetyper og Anmodningsmetoder.
- Dette er langsommere end Deklarativ-typen og kan forårsage ekstra netværksanmodninger.
- Denne bruger traditionelle Web API'er til at styre omdirigering. Derudover bruger den Tabs API som en fallback.
- DNR (Eksperimentel for Safari):
- Denne type fungerer meget hurtigere end Original-typen, fordi den ikke initierer en netværksanmodning for kilde-URL'en.
- Dette giver dig mulighed for at angive Ressourcetyper og Anmodningsmetoder.
- ⚠️ Du kan ikke bruge nogle indstillinger, såsom Behandling af fangstgrupper og Udelukkede URL-mønstre, da de endnu ikke er understøttet af DNR API'en.
- ⚠️ I Safari kan du i øjeblikket ikke inkludere pipes (
|) i dit regulære udtryksmønster. Detaljer - ⚠️ Da Safaris DNR API stadig har nogle problemer, anser vi det stadig for at være en eksperimentel funktion for Safari. Du kan finde listen over alle kendte problemer her.
Omdiriger fra
Omdiriger fra-indstillingen giver dig mulighed for at angive et URL-mønster for websider, du vil omdirigere fra. Du kan vælge enten Jokertegn eller Regulært udtryk.
For eksempel, hvis du angiver https://example.com/* med Jokertegn, matcher det https://example.com/ eller https://example.com/hello.
I Omdiriger til-indstillingen, Du kan referere til hele matchet ved hjælp af $0 eller delvise matches ved hjælp af $1, $2, ... Kontroller detaljerne i URL-mønster på denne side.
Ressourcetyper
Ressourcetyper-indstillingen lader dig angive kategorierne af webanmodninger, såsom billeder, JavaScripts og typografiark, som reglen gælder for.
For eksempel, hvis du indstiller script, kan du omdirigere JavaScript-filerne, der indlæses af websider.
I øjeblikket er disse tilgængelige:
main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other
Standardindstillingen er main_frame, som er den øverste side, der indlæses i en fane.
Kontroller venligst detaljerne for hver ressourcetype i mdn web docs.
Anmodningsmetoder
Anmodningsmetoder-indstillingen lader dig indstille de målrettede HTTP-metoder for kilde-URL'en.
Alle metoder er indstillet som standard.
Kontroller venligst detaljerne for hver metode i mdn web docs.
I Safari er denne indstilling muligvis ikke tilgængelig, fordi Apples implementering af DNR-typen tilsyneladende ikke håndterer den i øjeblikket. Vi sendte feedback til Apple som FB14502272.
Målbrowsere
Målbrowsere-indstillingen giver dig mulighed for at angive, hvilken browser reglen skal eller ikke skal anvendes på.
- Der er 2 typer browsere, du kan vælge:
- Browsere, du kan vælge som standard: Du kan vælge Safari, Chrome, Firefox, Edge, Opera, Arc, Brave og Vivaldi som standard. Dette differentierer ikke varianter af den samme browser, såsom Safari og Safari Technology Preview.
- Brugerdefinerede browsere: Ved at trykke på knappen Tilføj i popoveren, kan du vælge enhver browser udover Safari eller Safari Technology Preview, der har Redirect Web-udvidelsen installeret.
- Afkrydsningsfeltet Alle undtagen valgte lader dig målrette alle browsere undtagen dem, du har valgt.
Redirect Web kan ikke differentiere, om browseren er Safari eller Safari Technology Preview, fordi appen kontrollerer udvidelsens overordnede proces for at registrere den, men disse to browsere deler den samme overordnede proces (/sbin/launchd).
Omdiriger til
Omdiriger til-indstillingen angiver en destinations-URL, du ønsker at omdirigere til, fra kilde-URL'en, der matcher med Omdiriger fra-indstillingen. Du kan også erstatte fangstgrupper med $1, $2, ... eller hele matchet med $0. Disse hjælper dig med dynamisk at angive destinationen. Kontroller detaljerne i URL-mønster på denne side.
For eksempel, hvis du indstiller følgende regel:
- Omdiriger fra:
https://google.com/*(Jokertegn) - Omdiriger til:
https://apple.com/$1
og det matcher https://google.com/hello, så vil destinations-URL'en være https://apple.com/hello.
Derudover kan du ændre teksterne i $1, $2, ... før du foretager erstatninger. Kontroller afsnittet Behandling af fangstgrupper for detaljer.
Du kan angive et brugerdefineret URL-skema for at åbne en app. Disse er eksempler på apps, der understøtter dybdelinks:
- 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
Applikation
Hvis du vil angive en app, du ønsker at åbne destinations-URL'en med, skal du bruge Applikation-kombinationsboksen. Dette er kun tilgængeligt på macOS.
Du kan kun åbne en app, der understøtter App Sandbox. Sørg også for, at appen understøtter åbning af den URL, du vil åbne.
Behandling af fangstgrupper
Behandling af fangstgrupper-indstillingen giver dig mulighed for at angive, hvordan de fangne grupper, du kan erstatte i Omdiriger til-indstillingen med $1, $2..., skal behandles.
Sådan oprettes fangstgrupper:
- Jokertegn: Tekster, der matcher med
*og?, fanges automatisk. - Regulært udtryk: Tekster, der matcher med en del af mønsteret inden i
(), fanges.
Du kan vælge en eller flere af følgende processer:
- URL-kodning/afkodning: Dette anvender procentkodning eller afkodning på en fangstgruppe. For eksempel, hvis du koder
https://example.com/hello, konverteres det tilhttps%3A%2F%2Fexample.com%2Fhello. Afkodning fungerer på den modsatte måde. - Base64-kodning/afkodning: Dette afkoder/koder en tekst til Base64. For eksempel kan du kode
hellotilaGVsbG8=, og afkode det tilbage tilhello. - Erstat forekomster: Dette erstatter et eller flere tegn i en gruppe, der matches af et Mål, med en Erstatning. For eksempel, hvis Gruppe er
helloog Mål erlog Erstatning ery, ændres det tilheyyo.
Dette er til behandling af hver fangstgruppe, og det påvirker ikke, hvilke URL'er der udelukkes af Udelukkede URL-mønstre. Lad os for eksempel sige, at du har denne regel:
- Omdiriger fra:
https://example.com/(hello.*) - Behandling af fangstgrupper:
- Gruppe:
$1 - Mål:
.*(Regulært udtryk) - Erstatning:
hello
- Gruppe:
- Udelukket URL-mønster:
https://example.com/hello
I dette tilfælde vil https://example.com/hello_world ikke blive udelukket, mens https://example.com/hello vil blive udelukket.
Udelukkede URL-mønstre
Udelukkede URL-mønstre-indstillingen giver dig mulighed for at angive de URL'er, der ikke omdirigeres. Dette kan være nyttigt for at undgå omdirigeringssløjfer eller for at udelukke visse dele af et websted fra at blive omdirigeret.
Du kan angive udelukkede URL-mønstre ved hjælp af enten regulære udtryk eller jokertegnmønstre.
Eksempler
Eksempler-indstillingen giver dig mulighed for at teste din omdirigeringsregel ved at angive eksempel-URL'er. Ved at tilføje en eksempel-URL kan du kontrollere, om reglen fungerer som forventet, før du faktisk anvender den.
Kommentarer
Kommentarer-indstillingen giver dig mulighed for at tilføje noter eller kommentarer om din omdirigeringsregel. Dette kan være nyttigt for at holde styr på, hvorfor du oprettede en specifik regel, eller for at give kontekst til andre, der måtte se dine regler.
Du kan skrive kommentarer i følgende formater:
- Almindelig tekst (Standard): Simpel tekst uden formatering.
- Markdown: Du kan bruge GitHubs Markdown-syntaks, inklusive nogle udvidelser, som GFM ikke understøtter. For eksempel kan du oprette overskrifter, lister, links og mere.
- AsciiDoc: Du kan bruge AsciiDoc-syntaks til at formatere dine kommentarer.
URL-mønster
URL-mønstre bruges til at matche URL'er i indstillingerne Omdiriger fra, Udelukkede URL-mønstre og Behandling af fangstgrupper. For at angive dem kan du vælge enten Jokertegn eller Regulært udtryk.
Jokertegn
Jokertegn er en enklere mønstertype, der giver dig mulighed for at bruge * (matcher alt) og ? (matcher et enkelt tegn) som jokertegn. Her er nogle eksempler:
- For at matche
https://example.com/hello, kan du brugehttps://example.com/*. Dette vil matche enhver streng efterhttps://example.com/. - For at matche
https://example.com/search?q=hello, kan du brugehttps://example.com/search?q=*. Dette vil matche enhver værdi forq-parameteren. - For at matche enhver URL, der indeholder ordet
blog, kan du bruge*blog*.
Du kan også bruge substitution i Jokertegn, hvilket betyder, at du kan referere til dele af den matchede URL ved hjælp af $1, $2 osv. For eksempel, hvis du bruger https://example.com/*-world-*, og URL'en er https://example.com/hello-world-goodbye, så vil $1 være "hello" og $2 være "goodbye". $0 er også tilgængelig for at referere til hele den matchede URL.
Selvom substitution er en funktion af regulære udtryk, kan du også bruge den til Jokertegn, fordi Redirect Web internt konverterer Jokertegn til regulære udtryk.
Regulært udtryk
Regulært udtryk (Regex) er et kraftfuldt værktøj til at matche mønstre i tekst og bruges også bredt i programmering. Det giver dig mulighed for at definere et specifikt mønster, der matcher et sæt strenge. Her er nogle eksempler.
- For at matche
https://example.com/hello, kan du brugehttps://example.com/.*. Dette vil matche enhver streng efterhttps://example.com/. - For at matche
https://example.com/search?q=hello, kan du brugehttps://example.com/search\?q=(.*). Dette vil matche værdien afq-parameteren og gemme den i en fangstgruppe. Du kan derefter referere til den ved hjælp af$1i Omdiriger til-indstillingen. - For at matche enhver URL, der indeholder ordet
blog, kan du bruge.*blog.*.
Du kan referere til fangstgrupperne i Omdiriger til eller Erstatning ved hjælp af $1, $2, ... eller $0 for at referere til hele matchet.
Redirect Web er drevet af Apples Regex-motor.
Mere information om Regex-syntaks kan findes i ressourcer som RegExr.