Regelindstillinger

Denne side giver detaljerede oplysninger om hver indstilling i skærmbilledet Rediger regel i RedirectWeb-appen.

Indstillinger

Type

Angiv indstillingen Type for at styre, hvordan appen håndterer omdirigering. Du kan vælge mellem disse:

• Original (Standard)
  • Dette bruger traditionelle Web API'er til at styre omdirigering. Derudover bruger det Tabs API som fallback.
    • I Firefox bruger det WebRequest API til at håndtere omdirigering.
  • Du kan bruge alle indstillinger undtagen Ressourcetyper og Anmodningsmetoder.
  • ⚠️ Dette er langsommere end Declarative-typen og kan forårsage ekstra netværksanmodninger.
• DNR (Eksperimentelt for Safari):
  • Denne type fungerer meget hurtigere end Original-typen, fordi den ikke starter en netværksanmodning for kilde-URL'en.
  • Dette giver dig mulighed for at angive Ressourcetyper og Anmodningsmetoder.
  • ⚠️ Du kan ikke bruge visse indstillinger, såsom Behandling af fangstgruppe og Ekskluderede URL-mønstre, da de endnu ikke understøttes af DNR API'et.
  • ⚠️ I Safari kan du i øjeblikket ikke inkludere pipes (|) i dit regulære udtryk. Detaljer
  • ⚠️ Da Safaris DNR API still har visse 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

Indstillingen Omdiriger fra giver dig mulighed for at angive et URL-mønster for de websider, du ønsker at omdirigere fra. Du kan vælge enten Wildcard eller Regulært udtryk.

For eksempel, hvis du angiver https://example.com/* med Wildcard, vil det matche https://example.com/ eller https://example.com/hello.

note

I indstillingen Omdiriger til kan du referere til hele matchet ved hjælp af $0 eller delvise match ved hjælp af $1, $2, ... Tjek detaljerne i URL-mønster på denne side.

Ressourcetyper

Indstillingen Ressourcetyper lader dig angive kategorierne for netværksanmodninger, såsom billeder, JavaScript og typografiark, som reglen gælder for. For eksempel, hvis du indstiller script, kan du omdirigere de JavaScript-filer, der indlæses af websider.

I øjeblikket er følgende tilgængelige: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Standardindstillingen er main_frame, som er siden på øverste niveau indlæst i en fane.

Tjek venligst detaljerne for hver ressourcetype i mdn web docs.

Anmodningsmetoder

Indstillingen Anmodningsmetoder lader dig angive HTTP-metoderne for kilde-URL'en.

Alle metoder er valgt som standard.

Tjek venligst detaljerne for hver metode i mdn web docs.

warning

I Safari er denne indstilling muligvis ikke tilgængelig, fordi Apples implementering af DNR-typen ikke ser ud til at håndtere det i øjeblikket. Vi har sendt feedback til Apple som FB14502272.

Målbrowser

Indstillingen Målbrowser giver dig mulighed for at angive, hvilke browsere reglen skal eller ikke skal anvendes på.

• Der er 2 typer browsere, du kan vælge imellem:
  • Browsere, du kan vælge som standard: Du kan som standard vælge Safari, Chrome, Firefox, Edge, Opera, Arc, Brave og Vivaldi. Dette skelner ikke mellem 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 RedirectWeb-udvidelsen installeret.
• Afkrydsningsfeltet Alle undtagen valgte lader dig målrette mod alle browsere undtagen dem, du har valgt.

warning

RedirectWeb kan ikke skelne mellem, om browseren er Safari eller Safari Technology Preview, fordi appen tjekker udvidelsens overordnede proces for at registrere det, men disse to browsere deler den samme overordnede proces (/sbin/launchd).

Omdiriger til

Indstillingen Omdiriger til angiver en destinations-URL, som du ønsker at omdirigere til fra kilde-URL'en matchet med indstillingen Omdiriger fra. Du kan også erstatte fangstgrupper med $1, $2, ... eller hele matchet med $0. Dette hjælper dig med dynamisk at angive destinationen. Tjek detaljerne i URL-mønster på denne side.

For eksempel, hvis du indstiller følgende regel:

• Omdiriger fra: https://google.com/* (Wildcard)
• Omdiriger til: https://apple.com/$1

og den matcher https://google.com/hello, vil destinations-URL'en være https://apple.com/hello.

Derudover kan du ændre teksterne i $1, $2, ... før du foretager udskiftninger. Tjek afsnittet Behandling af fangstgruppe for yderligere detaljer.

tip

Du kan angive et brugerdefineret URL-skema for at åbne en app. Her er eksempler på apps, der understøtter dybe links:

• Figma: figma://file/Dit_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/Dit_Note_ID
• Slack: slack://open

Program

Hvis du ønsker at angive en app, som du vil åbne destinations-URL'en i, skal du bruge rullemenuen Program. Dette er kun tilgængeligt på macOS.

warning

Du kan kun åbne en app, der understøtter App Sandbox. Sørg også for, at appen understøtter åbning af den URL, du ønsker at åbne.

Behandling af fangstgruppe

Indstillingen Behandling af fangstgruppe giver dig mulighed for at angive, hvordan du vil behandle de fangne grupper, du kan indsætte i indstillingen Omdiriger til med $1, $2 osv.

