Zum Hauptinhalt springen

Regeleinstellungen

Diese Seite bietet detaillierte Informationen zu jeder Einstellung auf dem Bildschirm Regel bearbeiten in der RedirectWeb-App.

Optionen​

Typ​

Legen Sie die Option Typ fest, um zu steuern, wie die App die Weiterleitung handhabt. Sie können aus folgenden wählen:

  • Original (Standard)
    • Dies verwendet herkömmliche Web-APIs zur Steuerung der Weiterleitung. Zusätzlich wird die Tabs-API als Fallback verwendet.
      • In Firefox wird die WebRequest-API zur Handhabung der Weiterleitung verwendet.
    • Sie können alle Optionen außer Ressourcentypen und Anfragemethoden verwenden.
    • ⚠️ Dies ist langsamer als der Typ Declarative und kann zusätzliche Netzwerkanfragen verursachen.
  • DNR (Experimentell für Safari):
    • Dieser Typ arbeitet wesentlich schneller als der Typ Original, da keine Netzwerkanfrage für die Quell-URL initiiert wird.
    • Dies ermöglicht es Ihnen, Ressourcentypen und Anfragemethoden anzugeben.
    • ⚠️ Einige Optionen, wie die Verarbeitung von Erfassungsgruppen und Ausgeschlossene URL-Muster, können nicht verwendet werden, da sie von der DNR-API noch nicht unterstützt werden.
    • ⚠️ In Safari können Sie derzeit keine Pipes (|) in Ihrem regulären Ausdrucksmuster verwenden. Details
    • ⚠️ Da die DNR-API von Safari noch einige Probleme aufweist, betrachten wir dies für Safari noch als experimentelle Funktion. Eine Liste aller bekannten Probleme finden Sie hier.

Weiterleitung von​

Die Option Weiterleitung von ermöglicht es Ihnen, ein URL-Muster der Webseiten anzugeben, von denen Sie weiterleiten möchten. Sie können entweder Platzhalter oder Reguläre Ausdrücke wählen.

Wenn Sie beispielsweise https://example.com/* mit Platzhalter angeben, passt dies auf https://example.com/ oder https://example.com/hello.

hinweis

In der Option „Weiterleitung nach“ können Sie mit $0 auf die gesamte Übereinstimmung oder mit $1, $2, ... auf Teilübereinstimmungen verweisen. Einzelheiten finden Sie unter URL-Muster auf dieser Seite.

Ressourcentypen​

Supported Types: DNR

Mit der Option Ressourcentypen können Sie die Kategorien von Webanfragen festlegen, wie z. B. Bilder, JavaScripts und Stylesheets, auf die die Regel angewendet wird. 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 in einem Tab geladene Seite der obersten Ebene ist.

Einzelheiten zu jedem Ressourcentyp finden Sie in den mdn web docs.

Anfragemethoden​

Supported Types: DNR

Mit der Option Anfragemethoden können Sie die Ziel-HTTP-Methoden der Quell-URL festlegen.

Standardmäßig sind alle Methoden eingestellt.

Einzelheiten zu jeder Methode finden Sie in den mdn web docs.

warnung

In Safari ist diese Option möglicherweise nicht verfügbar, da die Implementierung des Typs DNR von Apple sie derzeit anscheinend nicht verarbeitet. Wir haben Feedback an Apple als FB14502272 gesendet.

Zielbrowser​

Supported Platforms: macOS

Mit der Option Zielbrowser können Sie festlegen, auf welchen Browser die Regel angewendet werden soll oder nicht.

  • Es gibt 2 Arten von Browsern, die Sie auswählen können:
    • Browser, die Sie standardmäßig auswählen können: Sie können standardmäßig Safari, Chrome, Firefox, Edge, Opera, Arc, Brave und Vivaldi wählen. Dies unterscheidet nicht zwischen Varianten desselben Browsers, wie Safari und Safari Technology Preview.
    • Vom Benutzer angegebene Browser: Durch Tippen auf die Schaltfläche „Hinzufügen“ im Popover können Sie jeden anderen Browser als Safari oder Safari Technology Preview auswählen, auf dem die RedirectWeb-Erweiterung installiert ist.
  • Das Kontrollkästchen Alle außer den ausgewählten ermöglicht es Ihnen, jeden Browser außer den von Ihnen gewählten anzuvisieren.
warnung

