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 omleidingen afhandelt. U kunt kiezen uit:

  • 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.
    • Hiermee kunt u Brontypen en Verzoekmethoden specificeren.
    • ⚠️ U kunt sommige opties niet gebruiken, zoals Vastleggen van groepsverwerking 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 vindt de lijst met alle bekende problemen hier.

Omleiden van​

De optie Omleiden van stelt u in staat een URL-patroon op te geven van webpagina's waarvan u wilt omleiden. U kunt kiezen tussen 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 stelt u in staat de categorieën van webverzoeken, zoals afbeeldingen, JavaScripts en stylesheets, op te geven 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 pagina op het hoogste niveau is die in een tabblad wordt geladen.

Please check the details of each resource type in mdn web docs.

Verzoekmethoden​

Ondersteunde typen: DNR

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

Alle methoden zijn standaard ingesteld.

Please check the details of each method 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 sent feedback to Apple as FB14502272.

Doelbrowsers​

Ondersteunde platforms: macOS

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

  • Er zijn 2 soorten browsers waaruit u kunt kiezen:
    • Browsers die u standaard kunt kiezen: U kunt standaard kiezen uit Safari, Chrome, Firefox, Edge, Opera, Arc, Brave en Vivaldi. Dit maakt geen onderscheid tussen varianten van dezelfde browser, zoals Safari en Safari Technology Preview.
    • Door de gebruiker opgegeven browsers: Door op de knop Toevoegen in de pop-over te tikken, kunt u elke browser behalve Safari of Safari Technology Preview selecteren die de Redirect Web-extensie heeft geïnstaleerd.
  • Het selectievakje Alles behalve geselecteerd stelt u in staat 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 doel-URL waarnaar u wilt omleiden, vanaf de bron-URL die overeenkomt met de optie Omleiden van. U kunt ook vastleggende groepen vervangen door $1, $2, ... of de gehele overeenkomst met $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 het komt overeen met https://google.com/hello, dan is de doel-URL https://apple.com/hello.

Bovendien kunt u de teksten van $1, $2, ... wijzigen voordat u vervangingen uitvoert. Controleer de sectie Vastleggen van groepsverwerking 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 opgeven waarin u de doel-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.

Vastleggen van groepsverwerking​

Ondersteunde typen: Origineel

De optie Vastleggen van groepsverwerking stelt u in staat op te geven hoe de vastgelegde groepen moeten worden verwerkt die u kunt vervangen in de optie Omleiden naar met $1, $2...

Dit zijn de manieren om vastleggende groepen 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 vastleggende groep. 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.
  • Voorkomens vervangen: Dit vervangt een of meer tekens in een groep, die overeenkomt 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 vastleggende groep en het heeft geen invloed op welke URL's worden uitgesloten door de Uitgesloten URL-patronen. Stel bijvoorbeeld dat u deze regel heeft:

  • Omleiden van: https://example.com/(hello.*)
  • Vastleggen van groepsverwerking:
    • 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 de URL's op te geven die niet worden omgeleid. Dit kan handig zijn om omleidingslussen te voorkomen of om bepaalde delen van een website uit te sluiten van omleiding.

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

Voorbeelden​

De optie Voorbeelden stelt u in staat 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 notities of opmerkingen toe te voegen over uw omleidingsregel. Dit kan handig 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 Vastleggen van groepsverwerking. Om ze te specificeren, kunt u kiezen tussen 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 tekenreeks 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 omzet 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. Hiermee kunt u een specifiek patroon definiëren dat overeenkomt met een reeks tekenreeksen. Hier zijn enkele voorbeelden.

  • Om https://example.com/hello te matchen, kunt u https://example.com/.* gebruiken. Dit komt overeen met elke tekenreeks 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 vastleggende groep. 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 vastleggende groepen 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 Regex-syntaxis is te vinden in bronnen zoals RegExr.