Nastavenia pravidiel

Táto stránka poskytuje podrobné informácie o každom nastavení na obrazovke Upraviť pravidlo v aplikácii RedirectWeb.

Možnosti

Typ

Zadajte možnosť Typ na ovládanie spôsobu, akým aplikácia spracováva presmerovanie. Môžete si vybrať z týchto možností:

• Original (Predvolené)
  • Toto využíva tradičné webové API na ovládanie presmerovania. Okrem toho používa Tabs API ako zálohu.
    • Vo Firefoxe používa WebRequest API na spracovanie presmerovania.
  • Môžete použiť všetky možnosti okrem Typov zdrojov a Metód požiadaviek.
  • ⚠️ Toto je pomalšie ako typ Declarative (DNR) a môže spôsobiť dodatočné sieťové požiadavky.
• DNR (Experimentálne pre Safari):
  • Tento typ funguje oveľa rýchlejšie ako typ Original, pretože neiniciuje sieťovú požiadavku pre zdrojovú URL adresu.
  • Toto vám umožňuje špecifikovať Typy zdrojov a Metódy požiadaviek.
  • ⚠️ Nemôžete použiť niektoré možnosti, ako napríklad Spracovanie zachytávajúcich skupín i Vylúčené vzory URL, pretože ich API DNR zatiaľ nepodporuje.
  • ⚠️ V Safari momentálne nemôžete do vzoru regulárneho výrazu zahrnúť zvislé čiary (|). Podrobnosti
  • ⚠️ Keďže API DNR v Safari má stále určité problémy, považujeme ho za experimentálnu funkciu pre Safari. Zoznam všetkých známych problémov nájdete tu.

Presmerovať z

Možnosť Presmerovať z vám umožňuje špecifikovať vzor URL webových stránok, z ktorých chcete presmerovať. Môžete si vybrať buď Zástupný znak (Wildcard) alebo Regulárny výraz (Regular Expression).

Napríklad, ak špecifikujete https://example.com/* so zástupným znakom, zodpovedá to https://example.com/ alebo https://example.com/hello.

note

V možnosti Presmerovať na sa môžete odkazovať na celú zhodu pomocou $0 alebo na čiastočné zhody pomocou $1, $2, ... Podrobnosti nájdete v časti Vzor URL na tejto stránke.

Typy zdrojov

Možnosť Typy zdrojov vám umožňuje špecifikovať kategórie webových požiadaviek, ako sú obrázky, skripty JavaScript a štýly (CSS), na ktoré sa pravidlo vzťahuje. Napríklad, ak nastavíte script, môžete presmerovať súbory JavaScript načítané webovými stránkami.

Momentálne sú k dispozícii tieto typy: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Predvolené nastavenie je main_frame, čo je stránka najvyššej úrovne načítaná v tabe.

Podrobnosti o každom type zdroja nájdete v dokumentácii mdn web docs.

Metódy požiadaviek

Možnosť Metódy požiadaviek vám umožňuje nastaviť cieľové metódy HTTP zdrojovej URL adresy.

Predvolene sú nastavené všetky metódy.

Podrobnosti o každej metóde nájdete v dokumentácii mdn web docs.

warning

V Safari nemusí byť táto možnosť k dispozícii, pretože implementácia Apple pre typ DNR ju momentálne zrejme nepodporuje. Odoslali sme spätnú väzbu spoločnosti Apple ako FB14502272.

Cieľové prehliadače

Možnosť Cieľové prehliadače vám umožňuje špecifikovať, na ktorý prehliadač sa má alebo nemá pravidlo vzťahovať.

• Môžete si vybrať z 2 typov prehliadačov:
  • Prehliadače, ktoré si môžete vybrať predvolene: Predvolene si môžete vybrať Safari, Chrome, Firefox, Edge, Opera, Arc, Brave a Vivaldi. Nerozlišuje to varianty toho istého prehliadača, ako napríklad Safari a Safari Technology Preview.
  • Prehliadače špecifikované používateľom: Kliknutím na tlačidlo Pridať v popoveri môžete vybrať akýkoľvek iný prehliadač okrem Safari alebo Safari Technology Preview, ktorý má nainštalované rozšírenie RedirectWeb.
• Zaškrtávacie políčko Všetky okrem vybraných vám umožňuje zacieliť na každý prehliadač okrem tých, ktoré ste vybrali.

warning

