Přeskočit na hlavní obsah

Nastavení pravidel

Tato stránka poskytuje podrobné informace o každém nastavení na obrazovce Upravit pravidlo v aplikaci Redirect Web.

Možnosti​

Typ​

Zadejte možnost Typ pro ovládání způsobu, jakým aplikace zpracovává přesměrování. Můžete si vybrat z těchto možností:

  • Původní (výchozí)
    • Používá tradiční webová API k řízení přesměrování. Navíc používá Tabs API pro záložní řešení.
      • Ve Firefoxu používá WebRequest API k zpracování přesměrování.
    • Můžete použít všechny možnosti kromě Typy zdrojů a Metody požadavků.
    • Toto je pomalejší než typ Deklarativní a může způsobit dodatečné síťové požadavky.
  • DNR (experimentální pro Safari):
    • Tento typ funguje mnohem rychleji než původní typ, protože nespouští síťový požadavek na zdrojovou URL.
    • To vám umožňuje specifikovat Typy zdrojů a Metody požadavků.
    • ⚠️ Některé možnosti, jako například Zpracování zachycené skupiny a Vyloučené vzory URL, nelze použít, protože dosud nebyly podporovány API DNR.
    • ⚠️ V Safari v současné době nemůžete do vzoru regulárního výrazu zahrnout svislítka (|). Podrobnosti
    • ⚠️ Jelikož API DNR v Safari má stále některé problémy, považujeme to stále za experimentální funkci pro Safari. Seznam všech známých problémů naleznete zde.

Přesměrovat z​

Možnost Přesměrovat z vám umožňuje specifikovat vzor URL webových stránek, ze kterých chcete přesměrovat. Můžete si vybrat buď Zástupný znak nebo Regulární výraz.

Například, pokud zadáte https://example.com/* se zástupným znakem, shoduje se s https://example.com/ nebo https://example.com/hello.

note

V možnosti Přesměrovat na můžete odkazovat na celý shodný text pomocí $0 nebo na částečné shody pomocí $1, $2, ... Podrobnosti naleznete v Vzor URL na této stránce.

Typy zdrojů​

Podporované typy: DNR

Možnost Typy zdrojů vám umožňuje specifikovat kategorie webových požadavků, jako jsou obrázky, JavaScripty a styly, na které se pravidlo vztahuje. Například, pokud nastavíte script, můžete přesměrovat soubory JavaScriptu načtené webovými stránkami.

V současné době jsou k dispozici tyto: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Výchozí nastavení je main_frame, což je stránka nejvyšší úrovně načtená do karty.

Podrobnosti o každém typu zdroje naleznete v mdn web docs.

Metody požadavků​

Podporované typy: DNR

Možnost Metody požadavků vám umožňuje nastavit cílové metody HTTP zdrojové URL.

Ve výchozím nastavení jsou nastaveny všechny metody.

Podrobnosti o každé metodě naleznete v mdn web docs.

warning

V Safari nemusí být tato možnost k dispozici, protože implementace Apple pro typ DNR ji v současné době zřejmě nezpracovává. Odeslali jsme zpětnou vazbu společnosti Apple jako FB14502272.

Cílové prohlížeče​

Podporované platformy: macOS

Možnost Cílové prohlížeče vám umožňuje specifikovat, na který prohlížeč by se pravidlo mělo nebo nemělo vztahovat.

  • Existují 2 typy prohlížečů, které si můžete vybrat:
    • Prohlížeče, které si můžete vybrat ve výchozím nastavení: Ve výchozím nastavení si můžete vybrat Safari, Chrome, Firefox, Edge, Opera, Arc, Brave a Vivaldi. Toto nerozlišuje varianty stejného prohlížeče, jako je Safari a Safari Technology Preview.
    • Uživatelem specifikované prohlížeče: Klepnutím na tlačítko Přidat v rozbalovacím okně můžete vybrat libovolný prohlížeč kromě Safari nebo Safari Technology Preview, který má nainstalované rozšíření Redirect Web.
  • Zaškrtávací políčko Vše kromě vybraných vám umožňuje cílit na všechny prohlížeče kromě těch, které jste vybrali.
