Reegli seaded

See leht pakub üksikasjalikku teavet iga seade kohta RedirectWeb rakenduse Edit Rule (Muuda reeglit) ekraanil.

Valikud

Tüüp

Määrake suvand Tüüp, et määrata, kuidas rakendus ümbersuunamist käsitleb. Valida saate järgmiste vahel:

• Algne (Original, Vaikimisi)
  • See kasutab ümbersuunamise juhtimiseks traditsioonilisi veebi API-sid. Lisaks kasutab see Tabs API-t varulahendusena.
    • Firefoxis kasutab see ümbersuunamise käitlemiseks WebRequest API-t.
  • Saate kasutada kõiki suvandeid peale Ressursitüüpide ja Päringumeetodite.
  • ⚠️ See on aeglasem kui DNR tüüp ja võib põhjustada täiendavaid võrgupäringuid.
• DNR (Eksperimentaalne Safari jaoks):
  • See tüüp töötab palju kiiremini kui algne tüüp, kuna see ei alusta võrgupäringut algse URL-i jaoks.
  • See võimaldab teil määrata Ressursitüübid ja Päringumeetodid.
  • ⚠️ Mõningaid suvandeid, näiteks Haaramisgruppide töötlemist ja Välistatud URL-mustreid, ei saa kasutada, kuna DNR API ei toeta neid veel.
  • ⚠️ Safaris ei saa praegu oma regulaaravaldise mustrisse lisada püstkriipse (|). Detailid
  • ⚠️ Kuna Safari DNR API-l on endiselt probleeme, peame seda Safari jaoks eksperimentaalseks funktsiooniks. Kõik teadaolevad probleemid leiate siit.

Ümbersuunamine aadressilt

Suvand Ümbersuunamine aadressilt võimaldab teil määrata URL-mustri veebilehtede jaoks, mida soovite ümber suunata. Valida saab kas metamärgi või regulaaravaldise vahel.

Näiteks kui määrate metamärgiga https://example.com/*, siis see vastab aadressidele https://example.com/ või https://example.com/hello.

teade

Suvandis Ümbersuunamine aadressile saate viidata kogu vastele kasutades $0 või osalistele vastetele kasutades $1, $2, ... Vaadake üksikasju selle lehe jaotisest URL-muster.

Ressursitüübid

Suvand Ressursitüübid võimaldab teil määrata veebipäringute kategooriad, näiteks pildid, JavaScriptid ja stiililehed, millele reegel kehtib. Näiteks kui seate väärtuseks script, saate ümber suunata veebilehtede poolt laaditavad JavaScript-failid.

Praegu on saadaval järgmised: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Vaikeseade on main_frame, ki on vahelehele laaditud kõrgeima taseme leht.

Palun kontrollige iga ressursitüübi üksikasju MDN veebidokumentatsioonist.

Päringumeetodid

Suvand Päringumeetodid võimaldab teil määrata algse URL-i siht-HTTP-meetodid.

Vaikimisi on seatud kõik meetodid.

Palun kontrollige iga meetodi üksikasju MDN veebidokumentatsioonist.

hoiatus

Safaris ei pruugi see suvand saadaval olla, kuna Apple'i DNR-tüübi rakendus ei näi seda praegu käitlevat. Saatsime Apple'ile tagasiside numbriga FB14502272.

Sihtbrauserid

Suvand Sihtbrauserid võimaldab teil määrata, millise brauseri puhul tuleks või ei tuleks reeglit rakendada.

• Valida saab 2 tüüpi brausereid:
  • Vaikimisi valitavad brauserid: Vaikimisi saate valida Safari, Chrome, Firefox, Edge, Opera, Arc, Brave ja Vivaldi. See ei erista sama brauseri variante, näiteks Safari ja Safari Technology Preview.
  • Kasutaja määratud brauserid: Puudutades hüpikaknas nuppu Lisa, saate valida mis tahes brauseri (va Safari või Safari Technology Preview), kuhu on installitud RedirectWebi laiendus.
• Märkeruut Kõik peale valitute võimaldab teil sihtida kõiki brausereid peale nende, mille olete valinud.

hoiatus