RedirectWeb nedokáže rozlíšiť, či ide o prehliadač Safari alebo Safari Technology Preview, pretože aplikácia na detekciu kontroluje nadradený proces rozšírenia, ale tieto dva prehliadače zdieľajú rovnaký nadradený proces (/sbin/launchd).

Presmerovať na

Možnosť Presmerovať na špecifikuje cieľovú URL adresu, na ktorú chcete presmerovať zo zdrojovej URL adresy zhodnej s možnosťou Presmerovať z. Môžete tiež nahradiť zachytávajúce skupiny pomocou $1, $2, ... alebo celú zhodu pomocou $0. Tieto vám pomáhajú dynamicky špecifikovať cieľ. Podrobnosti nájdete v časti Vzor URL na tejto stránke.

Napríklad, ak nastavíte nasledujúce pravidlo:

• Presmerovať z: https://google.com/* (Wildcard)
• Presmerovať na: https://apple.com/$1

a zhoduje sa s https://google.com/hello, potom cieľová URL bude https://apple.com/hello.

Okrem toho môžete pred vykonaním nahradenia upraviť texty skupín $1, $2, ... Podrobnosti nájdete v časti Spracovanie zachytávajúcich skupín.

tip

Môžete zadať vlastnú schému URL na otvorenie aplikácie. Tu sú príklady aplikácií, ktoré podporujú deep linking:

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

Aplikácia

Ak chcete špecifikovať aplikáciu, v ktorej chcete otvoriť cieľovú URL adresu, použite výberové pole Aplikácia. Toto je k dispozícii iba v systéme macOS.

warning

Môžete otvoriť iba aplikáciu, ktorá podporuje App Sandbox. Tiež sa uistite, že aplikácia podporuje otvorenie URL adresy, ktorú chcete otvoriť.

Spracovanie zachytávajúcich skupín

Možnosť Spracovanie zachytávajúcich skupín vám umožňuje špecifikovať, ako spracovať zachytené skupiny, ktoré môžete nahradiť v možnosti Presmerovať na pomocou $1, $2...

Takto sa vytvárajú zachytávajúce skupiny:

• Zástupný znak (Wildcard): Texty zhodné s * a ? sa zachytávajú automaticky.
• Regulárny výraz (Regular Expression): Texty zhodné s časťou vzoru vo vnútri () sa zachytávajú.

Môžete si vybrať jeden alebo viacero z nasledujúcich procesov:

• URL Encode/Decode (Kódovanie/Dekódovanie URL): Toto aplikuje percentuálne kódovanie alebo dekódovanie na zachytávajúcu skupinu. Napríklad, ak zakódujete https://example.com/hello, skonvertuje sa na https%3A%2F%2Fexample.com%2Fhello. Dekódovanie funguje opačným spôsobom.
• Base64 Encode/Decode (Kódovanie/Dekódovanie Base64): Toto dekóduje/zakóduje text do formátu Base64. Napríklad môžete zakódovať hello na aGVsbG8= a spätne dekódovať na hello.
• Replace Occurrences (Nahradiť výskyty): Toto nahradí jeden alebo viac znakov v skupine, zhodných s Cieľom (Target), Náhradou (Replacement). Napríklad, ak je Skupina hello a Cieľ je l a Náhrada je y, zmení sa na heyyo.

note

Toto slúži na spracovanie každej zachytávajúcej skupiny a neovplyvňuje to, ktoré URL adresy sú vylúčené pomocou Vylúčených vzorov URL. Povedzme napríklad, že máte toto pravidlo:

• Presmerovať z: https://example.com/(hello.*)
• Spracovanie zachytávajúcich skupín:
  • Skupina: $1
  • Cieľ: .* (Regulárny výraz)
  • Náhrada: hello
• Vylúčený vzor URL: https://example.com/hello

V tomto prípade https://example.com/hello_world nebude vylúčené, zatiaľ čo https://example.com/hello vylúčené bude.

Vylúčené vzory URL

Možnosť Vylúčené vzory URL vám umožňuje špecifikovať URL adresy, ktoré sa nepresmerovávajú. To môže byť užitočné na zabránenie slučkám presmerovania alebo na vylúčenie určitých častí webovej stránky z presmerovania.

Vylúčené vzory URL môžete špecifikovať pomocou typov vzorov Regulárny výraz alebo Zástupný znak.

Príklady

Možnosť Príklady vám umožňuje otestovať vaše pravidlo presmerovania zadaním ukážkových URL adries. Pridaním ukážkovej URL adresy môžete skontrolovať, či pravidlo funguje podľa očakávania, skôr než ho skutočne aplikujete.

Rozšírené

