Ga naar hoofdinhoud

Regelinstellingen

Deze pagina biedt gedetailleerde informatie over elke instelling in het scherm Regel bewerken in de Redirect Web-app.

Opties​

Type​

Specificeer de optie Type om te bepalen hoe de app omgaat met omleidingen. U kunt kiezen uit deze opties:

  • Origineel (Standaard)
    • Dit maakt gebruik van traditionele Web API's om omleidingen te beheren. Bovendien gebruikt het de Tabs API als terugval.
      • In Firefox gebruikt het de WebRequest API om omleidingen af te handelen.
    • U kunt alle opties gebruiken behalve Brontypen en Verzoekmethoden.
    • Dit is langzamer dan het Declaratieve type en kan extra netwerkverzoeken veroorzaken.
  • DNR (Experimenteel voor Safari):
    • Dit type werkt veel sneller dan het Originele type omdat het geen netwerkverzoek initieert voor de bron-URL.
    • Dit stelt u in staat om Brontypen en Verzoekmethoden te specificeren.
    • ⚠️ U kunt sommige opties niet gebruiken, zoals Verwerking van opnamegroepen en Uitgesloten URL-patronen, aangezien deze nog niet worden ondersteund door de DNR API.
    • ⚠️ In Safari kunt u momenteel geen pipes (|) opnemen in uw reguliere expressiepatroon. Details
    • ⚠️ Aangezien de DNR API van Safari nog steeds enkele problemen heeft, beschouwen we dit nog steeds als een experimentele functie voor Safari. U kunt de lijst met alle bekende problemen hier vinden.

Omleiden Van​

De optie Omleiden Van stelt u in staat om een URL-patroon op te geven van webpagina's waarvan u wilt omleiden. U kunt kiezen uit Wildcard of Reguliere Expressie.

Als u bijvoorbeeld https://example.com/* opgeeft met Wildcard, komt dit overeen met https://example.com/ of https://example.com/hello.

notitie

In de optie Omleiden Naar kunt u verwijzen naar de gehele overeenkomst met $0 of gedeeltelijke overeenkomsten met $1, $2, ... Controleer de details in URL-patroon op deze pagina.

Brontypen​

Ondersteunde typen: DNR

De optie Brontypen laat u de categorieën van webverzoeken specificeren, zoals afbeeldingen, JavaScripts en stylesheets, waarop de regel van toepassing is. Als u bijvoorbeeld script instelt, kunt u de JavaScript-bestanden omleiden die door webpagina's worden geladen.

Momenteel zijn deze beschikbaar: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

De standaardinstelling is main_frame, wat de top-level pagina is die in een tabblad wordt geladen.

Controleer de details van elk brontype in mdn web docs.

Verzoekmethoden​

Ondersteunde typen: DNR

De optie Verzoekmethoden stelt u in staat om de doel-HTTP-methoden van de bron-URL in te stellen.

Alle methoden zijn standaard ingesteld.

Controleer de details van elke methode in mdn web docs.

waarschuwing

In Safari is deze optie mogelijk niet beschikbaar omdat de implementatie van Apple voor het DNR-type deze momenteel niet lijkt te ondersteunen. We hebben feedback naar Apple gestuurd als FB14502272.

Doelbrowsers​

Ondersteunde platforms: macOS

De optie Doelbrowsers stelt u in staat om te specificeren op welke browser de regel wel of niet moet worden toegepast.

  • Er zijn 2 soorten browsers die u kunt kiezen:
    • Browsers die u standaard kunt kiezen: U kunt standaard Safari, Chrome, Firefox, Edge, Opera, Arc, Brave en Vivaldi kiezen. Dit maakt geen onderscheid tussen varianten van dezelfde browser, zoals Safari en Safari Technology Preview.
    • Door de gebruiker gespecificeerde browsers: Door op de knop Toevoegen in de popover te tikken, kunt u elke browser selecteren, behalve Safari of Safari Technology Preview, waarin de Redirect Web-extensie is geïnstalleerd.
  • Het selectievakje Alles behalve geselecteerd stelt u in staat om elke browser te targeten, behalve de browsers die u hebt gekozen.