RedirectWeb ei suuda eristada, kas brauser on Safari või Safari Technology Preview, kuna rakendus kontrollib selle tuvastamiseks laienduse ülemprotsessi, kuid need kaks brauserit jagavad sama ülemprotsessi (/sbin/launchd).

Ümbersuunamine aadressile

Suvand Ümbersuunamine aadressile määrab sihtkoha URL-i, kuhu soovite suunata suvandiga Ümbersuunamine aadressilt vastavusse viidud algsest URL-ist. Samuti saate asendada haaramisgruppe tähistega $1, $2, ... või kogu vastet tähisega $0. Need aitavad teil sihtkohta dünaamiliselt määrata. Vaadake üksikasju selle lehe jaotisest URL-muster.

Näiteks kui seate järgmise reegli:

• Ümbersuunamine aadressilt: https://google.com/* (Metamärk)
• Ümbersuunamine aadressile: https://apple.com/$1

ja see ühtib aadressiga https://google.com/hello, siis sihtkoha URL on https://apple.com/hello.

Lisaks saate muuta $1, $2, ... tekste enne asenduste tegemist. Üksikasju vaadake jaotisest Haaramisgruppide töötlemine.

nõuanne

Rakenduse avamiseks saate määrata kohandatud URL-skeemi. Need on näited rakendustest, mis toetavad süvaviiteid (deep linking):

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

Rakendus

Kui soovite määrata rakenduse, millega soovid sihtkoha URL-i avada, kasutage valikukasti Rakendus. See on saadaval ainult macOS-is.

hoiatus

Saate avada ainult rakenduse, mis toetab App Sandboxi. Samuti veenduge, et rakendus toetaks URL-i avamist, mida soovite avada.

Haaramisgruppide töötlemine

Suvand Haaramisgruppide töötlemine võimaldab teil määrata, kuidas töödelda haaratud gruppe, mida saate asendada suvandis Ümbersuunamine aadressile tähistega $1, $2...

Haaramisgrupid luuakse järgmiselt:

• Metamärk: Tekstid, mis ühtivad tähistega * ja ?, haaratakse automaatselt.
• Regulaaravaldis: Tekstid, mis ühtivad mustri osaga tähiste () sees, haaratakse.

Saate valida ühe või mitu järgmistest protsessidest:

• URL-i kodeerimine/dekodeerimine: See rakendab haaramisgrupile protsentkodeerimist või dekodeerimist. Näiteks kui kodeerite https://example.com/hello, teisendatakse see kujule https%3A%2F%2Fexample.com%2Fhello. Dekodeerimine toimib vastupidi.
• Base64 kodeerimine/dekodeerimine: See dekodeerib/kodeerib teksti Base64 vormingusse. Näiteks saate kodeerida hello kujule aGVsbG8= ja dekodeerida selle tagasi kujule hello.
• Esinemisjuhtude asendamine: See asendab ühes grupis ühe või mitu märki, mis vastavad Sihtmärgile, Asendusega. Näiteks kui Grupp on hello, Sihtmärk on l ja Asendus on y, muudetakse see kujule heyyo.

teade

See on mõeldud iga haaramisgrupi töötlemiseks ja see ei mõjuta seda, millised URL-id välistatakse suvandiga Välistatud URL-mustrid. Oletame näiteks, et teil on see reegel:

• Ümbersuunamine aadressilt: https://example.com/(hello.*)
• Haaramisgruppide töötlemine:
  • Grupp: $1
  • Sihtmärk: .* (Regulaaravaldis)
  • Asendus: hello
• Välistatud URL-muster: https://example.com/hello

Selles olukorras ei välistata aadressi https://example.com/hello_world, samas kui https://example.com/hello välistatakse.

Välistatud URL-mustrid

Suvand Välistatud URL-mustrid võimaldab teil määrata URL-id, mida ei suunata ümber. See võib olla kasulik ümbersuunamissilmuste vältimiseks või veebisaidi teatud osade ümbersuunamisest välistamiseks.

Välistatud URL-mustreid saate määrata, kasutades kas regulaaravaldise või metamärgi mustritüüpide abil.

Näited

Suvand Näited võimaldab teil testida oma ümbersuunamisreeglit, esitades näidis-URL-e. Lisades näidis-URL-i, saate kontrollida, kas reegel töötab ootuspäraselt, enne selle tegelikku rakendamist.

