Nastavenia pravidiel
Táto stránka poskytuje podrobné informácie o každom nastavení na obrazovke Upraviť pravidlo v aplikácii Redirect Web.
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í:
- Pôvodný (Predvolené)
- Toto používa tradičné webové API na ovládanie presmerovania. Okrem toho používa Tabs API ako záložný mechanizmus.
- 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 Deklaratívne a môže spôsobiť dodatočné sieťové požiadavky.
- Toto používa tradičné webové API na ovládanie presmerovania. Okrem toho používa Tabs API ako záložný mechanizmus.
- DNR (Experimentálne pre Safari):
- Tento typ funguje oveľa rýchlejšie ako pôvodný typ, pretože nespúšťa sieťovú požiadavku pre zdrojovú URL.
- To vám umožňuje špecifikovať Typy zdrojov a Metódy požiadaviek.
- ⚠️ Nemôžete použiť niektoré možnosti, ako napríklad Spracovanie zachytávacej skupiny a Vylúčené vzory URL, pretože zatiaľ nie sú podporované rozhraním DNR API.
- ⚠️ V Safari momentálne nemôžete do vzoru regulárneho výrazu zahrnúť zvislé čiary (
|
). Podrobnosti - ⚠️ Keďže rozhranie DNR API v Safari má stále nejaké problémy, považujeme to 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 zadať vzor URL webových stránok, z ktorých chcete presmerovať. Môžete si vybrať buď Zástupný znak alebo Regulárny výraz.
Napríklad, ak zadáte https://example.com/*
so zástupným znakom, zhoduje sa s https://example.com/
alebo https://example.com/hello
.
V možnosti Presmerovať na môžete odkazovať na celú zhodu pomocou $0
alebo čiastočné zhody pomocou $1
, $2
, ... Podrobnosti nájdete v Vzore 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, JavaScripty a štýly, na ktoré sa pravidlo vzťahuje.
Napríklad, ak nastavíte script
, môžete presmerovať súbory JavaScriptu načítané webovými stránkami.
Momentálne sú k dispozícii tieto:
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á do karty.
Podrobnosti o každom type zdroja nájdete v 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.
Všetky metódy sú nastavené predvolene.
Podrobnosti o každej metóde nájdete v mdn web docs.
V Safari táto možnosť nemusí byť k dispozícii, pretože implementácia spoločnosti Apple pre typ DNR ju momentálne zrejme nepodporuje. Spoločnosti Apple sme poslali spätnú väzbu 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 použiť.
- 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. Toto nerozlišuje varianty rovnakého prehliadača, ako napríklad Safari a Safari Technology Preview.
- Používateľom zadané prehliadače: Klepnutím na tlačidlo Pridať v kontextovom okne môžete vybrať ľubovoľný prehliadač okrem Safari alebo Safari Technology Preview, ktorý má nainštalované rozšírenie Redirect Web.
- Začiarkavacie políčko Všetky okrem vybraných vám umožňuje zacieliť na každý prehliadač okrem tých, ktoré ste si vybrali.
Redirect Web nedokáže rozlíšiť, či je prehliadač Safari alebo Safari Technology Preview, pretože aplikácia kontroluje rodičovský proces rozšírenia, aby ho zistila, ale tieto dva prehliadače zdieľajú rovnaký rodičovský proces (/sbin/launchd
).
Presmerovať na
Možnosť Presmerovať na určuje cieľovú URL, na ktorú chcete presmerovať zo zdrojovej URL zhodnej s možnosťou Presmerovať z. Môžete tiež nahradiť zachytávacie skupiny pomocou $1
, $2
, ... alebo celú zhodu pomocou $0
. Tieto vám pomôžu dynamicky špecifikovať cieľ. Podrobnosti nájdete v Vzore URL na tejto stránke.
Napríklad, ak nastavíte nasledujúce pravidlo:
- Presmerovať z:
https://google.com/*
(Zástupný znak) - 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 upraviť texty $1
, $2
, ... pred vykonaním náhrad. Podrobnosti nájdete v sekcii Spracovanie zachytávacej skupiny.
Môžete zadať vlastnú schému URL na otvorenie aplikácie. Toto sú príklady aplikácií, ktoré podporujú hlboké prepojenie:
- 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
Aplikácia
Ak chcete zadať aplikáciu, ktorou chcete otvoriť cieľovú URL, použite rozbaľovacie pole Aplikácia. Toto je k dispozícii iba v systéme macOS.
Môžete otvoriť iba aplikáciu, ktorá podporuje App Sandbox. Tiež sa uistite, že aplikácia podporuje otváranie URL, ktorú chcete otvoriť.
Spracovanie zachytávacej skupiny
Možnosť Spracovanie zachytávacej skupiny 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ávacie skupiny:
- Zástupný znak: Texty zhodné s
*
a?
sa automaticky zachytávajú. - Regulárny výraz: Texty zhodné s časťou vzoru vo vnútri
()
sa zachytávajú.
Môžete si vybrať jeden alebo viac z nasledujúcich procesov:
- URL Kódovať/Dekódovať: Toto aplikuje percentuálne kódovanie alebo dekódovanie na zachytávaciu skupinu. Napríklad, ak zakódujete
https://example.com/hello
, prevedie sa nahttps%3A%2F%2Fexample.com%2Fhello
. Dekódovanie funguje opačným spôsobom. - Base64 Kódovať/Dekódovať: Toto dekóduje/kóduje text do Base64. Napríklad, môžete zakódovať
hello
naaGVsbG8=
, a dekódovať ho späť nahello
. - Nahradiť výskyty: Toto nahradí jeden alebo viac znakov v skupine, zhodných s Cieľom, Náhradou. Napríklad, ak je Skupina
hello
a Cieľ jel
a Náhrada jey
, zmení sa naheyyo
.
Toto je na spracovanie každej zachytávacej skupiny a neovplyvňuje, ktoré URL sú vylúčené Vylúčenými vzormi URL. Napríklad, povedzme, že máte toto pravidlo:
- Presmerovať z:
https://example.com/(hello.*)
- Spracovanie zachytávacej skupiny:
- Skupina:
$1
- Cieľ:
.*
(Regulárny výraz) - Náhrada:
hello
- Skupina:
- 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
bude vylúčené.
Vylúčené vzory URL
Možnosť Vylúčené vzory URL vám umožňuje špecifikovať URL, ktoré nie sú presmerované. 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 zadať 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 poskytnutím vzorových URL. Pridaním vzorovej URL môžete skontrolovať, či pravidlo funguje podľa očakávania pred jeho skutočným použitím.
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í by si mohli prezrieť vaše pravidlá.
Komentáre môžete písať v nasledujúcich formátoch:
- Obyčajný text (Predvolené): Jednoduchý text bez formátovania.
- Markdown: Môžete použiť syntax Markdownu GitHubu, vrátane niektorých rozšírení, ktoré GFM nepodporuje. Napríklad môžete 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 zhodu URL v možnostiach Presmerovať z, Vylúčené vzory URL a Spracovanie zachytávacej skupiny. Na ich zadanie si môžete vybrať buď Zástupný znak alebo Regulárny výraz.
Zástupný znak
Zástupný znak je jednoduchší typ vzoru, ktorý vám umožňuje použiť *
(zhoduje sa s čímkoľvek) a ?
(zhoduje sa s ľubovoľným jedným znakom) ako zástupné znaky. Tu sú niektoré príklady:
- Ak chcete zhodovať
https://example.com/hello
, môžete použiťhttps://example.com/*
. Toto sa zhoduje s ľubovoľným reťazcom pohttps://example.com/
. - Ak chcete zhodovať
https://example.com/search?q=hello
, môžete použiťhttps://example.com/search?q=*
. Toto sa zhoduje s ľubovoľnou hodnotou parametraq
. - Ak chcete zhodovať ľubovoľnú URL, ktorá obsahuje slovo
blog
, môžete použiť*blog*
.
Môžete tiež použiť substitúciu v zástupnom znaku, čo znamená, že môžete odkazovať na časti zhodnej URL pomocou $1
, $2
atď. Napríklad, ak 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.
Hoci substitúcia je funkciou regulárneho výrazu, môžete ju použiť aj pre zástupný znak, pretože Redirect Web interne konvertuje zástupný znak na regulárny výraz.
Regulárny výraz
Regulárny výraz (Regex) je výkonný nástroj na zhodu vzorov v texte a je tiež široko používaný v programovaní. Umožňuje vám definovať špecifický vzor, ktorý sa zhoduje so sadou reťazcov. Tu sú niektoré príklady.
- Ak chcete zhodovať
https://example.com/hello
, môžete použiťhttps://example.com/.*
. Toto sa zhoduje s ľubovoľným reťazcom pohttps://example.com/
. - Ak chcete zhodovať
https://example.com/search?q=hello
, môžete použiťhttps://example.com/search\?q=(.*)
. Toto sa zhoduje s hodnotou parametraq
a uloží ju do zachytávacej skupiny. Potom na ňu môžete odkazovať pomocou$1
v možnosti Presmerovať na. - Ak chcete zhodovať ľubovoľnú URL, ktorá obsahuje slovo
blog
, môžete použiť.*blog.*
.
Môžete odkazovať na zachytávacie skupiny v Presmerovať na alebo Náhrada pomocou $1
, $2
, ... alebo $0
na odkazovanie na celú zhodu.
Redirect Web je poháňaný Apple's Regex engine.
Viac informácií o syntaxi Regex nájdete v zdrojoch ako RegExr.