waarschuwing

Redirect Web kan geen onderscheid maken tussen Safari en Safari Technology Preview, omdat de app het bovenliggende proces van de extensie controleert om dit te detecteren, maar deze twee browsers delen hetzelfde bovenliggende proces (/sbin/launchd).

Omleiden Naar​

De optie Omleiden Naar specificeert een bestemmings-URL waarnaar u wilt omleiden, vanaf de bron-URL die overeenkomt met de optie Omleiden Van. U kunt ook opnamegroepen vervangen door $1, $2, ... of de gehele overeenkomst door $0. Deze helpen u de bestemming dynamisch te specificeren. Controleer de details in URL-patroon op deze pagina.

Als u bijvoorbeeld de volgende regel instelt:

  • Omleiden Van: https://google.com/* (Wildcard)
  • Omleiden Naar: https://apple.com/$1

en dit komt overeen met https://google.com/hello, dan is de bestemmings-URL https://apple.com/hello.

Bovendien kunt u de teksten van $1, $2, ... wijzigen voordat u vervangingen uitvoert. Controleer de sectie Verwerking van opnamegroepen voor de details.

tip

U kunt een aangepast URL-schema opgeven om een app te openen. Dit zijn voorbeelden van apps die deep linking ondersteunen:

  • 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

Applicatie​

Ondersteunde typen: Origineel Ondersteunde platforms: macOS

Als u een app wilt specificeren waarmee u de bestemmings-URL wilt openen, gebruikt u het keuzemenu Applicatie. Dit is alleen beschikbaar op macOS.

waarschuwing

U kunt alleen een app openen die App Sandbox ondersteunt. Zorg er ook voor dat de app het openen van de URL die u wilt openen ondersteunt.

Verwerking van opnamegroepen​

Ondersteunde typen: Origineel

De optie Verwerking van opnamegroepen stelt u in staat om te specificeren hoe de vastgelegde groepen moeten worden verwerkt die u kunt vervangen in de optie Omleiden Naar met $1, $2...

Dit zijn manieren om opnamegroepen te maken:

  • Wildcard: Teksten die overeenkomen met * en ? worden automatisch vastgelegd.
  • Reguliere Expressie: Teksten die overeenkomen met een deel van het patroon binnen () worden vastgelegd.

U kunt een of meer van de volgende processen kiezen:

  • URL Coderen/Decoderen: Dit past percent-encoding of decodering toe op een opnamegroep. Als u bijvoorbeeld https://example.com/hello codeert, wordt het omgezet naar https%3A%2F%2Fexample.com%2Fhello. Decoderen werkt op de tegenovergestelde manier.
  • Base64 Coderen/Decoderen: Dit decodeert/codeert een tekst naar Base64. U kunt bijvoorbeeld hello coderen naar aGVsbG8=, en het terug decoderen naar hello.
  • Vervang Voorkomens: Dit vervangt een of meer tekens in een groep, die overeenkomen met een Doel, door een Vervanging. Als de Groep bijvoorbeeld hello is en het Doel l en de Vervanging y, wordt het gewijzigd in heyyo.
notitie

Dit is voor het verwerken van elke opnamegroep en heeft geen invloed op welke URL's worden uitgesloten door de Uitgesloten URL-patronen. Stel bijvoorbeeld dat u deze regel hebt:

  • Omleiden Van: https://example.com/(hello.*)
  • Verwerking van opnamegroepen:
    • Groep: $1
    • Doel: .* (Reguliere Expressie)
    • Vervanging: hello
  • Uitgesloten URL-patroon: https://example.com/hello

In dit geval wordt https://example.com/hello_world niet uitgesloten, terwijl https://example.com/hello wel wordt uitgesloten.

Uitgesloten URL-patronen​

Ondersteunde typen: Origineel

