Reegli seaded
See leht pakub üksikasjalikku teavet iga seadistuse kohta Redirect Web rakenduse reegli redigeerimise ekraanil.
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 kontrollimiseks. Lisaks kasutab see varuvariandina Tabs API-t.
- Firefoxis kasutab see ümbersuunamise käsitlemiseks WebRequest API-t.
- Saate kasutada kõiki valikuid, välja arvatud Ressursitüübid ja Päringumeetodid.
- See on aeglasem kui Deklaratiivne tüüp ja võib põhjustada lisavõrgupäringuid.
- See kasutab traditsioonilisi veebi-API-sid ümbersuunamise kontrollimiseks. Lisaks kasutab see varuvariandina Tabs API-t.
- DNR (Eksperimentaalne Safari jaoks):
- See tüüp töötab palju kiiremini kui algne tüüp, kuna see ei algata lähteaadressi jaoks võrgupäringut.
- See võimaldab teil määrata Ressursitüübid ja Päringumeetodid.
- ⚠️ Te ei saa kasutada mõningaid valikuid, nagu Püüdmisrühma töötlemine ja Välistatud URL-i mustrid, kuna DNR API ei toeta neid veel.
- ⚠️ Safaris ei saa praegu oma regulaaravaldise mustrisse lisada püstkriipse (
|
). Üksikasjad - ⚠️ Kuna Safari DNR API-l on endiselt probleeme, peame seda Safari jaoks endiselt eksperimentaalseks funktsiooniks. Kõigi teadaolevate probleemide loendi leiate siit.
Ümbersuunamine alates
Valik Ümbersuunamine alates võimaldab teil määrata veebilehtede URL-i mustri, millelt soovite ümbersuunata. Saate valida kas Metamärgi või Regulaaravaldise.
Näiteks, kui määrate metamärgiga https://example.com/*
, sobib see https://example.com/
või https://example.com/hello
.
Valikus Ümbersuunamine asukohta saate viidata kogu vastele, kasutades $0
, või osalistele vastetele, kasutades $1
, $2
, ... Vaadake üksikasju selle lehe URL-i mustri jaotises.
Ressursitüübid
Valik Ressursitüübid 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
Vaikimisi on seade main_frame
, mis on vahelehele laaditud ülemise taseme leht.
Palun vaadake iga ressursitüübi üksikasju mdn veebidokumentides.
Päringumeetodid
Valik Päringumeetodid võimaldab teil määrata lähteaadressi siht-HTTP-meetodid.
Kõik meetodid on vaikimisi määratud.
Palun vaadake iga meetodi üksikasju mdn veebidokumentides.
Safaris ei pruugi see valik saadaval olla, kuna Apple'i DNR-tüübi implementatsioon ei tundu seda praegu käsitlevat. Saatsime Apple'ile tagasisidet kui FB14502272.
Sihtbrauserid
Valik Sihtbrauserid võimaldab teil määrata, millisele brauserile reeglit tuleks või ei tohiks rakendada.
- Saate valida 2 tüüpi brausereid:
- Vaikimisi valitavad brauserid: Saate vaikimisi valida Safari, Chrome'i, Firefoxi, Edge'i, Opera, Arc'i, 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 installitud Redirect Web laiendus.
- Märkeruut Kõik peale valitud võimaldab teil sihtida kõiki brausereid, välja arvatud need, mille olete valinud.
Redirect Web ei suuda eristada, kas brauser on Safari või Safari Technology Preview, sest rakendus kontrollib laienduse vanemprotsessi, et seda tuvastada, kuid need kaks brauserit jagavad sama vanemprotsessi (/sbin/launchd
).
Ümbersuunamine asukohta
Valik Ümbersuunamine asukohta määrab siht-URL-i, kuhu soovite ümbersuunata lähteaadressilt, mis sobis valikuga Ümbersuunamine alates. Saate asendada ka püüdmisrühmi $1
, $2
, ... või kogu vaste $0
-ga. Need aitavad teil sihtkohta dünaamiliselt määrata. Vaadake üksikasju selle lehe URL-i mustri jaotises.
Näiteks, kui määrate järgmise reegli:
- Ümbersuunamine alates:
https://google.com/*
(Metamärk) - Ümbersuunamine asukohta:
https://apple.com/$1
ja see sobib https://google.com/hello
, siis siht-URL on https://apple.com/hello
.
Lisaks saate enne asenduste tegemist muuta $1
, $2
, ... tekste. Vaadake üksikasju jaotises Püüdmisrühma töötlemine.
Saate määrata kohandatud URL-skeemi rakenduse avamiseks. Need on näited rakendustest, mis toetavad sügavlinkimist:
- Figma:
figma://file/Teie_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/Teie_Märkme_ID
- Slack:
slack://open
Rakendus
Kui soovite määrata rakenduse, millega 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
Valik Püüdmisrühma töötlemine võimaldab teil määrata, kuidas töödelda püüdmisrühmi, mida saate asendada valikus Ümbersuunamine asukohta $1
, $2
...
Püüdmisrühmi saab luua järgmiselt:
- Metamärk: Tekstid, mis sobivad
*
ja?
-ga, püütakse automaatselt. - Regulaaravaldis: Tekstid, mis sobivad mustri osaga sulgudes
()
, püütakse.
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
hello
aGVsbG8=
-ks ja dekodeerida selle tagasihello
-ks. - Asendada esinemised: See asendab ühes rühmas ühe või mitu märki, mis sobivad Sihtmärgiga, Asendusega. Näiteks, kui Rühm on
hello
ja Sihtmärk onl
ja 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 mustrite abil välistatud. Näiteks, oletame, et teil on see reegel:
- Ümbersuunamine 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
Valik Välistatud URL-i mustrid võimaldab teil määrata URL-id, mida ei ümbersuunata. See võib olla kasulik ümbersuunamissilmuste vältimiseks või veebisaidi teatud osade välistamiseks ümbersuunamisest.
Välistatud URL-i mustreid saate määrata kas regulaaravaldise või metamärgi mustritüüpide abil.
Näited
Valik Näited 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
Valik Kommentaarid 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 pakkuda 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 sobitamiseks valikutes Ümbersuunamine 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 *
(sobib kõigega) ja ?
(sobib mis tahes üksiku märgiga) metamärkidena. Siin on mõned näited:
https://example.com/hello
sobitamiseks saate kasutadahttps://example.com/*
. See sobib mis tahes stringiga pärasthttps://example.com/
.https://example.com/search?q=hello
sobitamiseks saate kasutadahttps://example.com/search?q=*
. See sobib mis tahes väärtusegaq
parameetri jaoks.- Mis tahes URL-i sobitamiseks, mis sisaldab sõna
blog
, saate kasutada*blog*
.
Metamärgis saate kasutada ka asendust, mis tähendab, et saate viidata sobiva 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 sobiva URL-i viitamiseks.
Kuigi asendus on regulaaravaldise funktsioon, saate seda kasutada ka metamärgi jaoks, sest Redirect Web teisendab metamärgi sisemiselt regulaaravaldisesse.
Regulaaravaldis
Regulaaravaldis (Regex) on võimas tööriist tekstis mustrite sobitamiseks ja seda kasutatakse laialdaselt ka programmeerimises. See võimaldab teil määratleda konkreetse mustri, mis sobib stringide kogumiga. Siin on mõned näited.
https://example.com/hello
sobitamiseks saate kasutadahttps://example.com/.*
. See sobib mis tahes stringiga pärasthttps://example.com/
.https://example.com/search?q=hello
sobitamiseks saate kasutadahttps://example.com/search\?q=(.*)
. See sobibq
parameetri väärtusega ja salvestab selle püüdmisrühma. Seejärel saate sellele viidata, kasutades$1
valikus Ümbersuunamine asukohta.- Mis tahes URL-i sobitamiseks, mis sisaldab sõna
blog
, saate kasutada.*blog.*
.
Saate viidata püüdmisrühmi valikus Ümbersuunamine asukohta või Asendus, kasutades $1
, $2
, ... või $0
kogu vaste viitamiseks.
Redirect Web on toetatud Apple'i Regex mootoriga.
Lisateavet Regexi süntaksi kohta leiate ressurssidest nagu RegExr.