Reegli seaded
See leht annab üksikasjalikku teavet iga seade kohta Redirect Web rakenduse ekraanil Muuda reeglit.
Valikud
Tüüp
Määrake Tüübi valik, et kontrollida, kuidas rakendus ümbersuunamist käsitleb. Saate valida järgmiste hulgast:
- Algne (vaikimisi)
- See kasutab traditsioonilisi veebi API-sid ümbersuunamise juhtimiseks. Lisaks kasutab see varuvariandina Tabs API-t.
- Firefoxis kasutab see ümbersuunamise käsitlemiseks WebRequest API-t.
- Saate kasutada kõiki valikuid peale ressursitüüpide ja päringumeetodite.
- See on aeglasem kui Deklaratiivne tüüp ja võib põhjustada lisavõrgupäringuid.
- See kasutab traditsioonilisi veebi API-sid ümbersuunamise juhtimiseks. Lisaks kasutab see varuvariandina Tabs API-t.
- DNR (eksperimentaalne Safari jaoks):
- See tüüp töötab palju kiiremini kui algne tüüp, sest see ei algata võrgupäringut lähtekoodi URL-i jaoks.
- See võimaldab teil määrata ressursitüüpe ja päringumeetodeid.
- ⚠️ Te ei saa kasutada mõningaid valikuid, nagu püüdmisrühma töötlemine ja välistatud URL-i mustrid, kuna DNR API ei ole neid veel toetanud.
- ⚠️ Safaris ei saa praegu oma regulaaravaldise mustrisse lisada torusid (
|). Üksikasjad - ⚠️ Kuna Safari DNR API-l on endiselt probleeme, peame seda Safari jaoks endiselt eksperimentaalseks funktsiooniks. Saate leida kõigi teadaolevate probleemide loendi siit.
Suuna ümber alates
Suuna ümber alates valik võimaldab teil määrata veebilehtede URL-i mustri, kust soovite ümbersuunata. Saate valida kas metamärgi või regulaaravaldise.
Näiteks kui määrate metamärgiga https://example.com/*, vastab see https://example.com/ või https://example.com/hello.
Valikus Redirect To saate viidata kogu vastavusele, kasutades $0, või osalistele vastavustele, kasutades $1, $2, ... Kontrollige üksikasju selle lehe jaotises URL-i muster.
Ressursitüübid
Ressursitüüpide valik võimaldab teil määrata veebipäringute kategooriad, nagu pildid, JavaScriptid ja stiililehed, millele reegel kehtib.
Näiteks kui määrate script, saate ümbersuunata veebilehtede laaditud JavaScripti faile.
Praegu on saadaval järgmised:
main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other
Vaikeväärtus on main_frame, mis on vahelehele laaditud ülemise taseme leht.
Palun kontrollige iga ressursitüübi üksikasju mdn veebidokumentides.
Päringumeetodid
Päringumeetodite valik võimaldab teil määrata lähtekoodi URL-i siht-HTTP-meetodid.
Kõik meetodid on vaikimisi määratud.
Palun kontrollige iga meetodi üksikasju mdn veebidokumentides.
Safaris ei pruugi see valik saadaval olla, sest Apple'i DNR-tüübi implementatsioon ei tundu seda praegu käsitlevat. Saatsime Apple'ile tagasisidet kui FB14502272.
Sihtbrauserid
Sihtbrauserite valik võimaldab teil määrata, millisele brauserile reegel peaks või ei peaks kehtima.
- Saate valida 2 tüüpi brausereid:
- Vaikimisi valitavad brauserid: Saate vaikimisi valida Safari, Chrome'i, Firefoxi, Edge'i, Opera, Arci, Brave'i ja Vivaldi. See ei erista sama brauseri variante, nagu Safari ja Safari Technology Preview.
- Kasutaja määratud brauserid: Puudutades hüpikaknas nuppu Lisa, saate valida mis tahes brauseri peale Safari või Safari Technology Preview, millel on Redirect Web laiendus installitud.
- Märkeruut Kõik peale valitud võimaldab teil sihtida kõiki brausereid peale nende, mille olete valinud.
Redirect Web ei suuda eristada, kas brauser on Safari või Safari Technology Preview, sest rakendus kontrollib laienduse vanemprotsessi selle tuvastamiseks, kuid need kaks brauserit jagavad sama vanemprotsessi (/sbin/launchd).
Suuna ümber
Suuna ümber valik määrab siht-URL-i, kuhu soovite ümbersuunata lähtekoodi URL-ist, mis vastab valikule Suuna ümber alates. Saate asendada ka püüdmisrühmi $1, $2, ... või kogu vastavuse $0-ga. Need aitavad teil dünaamiliselt sihtkohta määrata. Kontrollige üksikasju selle lehe jaotises URL-i muster.
Näiteks kui määrate järgmise reegli:
- Suuna ümber alates:
https://google.com/*(metamärk) - Suuna ümber:
https://apple.com/$1
ja see vastab https://google.com/hello, siis siht-URL on https://apple.com/hello.
Lisaks saate muuta $1, $2, ... tekste enne asenduste tegemist. Üksikasjade kohta vaadake jaotist Püüdmisrühma töötlemine.
Saate rakenduse avamiseks määrata kohandatud URL-skeemi. Need on näited rakendustest, mis toetavad sügavat linkimist:
- 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
Rakendus
Kui soovite määrata rakenduse, milles soovite siht-URL-i avada, kasutage rippmenüüd Rakendus. See on saadaval ainult macOS-is.
Saate avada ainult rakenduse, mis toetab App Sandboxi. Samuti veenduge, et rakendus toetab URL-i avamist, mida soovite avada.
Püüdmisrühma töötlemine
Püüdmisrühma töötlemise valik võimaldab teil määrata, kuidas töödelda püüdmisrühmi, mida saate asendada valikus Suuna ümber $1, $2...
Siin on, kuidas püüdmisrühmi luua:
- Metamärk:
*ja?abil vastavad tekstid püüdmistakse automaatselt. - Regulaaravaldis: Mustri osa
()sees vastavad tekstid püüdmistakse.
Saate valida ühe või mitu järgmistest protsessidest:
- URL-i kodeerimine/dekodeerimine: See rakendab püüdmisrühma protsentkodeerimist või dekodeerimist. Näiteks kui kodeerite
https://example.com/hello, teisendatakse seehttps%3A%2F%2Fexample.com%2Fhello-ks. Dekodeerimine töötab vastupidi. - Base64 kodeerimine/dekodeerimine: See dekodeerib/kodeerib teksti Base64-ks. Näiteks saate kodeerida
helloaGVsbG8=-ks ja dekodeerida selle tagasihello-ks. - Asendada esinemised: See asendab ühes või mitmes rühmas, mis vastab sihtmärgile, asendusega. Näiteks kui rühm on
helloja sihtmärk onlja asendus ony, siis see muudetakseheyyo-ks.
See on iga püüdmisrühma töötlemiseks ja see ei mõjuta, millised URL-id on välistatud URL-i mustritega välistatud. Näiteks oletame, et teil on järgmine reegel:
- Suuna ümber alates:
https://example.com/(hello.*) - Püüdmisrühma töötlemine:
- Rühm:
$1 - Sihtmärk:
.*(regulaaravaldis) - Asendus:
hello
- Rühm:
- Välistatud URL-i muster:
https://example.com/hello
Sel juhul https://example.com/hello_world ei välistata, samas kui https://example.com/hello välistatakse.
Välistatud URL-i mustrid
Välistatud URL-i mustrite valik võimaldab teil määrata URL-id, mida ei suunata ümber. See võib olla kasulik ümbersuunamise tsüklite vältimiseks või veebisaidi teatud osade välistamiseks ümbersuunamisest.
Saate määrata välistatud URL-i mustreid kas regulaaravaldise või metamärgi mustritüüpide abil.
Näited
Näidete valik võimaldab teil testida oma ümbersuunamisreeglit, pakkudes näidis-URL-e. Näidis-URL-i lisades saate kontrollida, kas reegel töötab ootuspäraselt, enne kui seda tegelikult rakendate.
Kommentaarid
Kommentaaride valik võimaldab teil lisada oma ümbersuunamisreegli kohta märkmeid või kommentaare. See võib olla kasulik selleks, et jälgida, miks te konkreetse reegli lõite, või anda konteksti teistele, kes teie reegleid vaadata võivad.
Saate kirjutada kommentaare järgmistes vormingutes:
- Lihttekst (vaikimisi): Lihtne tekst ilma vorminduseta.
- Markdown: Saate kasutada GitHubi Markdowni süntakseid, sealhulgas mõningaid laiendusi, mida GFM ei toeta. Näiteks saate luua pealkirju, loendeid, linke ja palju muud.
- AsciiDoc: Saate oma kommentaaride vormindamiseks kasutada AsciiDoc süntakseid.
URL-i muster
URL-i mustreid kasutatakse URL-ide vastendamiseks valikutes Suuna ümber alates, Välistatud URL-i mustrid ja Püüdmisrühma töötlemine. Nende määramiseks saate valida kas metamärgi või regulaaravaldise.
Metamärk
Metamärk on lihtsam mustritüüp, mis võimaldab teil kasutada * (vastab kõigele) ja ? (vastab mis tahes ühele märgile) metamärkidena. Siin on mõned näited:
https://example.com/hellovastendamiseks saate kasutadahttps://example.com/*. See vastab mis tahes stringile pärasthttps://example.com/.https://example.com/search?q=hellovastendamiseks saate kasutadahttps://example.com/search?q=*. See vastab mis tahes väärtuseleqparameetri jaoks.- Mis tahes URL-i vastendamiseks, mis sisaldab sõna
blog, saate kasutada*blog*.
Saate kasutada ka asendust metamärgis, mis tähendab, et saate viidata vastava URL-i osadele, kasutades $1, $2 jne. Näiteks kui kasutate https://example.com/*-world-* ja URL on https://example.com/hello-world-goodbye, siis $1 oleks "hello" ja $2 oleks "goodbye". $0 on samuti saadaval kogu vastava URL-i viitamiseks.
Kuigi asendus on regulaaravaldise funktsioon, saate seda kasutada ka metamärgi jaoks, sest Redirect Web teisendab sisemiselt metamärgi regulaaravaldisesse.
Regulaaravaldis
Regulaaravaldis (Regex) on võimas tööriist tekstis mustrite vastendamiseks ja seda kasutatakse laialdaselt ka programmeerimises. See võimaldab teil määratleda konkreetse mustri, mis vastab stringide kogumile. Siin on mõned näited.
https://example.com/hellovastendamiseks saate kasutadahttps://example.com/.*. See vastab mis tahes stringile pärasthttps://example.com/.https://example.com/search?q=hellovastendamiseks saate kasutadahttps://example.com/search\?q=(.*). See vastabqparameetri väärtusele ja salvestab selle püüdmisrühma. Seejärel saate sellele viidata, kasutades$1valikus Suuna ümber.- Mis tahes URL-i vastendamiseks, mis sisaldab sõna
blog, saate kasutada.*blog.*.
Saate viidata püüdmisrühmi valikus Suuna ümber või Asendus, kasutades $1, $2, ... või $0 kogu vastavuse viitamiseks.
Redirect Web töötab Apple'i Regex mootoriga.
Lisateavet Regexi süntaksi kohta leiate ressurssidest nagu RegExr.