De optie Uitgesloten URL-patronen stelt u in staat om de URL's te specificeren die niet worden omgeleid. Dit kan nuttig zijn om omleidingslussen te voorkomen of om bepaalde delen van een website uit te sluiten van omleiding.

U kunt uitgesloten URL-patronen specificeren met behulp van reguliere expressie- of wildcard-patroontypen.

Voorbeelden​

De optie Voorbeelden stelt u in staat om uw omleidingsregel te testen door voorbeeld-URL's op te geven. Door een voorbeeld-URL toe te voegen, kunt u controleren of de regel werkt zoals verwacht voordat u deze daadwerkelijk toepast.

Opmerkingen​

De optie Opmerkingen stelt u in staat om notities of opmerkingen over uw omleidingsregel toe te voegen. Dit kan nuttig zijn om bij te houden waarom u een specifieke regel hebt gemaakt of om context te bieden voor anderen die uw regels mogelijk bekijken.

U kunt opmerkingen schrijven in de volgende formaten:

  • Platte tekst (Standaard): Eenvoudige tekst zonder enige opmaak.
  • Markdown: U kunt GitHub's Markdown-syntaxis gebruiken, inclusief enkele extensies die GFM niet ondersteunt. U kunt bijvoorbeeld koppen, lijsten, links en meer maken.
  • AsciiDoc: U kunt AsciiDoc-syntaxis gebruiken om uw opmerkingen op te maken.

URL-patroon​

URL-patronen worden gebruikt om URL's te matchen in de opties Omleiden Van, Uitgesloten URL-patronen en Verwerking van opnamegroepen. Om deze te specificeren, kunt u kiezen uit Wildcard of Reguliere Expressie.

Wildcard​

Wildcard is een eenvoudiger patroontype waarmee u * (komt overeen met alles) en ? (komt overeen met elk enkel teken) als wildcards kunt gebruiken. Hier zijn enkele voorbeelden:

  • Om https://example.com/hello te matchen, kunt u https://example.com/* gebruiken. Dit komt overeen met elke string na https://example.com/.
  • Om https://example.com/search?q=hello te matchen, kunt u https://example.com/search?q=* gebruiken. Dit komt overeen met elke waarde voor de q-parameter.
  • Om elke URL te matchen die het woord blog bevat, kunt u *blog* gebruiken.

U kunt ook substitutie gebruiken in Wildcard, wat betekent dat u kunt verwijzen naar delen van de gematchte URL met $1, $2, enz. Als u bijvoorbeeld https://example.com/*-world-* gebruikt en de URL is https://example.com/hello-world-goodbye, dan zou $1 "hello" zijn en $2 "goodbye". $0 is ook beschikbaar om naar de gehele gematchte URL te verwijzen.

notitie

Hoewel substitutie een functie van Reguliere Expressie is, kunt u het ook gebruiken voor Wildcard omdat Redirect Web Wildcard intern converteert naar Reguliere Expressie.

Reguliere Expressie​

Reguliere Expressie (Regex) is een krachtig hulpmiddel voor het matchen van patronen in tekst en wordt ook veel gebruikt in programmeren. Het stelt u in staat om een specifiek patroon te definiëren dat overeenkomt met een reeks strings. Hier zijn enkele voorbeelden.

  • Om https://example.com/hello te matchen, kunt u https://example.com/.* gebruiken. Dit komt overeen met elke string na https://example.com/.
  • Om https://example.com/search?q=hello te matchen, kunt u https://example.com/search\?q=(.*) gebruiken. Dit komt overeen met de waarde van de q-parameter en slaat deze op in een opnamegroep. U kunt er vervolgens naar verwijzen met $1 in de optie Omleiden Naar.
  • Om elke URL te matchen die het woord blog bevat, kunt u .*blog.* gebruiken.

U kunt verwijzen naar de opnamegroepen in Omleiden Naar of Vervanging met $1, $2, ... of $0 om naar de gehele overeenkomst te verwijzen.

Redirect Web wordt aangedreven door Apple's Regex-engine.

Meer informatie over de Regex-syntaxis is te vinden in bronnen zoals RegExr.