Regel-Einstellungen
Diese Seite enthält detaillierte Informationen zu jeder Einstellung im Bildschirm „Regel bearbeiten“ der Redirect Web App.
Optionen
Typ
Geben Sie die Option Typ an, um zu steuern, wie die App die Weiterleitung handhabt. Sie können aus den folgenden auswählen:
- Original (Standard)
- Dies verwendet traditionelle Web-APIs, um die Weiterleitung zu steuern. Zusätzlich wird die Tabs API als Fallback verwendet.
- In Firefox wird die WebRequest API verwendet, um die Weiterleitung zu handhaben.
- Sie können alle Optionen außer Ressourcentypen und Anforderungsmethoden verwenden.
- Dies ist langsamer als der Deklarative Typ und kann zusätzliche Netzwerkanfragen verursachen.
- Dies verwendet traditionelle Web-APIs, um die Weiterleitung zu steuern. Zusätzlich wird die Tabs API als Fallback verwendet.
- DNR (Experimentell für Safari):
- Dieser Typ arbeitet viel schneller als der Original-Typ, da er keine Netzwerkanfrage für die Quell-URL initiiert.
- Dies ermöglicht es Ihnen, Ressourcentypen und Anforderungsmethoden anzugeben.
- ⚠️ Einige Optionen, wie Verarbeitung von Erfassungsgruppen und Ausgeschlossene URL-Muster, können nicht verwendet werden, da sie noch nicht von der DNR API unterstützt werden.
- ⚠️ In Safari können Sie derzeit keine Pipes (
|
) in Ihrem regulären Ausdrucksmuster verwenden. Details - ⚠️ Da Safaris DNR API noch einige Probleme aufweist, betrachten wir dies immer noch als experimentelle Funktion für Safari. Die Liste aller bekannten Probleme finden Sie hier.
Weiterleiten von
Die Option Weiterleiten von ermöglicht es Ihnen, ein URL-Muster von Webseiten anzugeben, von denen Sie weiterleiten möchten. Sie können entweder Wildcard oder Regulärer Ausdruck wählen.
Wenn Sie beispielsweise https://example.com/*
mit Wildcard angeben, entspricht dies https://example.com/
oder https://example.com/hello
.
In der Option „Weiterleiten an“ können Sie die gesamte Übereinstimmung mit $0
oder Teilübereinstimmungen mit $1
, $2
, ... referenzieren. Überprüfen Sie die Details unter URL-Muster auf dieser Seite.
Ressourcentypen
Die Option Ressourcentypen ermöglicht es Ihnen, die Kategorien von Webanfragen, wie Bilder, JavaScripts und Stylesheets, anzugeben, auf die die Regel angewendet werden soll.
Wenn Sie beispielsweise script
festlegen, können Sie die von Webseiten geladenen JavaScript-Dateien umleiten.
Derzeit sind diese verfügbar:
main_frame
, sub_frame
, stylesheet
, script
, image
, font
, xmlhttprequest
, ping
, media
, websocket
, other
Die Standardeinstellung ist main_frame
, was die auf oberster Ebene in einem Tab geladene Seite ist.
Bitte überprüfen Sie die Details zu jedem Ressourcentyp in den mdn web docs.
Anforderungsmethoden
Die Option Anforderungsmethoden ermöglicht es Ihnen, die Ziel-HTTP-Methoden der Quell-URL festzulegen.
Alle Methoden sind standardmäßig festgelegt.
Bitte überprüfen Sie die Details zu jeder Methode in den mdn web docs.
In Safari ist diese Option möglicherweise nicht verfügbar, da Apples Implementierung für den DNR-Typ sie derzeit anscheinend nicht handhabt. Wir haben Feedback an Apple als FB14502272 gesendet.
Zielbrowser
Die Option Zielbrowser ermöglicht es Ihnen anzugeben, auf welchen Browser die Regel angewendet werden soll oder nicht.
- Es gibt 2 Arten von Browsern, die Sie auswählen können:
- Standardmäßig wählbare Browser: Sie können standardmäßig Safari, Chrome, Firefox, Edge, Opera, Arc, Brave und Vivaldi auswählen. Dies unterscheidet nicht zwischen Varianten desselben Browsers, wie Safari und Safari Technology Preview.
- Benutzerdefinierte Browser: Durch Tippen auf die Schaltfläche „Hinzufügen“ im Popover können Sie jeden Browser außer Safari oder Safari Technology Preview auswählen, der die Redirect Web Erweiterung installiert hat.
- Das Kontrollkästchen Alle außer ausgewählten ermöglicht es Ihnen, jeden Browser außer den von Ihnen ausgewählten zu berücksichtigen.
Redirect Web kann nicht unterscheiden, ob der Browser Safari oder Safari Technology Preview ist, da die App den übergeordneten Prozess der Erweiterung überprüft, um dies zu erkennen, diese beiden Browser jedoch denselben übergeordneten Prozess (/sbin/launchd
) teilen.
Weiterleiten an
Die Option Weiterleiten an gibt eine Ziel-URL an, zu der Sie von der Quell-URL, die mit der Option Weiterleiten von übereinstimmt, weiterleiten möchten. Sie können auch Erfassungsgruppen durch $1
, $2
, ... oder die gesamte Übereinstimmung durch $0
ersetzen. Dies hilft Ihnen, das Ziel dynamisch anzugeben. Überprüfen Sie die Details unter URL-Muster auf dieser Seite.
Wenn Sie beispielsweise die folgende Regel festlegen:
- Weiterleiten von:
https://google.com/*
(Wildcard) - Weiterleiten an:
https://apple.com/$1
und es https://google.com/hello
entspricht, dann wird die Ziel-URL https://apple.com/hello
sein.
Zusätzlich können Sie die Texte von $1
, $2
, ... vor dem Ersetzen ändern. Überprüfen Sie den Abschnitt Verarbeitung von Erfassungsgruppen für Details.
Sie können ein benutzerdefiniertes URL-Schema angeben, um eine App zu öffnen. Dies sind Beispiele für Apps, die Deep Linking unterstützen:
- 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
Anwendung
Wenn Sie eine App angeben möchten, mit der Sie die Ziel-URL öffnen möchten, verwenden Sie das Kombinationsfeld Anwendung. Dies ist nur unter macOS verfügbar.
Sie können nur eine App öffnen, die App Sandbox unterstützt. Stellen Sie außerdem sicher, dass die App das Öffnen der gewünschten URL unterstützt.
Verarbeitung von Erfassungsgruppen
Die Option Verarbeitung von Erfassungsgruppen ermöglicht es Ihnen anzugeben, wie die erfassten Gruppen verarbeitet werden sollen, die Sie in der Option Weiterleiten an durch $1
, $2
... ersetzen können.
So erstellen Sie Erfassungsgruppen:
- Wildcard: Texte, die mit
*
und?
übereinstimmen, werden automatisch erfasst. - Regulärer Ausdruck: Texte, die mit einem Teil des Musters innerhalb von
()
übereinstimmen, werden erfasst.
Sie können einen oder mehrere der folgenden Prozesse auswählen:
- URL Kodieren/Dekodieren: Dies wendet Prozentkodierung oder Dekodierung auf eine Erfassungsgruppe an. Wenn Sie beispielsweise
https://example.com/hello
kodieren, wird es inhttps%3A%2F%2Fexample.com%2Fhello
umgewandelt. Die Dekodierung funktioniert umgekehrt. - Base64 Kodieren/Dekodieren: Dies dekodiert/kodiert einen Text in Base64. Zum Beispiel können Sie
hello
zuaGVsbG8=
kodieren und es zurück zuhello
dekodieren. - Vorkommen ersetzen: Dies ersetzt ein oder mehrere Zeichen in einer Gruppe, die mit einem Ziel übereinstimmen, durch eine Ersetzung. Wenn beispielsweise die Gruppe
hello
ist und das Ziell
und die Ersetzungy
ist, wird es zuheyyo
geändert.
Dies dient der Verarbeitung jeder Erfassungsgruppe und beeinflusst nicht, welche URLs durch die Ausgeschlossene URL-Muster ausgeschlossen werden. Angenommen, Sie haben diese Regel:
- Weiterleiten von:
https://example.com/(hello.*)
- Verarbeitung von Erfassungsgruppen:
- Gruppe:
$1
- Ziel:
.*
(Regulärer Ausdruck) - Ersetzung:
hello
- Gruppe:
- Ausgeschlossenes URL-Muster:
https://example.com/hello
In diesem Fall wird https://example.com/hello_world
nicht ausgeschlossen, während https://example.com/hello
ausgeschlossen wird.
Ausgeschlossene URL-Muster
Die Option Ausgeschlossene URL-Muster ermöglicht es Ihnen, die URLs anzugeben, die nicht weitergeleitet werden. Dies kann nützlich sein, um Weiterleitungsschleifen zu vermeiden oder bestimmte Teile einer Website von der Weiterleitung auszuschließen.
Sie können ausgeschlossene URL-Muster entweder mit regulären Ausdrücken oder Wildcard-Mustertypen angeben.
Beispiele
Die Option Beispiele ermöglicht es Ihnen, Ihre Weiterleitungsregel zu testen, indem Sie Beispiel-URLs bereitstellen. Durch Hinzufügen einer Beispiel-URL können Sie überprüfen, ob die Regel wie erwartet funktioniert, bevor Sie sie tatsächlich anwenden.
Kommentare
Die Option Kommentare ermöglicht es Ihnen, Notizen oder Kommentare zu Ihrer Weiterleitungsregel hinzuzufügen. Dies kann nützlich sein, um nachzuvollziehen, warum Sie eine bestimmte Regel erstellt haben, oder um anderen, die Ihre Regeln möglicherweise einsehen, Kontext zu geben.
URL-Muster
Es gibt 3 Optionen, bei denen Sie ein oder mehrere URL-Muster angeben können: Weiterleiten von, Ausgeschlossene URL-Muster und Verarbeitung von Erfassungsgruppen. Um diese anzugeben, können Sie entweder Wildcard oder Regulärer Ausdruck wählen.
Wildcard
Wildcard ist ein einfacherer Mustertyp, der es Ihnen ermöglicht, *
(entspricht beliebigem) und ?
(entspricht einem beliebigen einzelnen Zeichen) als Wildcards zu verwenden. Hier sind einige Beispiele:
- Um
https://example.com/hello
abzugleichen, können Siehttps://example.com/*
verwenden. Dies entspricht jeder Zeichenfolge nachhttps://example.com/
. - Um
https://example.com/search?q=hello
abzugleichen, können Siehttps://example.com/search?q=*
verwenden. Dies entspricht jedem Wert für denq
-Parameter. - Um jede URL abzugleichen, die das Wort
blog
enthält, können Sie*blog*
verwenden.
Sie können auch Substitutionen in Wildcards verwenden, was bedeutet, dass Sie Teile der übereinstimmenden URL mit $1
, $2
usw. referenzieren können. Wenn Sie beispielsweise https://example.com/*-world-*
verwenden und die URL https://example.com/hello-world-goodbye
ist, dann wäre $1
„hello“ und $2
„goodbye“. $0
ist auch verfügbar, um die gesamte übereinstimmende URL zu referenzieren.
[!Note] Obwohl Substitution eine Funktion des regulären Ausdrucks ist, können Sie sie auch für Wildcard verwenden, da Redirect Web Wildcard intern in reguläre Ausdrücke umwandelt.
Regulärer Ausdruck
Regulärer Ausdruck (Regex) ist ein leistungsstarkes Werkzeug zum Abgleichen von Mustern in Texten, das von Apples regulärer Ausdrucks-Engine betrieben wird, die hier beschrieben ist. Es ermöglicht Ihnen, ein spezifisches Muster zu definieren, das mit einer Reihe von Zeichenfolgen übereinstimmt. Hier sind einige Beispiele.
- Um
https://example.com/hello
abzugleichen, können Siehttps://example.com/(.*)
verwenden. Dies entspricht jeder Zeichenfolge nachhttps://example.com/
und speichert sie in einer Erfassungsgruppe. - Um
https://example.com/search?q=hello
abzugleichen, können Siehttps://example.com/search\?q=(.*)
verwenden. Dies entspricht dem Wert desq
-Parameters und speichert ihn in einer Erfassungsgruppe. - Um jede URL abzugleichen, die das Wort
blog
enthält, können Sie.*blog.*
verwenden.
Sie können die Erfassungsgruppen in Weiterleiten an oder Ersetzung mit $1
, $2
, ... oder $0
referenzieren, um die gesamte Übereinstimmung zu referenzieren.
Weitere Informationen zur Regex-Syntax finden Sie in Ressourcen wie RegExr.