Ga naar hoofdinhoud

Regelinstellingen

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

Opties​

Type​

Geef de optie Type op om te bepalen hoe de app omleidingen afhandelt. U kunt kiezen uit deze:

  • Original (Standaard)
    • Dit gebruikt traditionele web-API's om omleidingen te regelen. Bovendien wordt de Tabs API gebruikt als fallback.
      • In Firefox wordt de WebRequest API gebruikt om omleidingen af te handelen.
    • U kunt alle opties gebruiken, behalve Resourcetypes en Request-methoden.
    • ⚠️ Dit is trager dan het Declarative type en kan extra netwerkverzoeken veroorzaken.
  • DNR (Experimenteel voor Safari):
    • Dit type werkt veel sneller dan het Original-type omdat het geen netwerkverzoek start voor de bron-URL.
    • Hiermee kunt u Resourcetypes en Request-methoden opgeven.
    • ⚠️ U kunt sommige opties niet gebruiken, zoals Verwerking van vastleggroepen en Uitgesloten URL-patronen, omdat deze nog niet worden ondersteund door de DNR API.
    • ⚠️ In Safari kunt u momenteel geen sluisjes (|) opnemen in uw Regular Expression-patroon. Details
    • ⚠️ Omdat de DNR API van Safari nog steeds enkele problemen heeft, beschouwen we dit 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 die u wilt omleiden. U kunt kiezen uit Wildcard of Regular Expression.

Bijvoorbeeld, als u 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 naar de volledige overeenkomst verwijzen met $0 of naar gedeeltelijke overeenkomsten met $1, $2, ... Bekijk de details in URL-patroon op deze pagina.

Resourcetypes​

Supported Types: DNR

Met de optie Resourcetypes kunt u de categorieën webverzoeken opgeven, 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, de pagina op het hoogste niveau die in een tabblad wordt geladen.

Bekijk de details van elk resourcetype in mdn web docs.

Request-methoden​

Supported Types: DNR

Met de optie Request-methoden kunt u de doel-HTTP-methoden van de bron-URL instellen.

Alle methoden zijn standaard ingesteld.

Bekijk 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 dit momenteel niet lijkt af te handelen. We hebben feedback naar Apple gestuurd als FB14502272.

Doelbrowsers​

Supported Platforms: macOS

Met de optie Doelbrowsers kunt u opgeven 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 op de popover te tikken, kunt u elke andere browser dan Safari of Safari Technology Preview selecteren waarop de RedirectWeb-extensie is geïnstalleerd.
  • Met het selectievakje Alles behalve geselecteerde kunt u zich richten op elke browser behalve de browsers die u hebt gekozen.
waarschuwing

RedirectWeb kan geen onderscheid maken of de browser Safari of Safari Technology Preview is, 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 vastleggroepen vervangen door $1, $2, ... of de volledige overeenkomst door $0. Hiermee kunt u de bestemming dynamisch opgeven. Bekijk de details in URL-patroon op deze pagina.

Bijvoorbeeld, als u 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 bestemmings-URL https://apple.com/hello.

Bovendien kunt u de teksten van $1, $2, ... wijzigen voordat u vervangingen uitvoert. Bekijk de sectie Verwerking van vastleggroepen voor 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​

Supported Types: Original Supported Platforms: macOS

Als u een app wilt opgeven waarmee u de bestemmings-URL wilt openen, gebruikt u de keuzelijst 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 ondersteunt van de URL die u wilt openen.

Verwerking van vastleggroepen​

Supported Types: Original

Met de optie Verwerking van vastleggroepen kunt u opgeven hoe de vastgelegde groepen moeten worden verwerkt die u kunt vervangen in de optie Omleiden naar door $1, $2...

Dit is hoe u vastleggroepen maakt:

  • Wildcard: Teksten die overeenkomen met * en ? worden automatisch vastgelegd.
  • Regular Expression: 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 vastleggroep. Als u bijvoorbeeld https://example.com/hello codeert, wordt het geconverteerd 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 weer decoderen naar hello.
  • Voorkomens vervangen: Dit vervangt een of meer tekens in een groep, die overeenkomen met een Doel, door een Vervanging. Bijvoorbeeld, als de Groep hello is en het Doel l is en de Vervanging y is, wordt het gewijzigd in heyyo.
notitie

Dit is voor het verwerken van elke vastleggroep 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 vastleggroepen:
    • Groep: $1
    • Doel: .* (Regular Expression)
    • 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​

Supported Types: Original

Met de optie Uitgesloten URL-patronen kunt u de URL's opgeven 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 Regular Expression- of Wildcard-patroontypen.

Voorbeelden​

Met de optie Voorbeelden kunt u uw omleidingsregel 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.

Geavanceerd​

  • [DNR] Main Frame Omleiding: Deze optie is alleen beschikbaar voor het DNR-type. Hiermee kunt u opgeven hoe de omleiding voor het resourcetype main_frame moet worden afgehandeld. Beschikbare opties zijn:
    • Ruw: Leid het hoofdframe om naar de opgegeven URL zonder enige wijzigingen.
    • Via tussenpagina: Leid het hoofdframe om naar een tussenpagina, die vervolgens omleidt naar de opgegeven bestemmings-URL. Dit is handig voor het openen van apps met behulp van deep linking, omdat de tussenpagina complexere omleidingslogica kan afhandelen.

Opmerkingen​

Met de optie Opmerkingen kunt u aantekeningen of opmerkingen over uw omleidingsregel toevoegen. Dit kan handig zijn om bij te houden waarom u een specifieke regel hebt gemaakt of om context te bieden aan anderen die uw regels bekijken.

U kunt opmerkingen in de volgende formaten schrijven:

  • Platte tekst (Standaard): Eenvoudige tekst zonder opmaak.
  • Markdown: U kunt GitHub's Markdown-syntaxis gebruiken, inclusief enkele uitbreidingen 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 vastleggroepen. Om ze op te geven, kunt u kiezen uit Wildcard of Regular Expression.

Wildcard​

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

  • Om https://example.com/hello te matchen, kunt u https://example.com/* gebruiken. Dit zal overeenkomen 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 zal overeenkomen met elke waarde voor de parameter q.
  • Om elke URL te matchen die het woord blog bevat, kunt u *blog* gebruiken.

U kunt ook vervanging gebruiken in Wildcard, wat betekent dat u kunt verwijzen naar gedeelten van de gematchte URL met $1, $2, enz. Bijvoorbeeld, als u https://example.com/*-world-* gebruikt en de URL is https://example.com/hello-world-goodbye, dan is $1 "hello" en $2 "goodbye". $0 is ook beschikbaar om te verwijzen naar de volledige gematchte URL.

notitie

Hoewel vervanging een kenmerk is van Regular Expression, kunt u het ook voor Wildcard gebruiken omdat RedirectWeb Wildcard intern converteert naar Regular Expression.

Regular Expression​

Regular Expression (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 set strings. Hier zijn enkele voorbeelden.

  • Om https://example.com/hello te matchen, kunt u https://example.com/.* gebruiken. Dit zal overeenkomen met elke string na https://example.com/.
  • Om https://example.com/search?q=hello te matchen, kunt u https://example.com/search\?q=(.*). Dit zal overeenkomen met de waarde van de parameter q en deze opslaan in een vastleggroep. 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 vastleggroepen in Omleiden naar of Vervanging met $1, $2, ... of $0 om naar de volledige overeenkomst te verwijzen.

RedirectWeb wordt aangedreven door de Regex-engine van Apple.

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