RedirectWeb kann nicht unterscheiden, ob es sich bei dem Browser um Safari oder Safari Technology Preview handelt, da die App den übergeordneten Prozess der Erweiterung überprüft, um dies zu erkennen, diese beiden Browser jedoch denselben übergeordneten Prozess teilen (/sbin/launchd).

Weiterleitung nach​

Die Option Weiterleitung nach legt eine Ziel-URL fest, zu der Sie von der Quell-URL aus weiterleiten möchten, die mit der Option Weiterleitung von übereinstimmt. Sie können Erfassungsgruppen auch durch $1, $2, ... oder die gesamte Übereinstimmung durch $0 ersetzen. Dies hilft Ihnen, das Ziel dynamisch festzulegen. Einzelheiten finden Sie im Abschnitt URL-Muster auf dieser Seite.

Wenn Sie zum Beispiel die folgende Regel festlegen:

  • Weiterleitung von: https://google.com/* (Platzhalter)
  • Weiterleitung nach: https://apple.com/$1

und es passt auf https://google.com/hello, dann ist die Ziel-URL https://apple.com/hello.

Zusätzlich können Sie die Texte von $1, $2, ... vor der Ersetzung ändern. Weitere Informationen finden Sie im Abschnitt Verarbeitung von Erfassungsgruppen.

tipp

Sie können ein benutzerdefiniertes URL-Schema angeben, um eine App zu öffnen. Hier sind Beispiele für Apps, die Deep Linking unterstützen:

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

Anwendung​

Supported Types: Original Supported Platforms: macOS

Wenn Sie eine App angeben möchten, mit der Sie die Ziel-URL öffnen möchten, verwenden Sie das Kombinationsfeld Anwendung. Dies ist nur auf macOS verfügbar.

warnung

Sie können nur eine App öffnen, die App Sandbox unterstützt. Stellen Sie außerdem sicher, dass die App das Öffnen der URL unterstützt, die Sie öffnen möchten.

Verarbeitung von Erfassungsgruppen​

Supported Types: Original

Die Option Verarbeitung von Erfassungsgruppen ermöglicht es Ihnen, festzulegen, wie die erfassten Gruppen verarbeitet werden sollen, die Sie in der Option Weiterleitung nach mit $1, $2 ... ersetzen können.

So werden Erfassungsgruppen erstellt:

  • Platzhalter: Texte, die mit * und ? übereinstimmen, werden automatisch erfasst.
  • Regulärer Ausdruck: Texte, die mit dem Teil des Musters innerhalb von () übereinstimmen, werden erfasst.

Sie können einen oder mehrere der folgenden Prozesse wählen:

  • URL-Kodierung/Dekodierung: Dies wendet Prozentkodierung oder Dekodierung auf eine Erfassungsgruppe an. Wenn Sie beispielsweise https://example.com/hello kodieren, wird es in https%3A%2F%2Fexample.com%2Fhello umgewandelt. Dekodierung funktioniert in die entgegengesetzte Richtung.
  • Base64-Kodierung/Dekodierung: Dies dekodiert/kodiert einen Text in Base64. Sie können beispielsweise hello zu aGVsbG8= kodieren und es wieder zu hello dekodieren.
  • Vorkommen ersetzen: Ersetzt ein oder mehrere Zeichen in einer Gruppe, die durch ein Ziel übereinstimmen, durch einen Ersatz. Wenn zum Beispiel die Gruppe hello ist und das Ziel l ist und der Ersatz y ist, wird es in heyyo geändert.
hinweis

Dies dient der Verarbeitung jeder Erfassungsgruppe und hat keinen Einfluss darauf, welche URLs durch die Ausgeschlossenen URL-Muster ausgeschlossen werden. Angenommen, Sie haben diese Regel:

  • Weiterleitung von: https://example.com/(hello.*)
  • Verarbeitung von Erfassungsgruppen:
    • Gruppe: $1
    • Ziel: .* (Regulärer Ausdruck)
    • Ersatz: hello
  • 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​

Supported Types: Original

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 um bestimmte Teile einer Website von der Weiterleitung auszuschließen.

Sie können ausgeschlossene URL-Muster entweder mit dem Typ Regulärer Ausdruck oder Platzhalter festlegen.

Beispiele​

Mit der Option Beispiele können Sie Ihre Weiterleitungsregel testen, indem Sie Beispiel-URLs angeben. Durch Hinzufügen einer Beispiel-URL können Sie überprüfen, ob die Regel wie erwartet funktioniert, bevor Sie sie tatsächlich anwenden.