• [DNR] Presmerovanie hlavného rámca (Main Frame Redirection): Táto možnosť je k dispozícii iba pre typ DNR. Umožňuje špecifikovať, ako spracovať presmerovanie pre typ zdroja main_frame. Dostupné možnosti sú:
  • Raw (Surové): Presmeruje hlavný rámec na zadanú URL adresu bez akýchkoľvek úprav.
  • Cez prechodnú stránku (Via Intermediate Page): Presmeruje hlavný rámec na prechodnú stránku, ktorá potom presmeruje na zadanú cieľovú URL adresu. To je užitočné na otváranie aplikácií pomocou deep linkingu, pretože prechodná stránka dokáže spracovať komplexnejšiu logiku presmerovania.

Komentáre

Možnosť Komentáre vám umožňuje pridať akékoľvek poznámky alebo komentáre k vášmu pravidlu presmerovania. To môže byť užitočné na sledovanie toho, prečo ste vytvorili konkrétne pravidlo, alebo na poskytnutie kontextu pre ostatných, ktorí si môžu vaše pravidlá prezerať.

Komentáre môžete písať v nasledujúcich formátoch:

• Obyčajný text (Plain Text) (Predvolené): Jednoduchý text bez akéhokoľvek formátovania.
• Markdown: Môžete použiť syntax Markdown od GitHubu, vrátane niektorých rozšírení, ktoré GFM nepodporuje. Môžete napríklad vytvárať nadpisy, zoznamy, odkazy a ďalšie.
• AsciiDoc: Na formátovanie komentárov môžete použiť syntax AsciiDoc.

Vzor URL

Vzory URL sa používajú na porovnávanie URL adries v možnostiach Presmerovať z, Vylúčené vzory URL a Spracovanie zachytávajúcich skupín. Ak ich chcete špecifikovať, môžete si vybrať buď Zástupný znak (Wildcard) alebo Regulárny výraz (Regular Expression).

Zástupný znak (Wildcard)

Zástupný znak (Wildcard) je jednoduchší typ vzoru, ktorý umožňuje používať * (zodpovedá čomukoľvek) a ? (zodpovedá akémukoľvek jednému znaku) ako zástupné znaky. Tu je niekoľko príkladov:

• Na zhodu s https://example.com/hello môžete použiť https://example.com/*. To bude zodpovedať akémukoľvek reťazcu za https://example.com/.
• Na zhodu s https://example.com/search?q=hello môžete použiť https://example.com/search?q=*. To bude zodpovedať akejkoľvek hodnote parametra q.
• Na zhodu s akoukoľvek URL adresou, ktorá obsahuje slovo blog, môžete použiť *blog*.

Nahradenie môžete použiť aj v type Zástupný znak, čo znamená, že sa môžete odkazovať na časti zhodnej URL adresy pomocou $1, $2 atď. Ak napríklad použijete https://example.com/*-world-* a URL je https://example.com/hello-world-goodbye, potom $1 by bolo "hello" a $2 by bolo "goodbye". $0 je tiež k dispozícii na odkazovanie na celú zhodnú URL adresu.

note

Hoci je nahradenie funkciou Regulárneho výrazu, môžete ho použiť aj pre Zástupný znak, pretože RedirectWeb vnútorne konvertuje Zástupný znak na Regulárny výraz.

Regulárny výraz (Regular Expression)

Regulárny výraz (Regular Expression) (Regex) je výkonný nástroj na porovnávanie vzorov v texte a je tiež široko používaný v programovaní. Umožňuje definovať špecifický vzor, ktorý zodpovedá množine reťazcov. Tu je niekoľko príkladov.

• Na zhodu s https://example.com/hello môžete použiť https://example.com/.*. To bude zodpovedať akémukoľvek reťazcu za https://example.com/.
• Na zhodu s https://example.com/search?q=hello môžete použiť https://example.com/search\?q=(.*). To zachytí hodnotu parametra q a uloží ju do zachytávajúcej skupiny. Potom sa na ňu môžete odkazovať pomocou $1 v možnosti Presmerovať na.
• Na zhodu s akoukoľvek URL adresou, ktorá obsahuje slovo blog, môžete použiť .*blog.*.

Na zachytávajúce skupiny v Presmerovať na alebo Náhrade sa môžete odkazovať pomocou $1, $2, ... alebo $0 na odkazovanie na celú zhodu.

RedirectWeb využíva Regex engine od Apple.

Viac informácií o syntaxi Regex nájdete v zdrojoch ako RegExr.