warning

Redirect Web nedokáže rozlišit, zda je prohlížeč Safari nebo Safari Technology Preview, protože aplikace kontroluje nadřazený proces rozšíření, aby to detekovala, ale tyto dva prohlížeče sdílejí stejný nadřazený proces (/sbin/launchd).

Přesměrovat na​

Možnost Přesměrovat na specifikuje cílovou URL, na kterou chcete přesměrovat ze zdrojové URL shodné s možností Přesměrovat z. Můžete také nahradit zachycené skupiny pomocí $1, $2, ... nebo celý shodný text pomocí $0. Tyto pomáhají dynamicky specifikovat cíl. Podrobnosti naleznete v Vzor URL na této stránce.

Například, pokud nastavíte následující pravidlo:

  • Přesměrovat z: https://google.com/* (Zástupný znak)
  • Přesměrovat na: https://apple.com/$1

a shoduje se s https://google.com/hello, pak cílová URL bude https://apple.com/hello.

Navíc můžete upravit texty $1, $2, ... před provedením náhrad. Podrobnosti naleznete v sekci Zpracování zachycené skupiny.

tip

Můžete specifikovat vlastní schéma URL pro otevření aplikace. Toto jsou příklady aplikací, které podporují deep linking:

  • 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

Aplikace​

Podporované typy: Původní Podporované platformy: macOS

Pokud chcete specifikovat aplikaci, ve které chcete otevřít cílovou URL, použijte rozbalovací seznam Aplikace. Toto je k dispozici pouze na macOS.

warning

Můžete otevřít pouze aplikaci, která podporuje App Sandbox. Také se ujistěte, že aplikace podporuje otevírání URL, kterou chcete otevřít.

Zpracování zachycené skupiny​

Podporované typy: Původní

Možnost Zpracování zachycené skupiny vám umožňuje specifikovat, jak zpracovat zachycené skupiny, které můžete nahradit v možnosti Přesměrovat na pomocí $1, $2...

Zde jsou způsoby, jak vytvořit zachycené skupiny:

  • Zástupný znak: Texty shodné s * a ? jsou automaticky zachyceny.
  • Regulární výraz: Texty shodné s částí vzoru uvnitř () jsou zachyceny.

Můžete si vybrat jeden nebo více z následujících procesů:

  • URL Kódovat/Dekódovat: Toto aplikuje procentní kódování nebo dekódování na zachycenou skupinu. Například, pokud zakódujete https://example.com/hello, převede se na https%3A%2F%2Fexample.com%2Fhello. Dekódování funguje opačným způsobem.
  • Base64 Kódovat/Dekódovat: Toto dekóduje/zakóduje text do Base64. Například, můžete zakódovat hello na aGVsbG8= a dekódovat zpět na hello.
  • Nahradit výskyty: Toto nahrazuje jeden nebo více znaků ve skupině, shodných s Cílem, Náhradou. Například, pokud je Skupina hello a Cíl je l a Náhrada je y, změní se na heyyo.
note

Toto je pro zpracování každé zachycené skupiny a neovlivňuje, které URL jsou vyloučeny Vyloučené vzory URL. Například, řekněme, že máte toto pravidlo:

  • Přesměrovat z: https://example.com/(hello.*)
  • Zpracování zachycené skupiny:
    • Skupina: $1
    • Cíl: .* (Regulární výraz)
    • Náhrada: hello
  • Vyloučený vzor URL: https://example.com/hello

V tomto případě https://example.com/hello_world nebude vyloučeno, zatímco https://example.com/hello bude vyloučeno.

Vyloučené vzory URL​

Podporované typy: Původní