Advanced

• [DNR] Põhiraami ümbersuunamine: See suvand on saadaval ainult DNR-tüübi jaoks. See võimaldab teil määrata, kuidas käidelda ressursitüübi main_frame ümbersuunamist. Saadaval on järgmised valikud:
  • Toores (Raw): Suunab põhiraami määratud URL-ile ilma muudatusteta.
  • Vahelehe kaudu (Via Intermediate Page): Suunab põhiraami vahelehele, mis seejärel suunab määratud sihtkoha URL-ile. See on kasulik rakenduste avamiseks süvaviidete abil, kuna vaheleht saab käsitleda keerukamat ümbersuunamisloogikat.

Kommentaarid

Suvand Kommentaarid võimaldab teil lisada märkmeid või kommentaare oma ümbersuunamisreegli kohta. See võib olla kasulik meeldetuletuseks, miks te konkreetse reegli lõite, või konteksti pakkumiseks teistele, kes võivad teie reegleid vaadata võivad.

Saate kirjutada kommentaare järgmistes vormingutes:

• Tavaline tekst (Plain Text, Vaikimisi): Lihtne tekst ilma vorminguta.
• Markdown: Saate kasutada GitHubi Markdowni süntaksit, sealhulgas mõningaid laiendusi, mida GFM ei toeta. Näiteks saate luua pealkirju, loendeid, linke ja palju muud.
• AsciiDoc: Kommentaaride vormindamiseks saate kasutada AsciiDoc-i süntaksit.

URL-muster

URL-mustreid kasutatakse URL-ide sobitamiseks suvandites Ümbersuunamine aadressilt, Välistatud URL-mustrid ja Haaramisgruppide 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 metamärkidena tähiseid * (vastab kõigele) ja ? (vastab mis tahes üksikule märgile). Siin on mõned näited:

• Aadressi https://example.com/hello sobitamiseks saate kasutada https://example.com/*. See vastab mis tahes sõnele pärast https://example.com/.
• Aadressi https://example.com/search?q=hello sobitamiseks saate kasutada https://example.com/search?q=*. See vastab parameetri q mis tahes väärtusele.
• Mis tahes sõna blog sisaldava URL-i sobitamiseks saate kasutada *blog*.

Metamärkide puhul saate kasutada ka asendust, mis tähendab, et saate viidata sobitatud URL-i osadele, kasutades tähiseid $1, $2 jne. Näiteks kui kasutate mustrit https://example.com/*-world-* ja URL on https://example.com/hello-world-goodbye, siis $1 oleks "hello" ja $2 oleks "goodbye". Sobitatud URL-ile tervikuna viitamiseks on saadaval ka $0.

teade

Kuigi asendus on regulaaravaldise funktsioon, saate seda kasutada ka metamärkide puhul, kuna RedirectWeb teisendab metamärgid siseselt regulaaravaldisteks.

Regulaaravaldis

Regulaaravaldis (Regex) on võimas tööriist mustrite sobitamiseks tekstis ja seda kasutatakse laialdaselt ka programmeerimises. See võimaldab teil määratleda konkreetse mustri, mis sobitub teatud sõnede hulgaga. Siin on mõned näited.

• Aadressi https://example.com/hello sobitamiseks saate kasutada https://example.com/.*. See vastab mis tahes sõnele pärast https://example.com/.
• Aadressi https://example.com/search?q=hello sobitamiseks saate kasutada https://example.com/search\?q=(.*). See sobitab parameetri q väärtuse ja salvestab selle haaramisgruppi. Seejärel saate sellele viidata suvandis Ümbersuunamine aadressile, kasutades tähist $1.
• Mis tahes sõna blog sisaldava URL-i sobitamiseks saate kasutada .*blog.*.

Haaramisgruppidele saate viidata suvandis Ümbersuunamine aadressile või Asendus, kasutades tähiseid $1, $2, ... või $0 kogu vastele viitamiseks.

RedirectWeb-i toiteallikaks on Apple'i regulaaravaldiste mootor.

Lisateavet regulaaravaldise süntaksi kohta leiate sellistest ressurssidest nagu RegExr.