Erweitert​

  • [DNR] Weiterleitung des Hauptrahmens: Diese Option ist nur für den Typ DNR verfügbar. Sie ermöglicht es Ihnen festzulegen, wie die Weiterleitung für den Ressourcentyp main_frame gehandhabt werden soll. Verfügbare Optionen sind:
    • Raw: Leitet den Hauptrahmen ohne Änderungen an die angegebene URL weiter.
    • Über Zwischenseite: Leitet den Hauptrahmen auf eine Zwischenseite um, die dann auf die angegebene Ziel-URL weiterleitet. Dies ist nützlich für das Öffnen von Apps über Deep Linking, da die Zwischenseite eine komplexere Weiterleitungslogik verarbeiten kann.

Kommentare​

Die Option Kommentare ermöglicht es Ihnen, beliebige Notizen oder Kommentare zu Ihrer Weiterleitungsregel hinzuzufügen. Dies kann nützlich sein, um nachzuvollziehen, warum Sie eine bestimmte Regel erstellt haben, oder um Kontext für andere bereitzustellen, die Ihre Regeln ansehen könnten.

Sie können Kommentare in den folgenden Formaten schreiben:

  • Nur Text (Standard): Einfacher Text ohne Formatierung.
  • Markdown: Sie können die Markdown-Syntax von GitHub verwenden, einschließlich einiger Erweiterungen, die GFM nicht unterstützt. Sie können beispielsweise Überschriften, Listen, Links und mehr erstellen.
  • AsciiDoc: Sie können die AsciiDoc-Syntax verwenden, um Ihre Kommentare zu formatieren.

URL-Muster​

URL-Muster werden zum Abgleichen von URLs in den Optionen Weiterleitung von, Ausgeschlossene URL-Muster und Verarbeitung von Erfassungsgruppen verwendet. Um sie anzugeben, können Sie entweder Platzhalter oder Regulärer Ausdruck wählen.

Platzhalter​

Platzhalter ist ein einfacherer Mustertyp, mit dem Sie * (entspricht beliebig vielen Zeichen) und ? (entspricht einem einzelnen Zeichen) als Platzhalter verwenden können. Hier sind einige Beispiele:

  • Um https://example.com/hello abzugleichen, können Sie https://example.com/* verwenden. Dies passt auf jede Zeichenfolge nach https://example.com/.
  • Um https://example.com/search?q=hello abzugleichen, können Sie https://example.com/search?q=* verwenden. Dies passt auf jeden Wert für den Parameter q.
  • Um jede URL abzugleichen, die das Wort blog enthält, können Sie *blog* verwenden.

Sie können die Ersetzung auch in Platzhaltern verwenden, was bedeutet, dass Sie mit $1, $2 usw. auf Teile der abgeglichenen URL verweisen können. Wenn Sie beispielsweise https://example.com/*-world-* verwenden und die URL https://example.com/hello-world-goodbye lautet, wäre $1 „hello“ und $2 „goodbye“. $0 ist ebenfalls verfügbar, um auf die gesamte abgeglichene URL zu verweisen.

hinweis

Obwohl die Ersetzung eine Funktion von Regulären Ausdrücken ist, können Sie sie auch für Platzhalter verwenden, da RedirectWeb Platzhalter intern in Reguläre Ausdrücke umwandelt.

Regulärer Ausdruck​

Ein Regulärer Ausdruck (Regex) ist ein leistungsstarkes Werkzeug zum Abgleichen von Mustern in Texten und wird auch in der Programmierung häufig verwendet. Es ermöglicht Ihnen, ein spezifisches Muster zu definieren, das auf eine Menge von Zeichenfolgen passt. Hier sind einige Beispiele.

  • Um https://example.com/hello abzugleichen, können Sie https://example.com/.* verwenden. Dies passt auf jede Zeichenfolge nach https://example.com/.
  • Um https://example.com/search?q=hello abzugleichen, können Sie https://example.com/search\?q=(.*) verwenden. Dies gleicht den Wert des Parameters q ab und speichert ihn in einer Erfassungsgruppe. Sie können dann in der Option Weiterleitung nach mit $1 darauf verweisen.
  • Um jede URL abzugleichen, die das Wort blog enthält, können Sie .*blog.* verwenden.

Sie können in Weiterleitung nach oder Ersatz auf die Erfassungsgruppen mit $1, $2, ... verweisen oder mit $0, um auf die gesamte Übereinstimmung zu verweisen.

RedirectWeb wird von der Regex-Engine von Apple angetrieben.

Weitere Informationen zur Regex-Syntax finden Sie in Ressourcen wie RegExr.