Možnost Vyloučené vzory URL vám umožňuje specifikovat URL, které nejsou přesměrovány. To může být užitečné pro zamezení smyček přesměrování nebo pro vyloučení určitých částí webové stránky z přesměrování.

Vyloučené vzory URL můžete specifikovat pomocí typů vzorů Regulární výraz nebo Zástupný znak.

Příklady​

Možnost Příklady vám umožňuje testovat vaše pravidlo přesměrování poskytnutím vzorových URL. Přidáním vzorové URL můžete zkontrolovat, zda pravidlo funguje podle očekávání, než ho skutečně použijete.

Komentáře​

Možnost Komentáře vám umožňuje přidat jakékoli poznámky nebo komentáře k vašemu pravidlu přesměrování. To může být užitečné pro sledování toho, proč jste vytvořili konkrétní pravidlo, nebo pro poskytnutí kontextu pro ostatní, kteří by si vaše pravidla mohli prohlížet.

Komentáře můžete psát v následujících formátech:

  • Prostý text (výchozí): Jednoduchý text bez formátování.
  • Markdown: Můžete použít syntaxe Markdownu GitHubu, včetně některých rozšíření, která GFM nepodporuje. Například můžete vytvářet nadpisy, seznamy, odkazy a další.
  • AsciiDoc: Můžete použít syntaxe AsciiDoc k formátování vašich komentářů.

Vzor URL​

Vzory URL se používají k porovnávání URL v možnostech Přesměrovat z, Vyloučené vzory URL a Zpracování zachycené skupiny. Pro jejich specifikaci si můžete vybrat buď Zástupný znak nebo Regulární výraz.

Zástupný znak​

Zástupný znak je jednodušší typ vzoru, který vám umožňuje používat * (shoduje se s čímkoli) a ? (shoduje se s jakýmkoli jednotlivým znakem) jako zástupné znaky. Zde jsou některé příklady:

  • Pro shodu s https://example.com/hello můžete použít https://example.com/*. Toto se shoduje s jakýmkoli řetězcem po https://example.com/.
  • Pro shodu s https://example.com/search?q=hello můžete použít https://example.com/search?q=*. Toto se shoduje s jakoukoli hodnotou parametru q.
  • Pro shodu s jakoukoli URL, která obsahuje slovo blog, můžete použít *blog*.

Můžete také použít substituci v zástupném znaku, což znamená, že můžete odkazovat na části shodné URL pomocí $1, $2 atd. Například, pokud použijete https://example.com/*-world-* a URL je https://example.com/hello-world-goodbye, pak $1 bude "hello" a $2 bude "goodbye". $0 je také k dispozici pro odkazování na celou shodnou URL.

note

Ačkoli substituce je funkcí regulárního výrazu, můžete ji použít i pro zástupný znak, protože Redirect Web interně převádí zástupný znak na regulární výraz.

Regulární výraz​

Regulární výraz (Regex) je mocný nástroj pro porovnávání vzorů v textu a je také široce používán v programování. Umožňuje vám definovat specifický vzor, který se shoduje se sadou řetězců. Zde jsou některé příklady.

  • Pro shodu s https://example.com/hello můžete použít https://example.com/.*. Toto se shoduje s jakýmkoli řetězcem po https://example.com/.
  • Pro shodu s https://example.com/search?q=hello můžete použít https://example.com/search\?q=(.*). Toto se shoduje s hodnotou parametru q a uloží ji do zachycené skupiny. Poté na ni můžete odkazovat pomocí $1 v možnosti Přesměrovat na.
  • Pro shodu s jakoukoli URL, která obsahuje slovo blog, můžete použít .*blog.*.

Můžete odkazovat na zachycené skupiny v Přesměrovat na nebo Náhrada pomocí $1, $2, ... nebo $0 pro odkazování na celou shodu.

Redirect Web je poháněn Regex enginem Apple.

Více informací o syntaxi Regex naleznete v zdrojích jako RegExr.