Sådan opretter du fangstgrupper:

• Wildcard: Tekster, der matches med * og ?, fanges automatisk.
• Regulært udtryk: Tekster, der matches med en del af mønsteret inde i (), fanges.

Du kan vælge en eller flere af følgende behandlinger:

• URL-kodning/-afkodning: Dette anvender procent-kodning eller afkodning på en fangstgruppe. For eksempel, hvis du koder https://example.com/hello, omdannes det til https%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 hello til aGVsbG8= og afkode det tilbage til hello.
• Erstat forekomster: Dette erstatter et eller flere tegn i en gruppe, matchet af et Mål, med en Udskiftning. For eksempel, hvis Gruppen er hello, Målet er l, og Udskiftningen er y, ændres det til heyyo.

note

Dette er til behandling af hver enkelt fangstgruppe og påvirker ikke, hvilke URL'er der udelukkes af Ekskluderede URL-mønstre. Lad os f.eks. sige, at du har denne regel:

• Omdiriger fra: https://example.com/(hello.*)
• Behandling af fangstgruppe:
  • Gruppe: $1
  • Mål: .* (Regulært udtryk)
  • Udskiftning: hello
• Ekskluderet 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.

Ekskluderede URL-mønstre

Indstillingen Ekskluderede URL-mønstre giver dig mulighed for at angive URL'er, som ikke skal omdirigeres. Dette kan være nyttigt for at undgå omdirigeringsløkker eller for at udelukke visse dele af et websted fra at blive omdirigeret.

Du kan angive ekskluderede URL-mønstre ved hjælp af enten regulære udtryk eller wildcard-mønstertyper.

Eksempler

Indstillingen Eksempler lader dig teste din omdirigeringsregel ved at angive eksempel-URL'er. Ved at tilføje en eksempel-URL kan du tjekke, om reglen fungerer som forventet, før du rent faktisk anvender den.

Avanceret

• [DNR] Omdirigering af hovedramme: Denne indstilling er kun tilgængelig for DNR-typen. Den giver dig mulighed for at angive, hvordan omdirigering skal håndteres for ressourcetypen main_frame. Tilgængelige muligheder er:
  • Rå: Omdirigerer hovedrammen til den angivne URL uden ændringer.
  • Via mellemliggende side: Omdirigerer hovedrammen til en mellemliggende side, som derefter omdirigerer til den angivne destinations-URL. Dette er nyttigt til at åbne apps ved hjælp af dybe links, da den mellemliggende side kan håndtere mere kompleks omdirigeringslogik.

Kommentarer

Indstillingen Kommentarer lader dig tilføje noter eller kommentarer om din omdirigeringsregel. Dette kan være nyttigt til at holde styr på, hvorfor du oprettede en bestemt regel, eller til at give kontekst til andre, der måtte se dine regler.

Du kan skrive kommentarer i følgende formater:

• Almindelig tekst (Standard): Enkel tekst uden formatering.
• Markdown: Du kan bruge GitHubs Markdown-syntaks, herunder visse udvidelser, som GFM ikke understøtter. Du kan for eksempel oprette overskrifter, lister, links og meget 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, Ekskluderede URL-mønstre og Behandling af fangstgruppe*. For at angive dem kan du vælge enten Wildcard eller Regulært udtryk.

Wildcard

Wildcard er en simplere mønstertype, der lader dig bruge * (matcher alt) og ? (matcher et hvilket som helst enkelt tegn) som wildcards. Her er nogle eksempler:

• For at matche https://example.com/hello kan du bruge https://example.com/*. Dette vil matche enhver streng efter https://example.com/.
• For at matche https://example.com/search?q=hello kan du bruge https://example.com/search?q=*. Dette vil matche enhver værdi for parameteren q.
• For at matche enhver URL, der indeholder ordet blog, kan du bruge *blog*.

Du kan også bruge erstatning i Wildcard, hvilket betyder, at du kan referere til dele af den matchede URL ved hjælp af $1, $2 osv. Hvis du f.eks. bruger https://example.com/*-world-*, og URL'en er https://example.com/hello-world-goodbye, vil $1 være "hello" og $2 være "goodbye". $0 er også tilgængelig til at referere til hele den matchede URL.

note

Selvom erstatning er en funktion i regulære udtryk, kan du også bruge det til Wildcard, fordi RedirectWeb internt konverterer Wildcard 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 er også meget brugt i programmering. Det lader dig definere et specifikt mønster, der matcher et sæt strenge. Her er nogle eksempler.

• For at matche https://example.com/hello kan du bruge https://example.com/.*. Dette vil matche enhver streng efter https://example.com/.
• For at matche https://example.com/search?q=hello kan du bruge https://example.com/search\?q=(.*). Dette vil matche værdien af parameteren q og gemme den i en fangstgruppe. Du kan derefter referere til den ved hjælp af $1 i indstillingen Omdiriger til.
• For at matche enhver URL, der indeholder ordet blog, kan du bruge .*blog.*.

Du kan referere til fangstgrupperne i Omdiriger til eller Udskiftning ved hjælp af $1, $2, ... eller $0 for at referere til hele matchet.

RedirectWeb drives af Apples Regex-motor.

Yderligere oplysninger om Regex-syntaks kan findes i ressourcer som RegExr.