Sääntöasetukset
Tämä sivu tarjoaa yksityiskohtaista tietoa jokaisesta asetuksesta Redirect Web -sovelluksen Muokkaa sääntöä -näytössä.
Asetukset
Tyyppi
Määritä Tyyppi-asetus hallitaksesi, miten sovellus käsittelee uudelleenohjausta. Voit valita näistä:
- Alkuperäinen (oletus)
- Tämä käyttää perinteisiä Web API -rajapintoja uudelleenohjauksen hallintaan. Lisäksi se käyttää Tabs APIa vararatkaisuna.
- Firefoxissa se käyttää WebRequest APIa uudelleenohjauksen käsittelyyn.
- Voit käyttää kaikkia muita vaihtoehtoja paitsi Resurssityypit ja Pyynnön menetelmät.
- Tämä on hitaampi kuin Deklaratiivinen tyyppi ja voi aiheuttaa ylimääräisiä verkkopyyntöjä.
- Tämä käyttää perinteisiä Web API -rajapintoja uudelleenohjauksen hallintaan. Lisäksi se käyttää Tabs APIa vararatkaisuna.
- DNR (kokeellinen Safarille):
- Tämä tyyppi toimii paljon nopeammin kuin alkuperäinen tyyppi, koska se ei käynnistä verkkopyyntöä lähde-URL-osoitteelle.
- Tämän avulla voit määrittää Resurssityypit ja Pyynnön menetelmät.
- ⚠️ Et voi käyttää joitain vaihtoehtoja, kuten Sieppausryhmän käsittely ja Poissuljetut URL-kuviot, koska DNR API ei ole vielä tukenut niitä.
- ⚠️ Safarissa et voi tällä hetkellä sisällyttää putkia (
|) säännölliseen lausekekuvioosi. Tarkemmat tiedot - ⚠️ Koska Safarin DNR API:ssa on edelleen joitain ongelmia, pidämme sitä edelleen kokeellisena ominaisuutena Safarille. Voit löytää luettelon kaikista tunnetuista ongelmista täältä.
Uudelleenohjaa kohteesta
Uudelleenohjaa kohteesta -asetuksen avulla voit määrittää verkkosivujen URL-kuvion, josta haluat uudelleenohjata. Voit valita joko Wildcard tai Säännöllinen lauseke.
Esimerkiksi, jos määrität https://example.com/* Wildcardilla, se vastaa https://example.com/ tai https://example.com/hello.
Uudelleenohjaa kohteeseen -asetuksessa voit viitata koko vastaavuuteen käyttämällä $0 tai osittaisiin vastaavuuksiin käyttämällä $1, $2, ... Tarkista yksityiskohdat URL-kuvio -osiosta tällä sivulla.
Resurssityypit
The Resurssityypit-asetuksen avulla voit määrittää verkkopyyntöjen luokat, kuten kuvat, JavaScriptit ja tyylisivut, joihin sääntöä sovelletaan.
Esimerkiksi, jos asetat script, voit uudelleenohjata verkkosivujen lataamat JavaScript-tiedostot.
Tällä hetkellä nämä ovat saatavilla:
main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other
The default setting is main_frame, which is the top-level page loaded into a tab.
Please check the details of each resource type in mdn web docs.
Pyynnön menetelmät
The Pyynnön menetelmät -asetuksen avulla voit määrittää lähde-URL-osoitteen HTTP-menetelmät.
All methods are set by default.
Please check the details of each method in mdn web docs.
Safarissa tämä vaihtoehto ei välttämättä ole käytettävissä, koska Applen DNR-tyypin toteutus ei näytä käsittelevän sitä tällä hetkellä. Lähetimme palautetta Applelle FB14502272:na.
Kohdeselaimet
The Kohdeselaimet-asetuksen avulla voit määrittää, mihin selaimeen sääntöä tulisi tai ei tulisi soveltaa.
- Voit valita kahden tyyppisiä selaimia:
- Selaimet, jotka voit valita oletuksena: Voit valita oletuksena Safarin, Chromen, Firefoxin, Edgen, Operan, Arcin, Braven ja Vivaldin. Tämä ei erottele saman selaimen variantteja, kuten Safaria ja Safari Technology Preview'ta.
- Käyttäjän määrittämät selaimet: Napauttamalla Lisää-painiketta ponnahdusikkunassa voit valita minkä tahansa muun selaimen kuin Safarin tai Safari Technology Preview'n, johon Redirect Web -laajennus on asennettu.
- Kaikki paitsi valitut -valintaruudun avulla voit kohdistaa kaikkiin selaimiin paitsi valitsemiisi.
Redirect Web ei pysty erottamaan, onko selain Safari vai Safari Technology Preview, koska sovellus tarkistaa laajennuksen pääprosessin havaitakseen sen, mutta nämä kaksi selainta jakavat saman pääprosessin (/sbin/launchd).
Uudelleenohjaa kohteeseen
Uudelleenohjaa kohteeseen -asetus määrittää kohde-URL-osoitteen, johon haluat uudelleenohjata lähde-URL-osoitteesta, joka vastaa Uudelleenohjaa kohteesta -asetusta. Voit myös korvata sieppausryhmät $1, $2, ... tai koko vastaavuuden $0:lla. Nämä auttavat sinua määrittämään kohteen dynaamisesti. Tarkista yksityiskohdat URL-kuvio -osiosta tällä sivulla.
Esimerkiksi, jos asetat seuraavan säännön:
- Uudelleenohjaa kohteesta:
https://google.com/*(Wildcard) - Uudelleenohjaa kohteeseen:
https://apple.com/$1
ja se vastaa https://google.com/hello, niin kohde-URL-osoite on https://apple.com/hello.
Lisäksi voit muokata tekstejä $1, $2, ... ennen korvausten tekemistä. Tarkista Sieppausryhmän käsittely -osio yksityiskohtia varten.
Voit määrittää mukautetun URL-skeeman sovelluksen avaamiseksi. Nämä ovat esimerkkejä sovelluksista, jotka tukevat syvälinkitystä:
- 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
Sovellus
Jos haluat määrittää sovelluksen, johon haluat avata kohde-URL-osoitteen, käytä Sovellus-yhdistelmäruutua. Tämä on käytettävissä vain macOS:ssä.
Voit avata vain sovelluksen, joka tukee App Sandboxia. Varmista myös, että sovellus tukee haluamasi URL-osoitteen avaamista.
Sieppausryhmän käsittely
The Sieppausryhmän käsittely -asetuksen avulla voit määrittää, miten käsitellään siepattuja ryhmiä, jotka voit korvata Uudelleenohjaa kohteeseen -asetuksessa $1, $2...
Näin sieppausryhmät tehdään:
- Wildcard:
*:lla ja?:llä vastaavat tekstit siepataan automaattisesti. - Säännöllinen lauseke: Tekstit, jotka vastaavat kuvion osaa
()sisällä, siepataan.
Voit valita yhden tai useamman seuraavista prosesseista:
- URL-koodaus/dekoodaus: Tämä soveltaa prosenttikoodausta tai dekoodausta sieppausryhmään. Esimerkiksi, jos koodaat
https://example.com/hello, se muunnetaan muotoonhttps%3A%2F%2Fexample.com%2Fhello. Dekoodaus toimii päinvastoin. - Base64-koodaus/dekoodaus: Tämä dekoodaa/koodaa tekstin Base64 -muotoon. Esimerkiksi voit koodata
hello:naGVsbG8=:ksi ja dekoodata sen takaisinhello:ksi. - Korvaa esiintymät: Tämä korvaa yhden tai useamman merkin ryhmässä, joka vastaa Kohdetta, Korvaavalla merkillä. Esimerkiksi, jos Ryhmä on
helloja Kohde onlja Korvaava ony, se muunnetaan muotoonheyyo.
Tämä on tarkoitettu kunkin sieppausryhmän käsittelyyn, eikä se vaikuta siihen, mitkä URL-osoitteet suljetaan pois Poissuljetut URL-kuviot -asetuksella. Esimerkiksi, oletetaan, että sinulla on tämä sääntö:
- Uudelleenohjaa kohteesta:
https://example.com/(hello.*) - Sieppausryhmän käsittely:
- Ryhmä:
$1 - Kohde:
.*(Säännöllinen lauseke) - Korvaava:
hello
- Ryhmä:
- Poissuljettu URL-kuvio:
https://example.com/hello
Tässä tapauksessa https://example.com/hello_world ei suljeta pois, kun taas https://example.com/hello suljetaan pois.
Poissuljetut URL-kuviot
The Poissuljetut URL-kuviot -asetuksen avulla voit määrittää URL-osoitteet, joita ei uudelleenohjata. Tämä voi olla hyödyllistä uudelleenohjaussilmukoiden välttämiseksi tai tiettyjen verkkosivuston osien poissulkemiseksi uudelleenohjauksesta.
Voit määrittää poissuljetut URL-kuviot käyttämällä joko säännöllisiä lausekkeita tai Wildcard-kuviotyyppejä.
Esimerkit
The Esimerkit-asetuksen avulla voit testata uudelleenohjaussääntöäsi antamalla esimerkkisivuja. Lisäämällä esimerkkisivun voit tarkistaa, toimiiko sääntö odotetusti ennen sen todellista soveltamista.
Kommentit
The Kommentit-asetuksen avulla voit lisätä muistiinpanoja tai kommentteja uudelleenohjaussääntöösi. Tämä voi olla hyödyllistä, kun haluat pitää kirjaa siitä, miksi loit tietyn säännön, tai tarjota kontekstia muille, jotka saattavat tarkastella sääntöjäsi.
You can write comments in the following formats:
- Pelkkä teksti (oletus): Yksinkertainen teksti ilman muotoilua.
- Markdown: Voit käyttää GitHubin Markdown-syntakseja, mukaan lukien joitain laajennuksia, joita GFM ei tue. Esimerkiksi voit luoda otsikoita, luetteloita, linkkejä ja paljon muuta.
- AsciiDoc: Voit käyttää AsciiDoc-syntakseja kommenttiesi muotoiluun.
URL-kuvio
URL-kuvioita käytetään URL-osoitteiden vastaavuuteen Uudelleenohjaa kohteesta, Poissuljetut URL-kuviot ja Sieppausryhmän käsittely -asetuksissa. Voit määrittää ne valitsemalla joko Wildcard tai Säännöllinen lauseke.
Wildcard
Wildcard on yksinkertaisempi kuviotyyppi, jonka avulla voit käyttää * (vastaa mitä tahansa) ja ? (vastaa mitä tahansa yksittäistä merkkiä) yleismerkkeinä. Tässä muutamia esimerkkejä:
- Vastaamaan
https://example.com/hello, voit käyttäähttps://example.com/*. Tämä vastaa mitä tahansa merkkijonoahttps://example.com/jälkeen. - Vastaamaan
https://example.com/search?q=hello, voit käyttäähttps://example.com/search?q=*. Tämä vastaa mitä tahansaq-parametrin arvoa. - Vastaamaan mitä tahansa URL-osoitetta, joka sisältää sanan
blog, voit käyttää*blog*.
Voit käyttää myös korvausta Wildcardissa, mikä tarkoittaa, että voit viitata vastaavan URL-osoitteen osiin käyttämällä $1, $2 jne. Esimerkiksi, jos käytät https://example.com/*-world-*, ja URL-osoite on https://example.com/hello-world-goodbye, niin $1 olisi "hello" ja $2 olisi "goodbye". $0 on myös käytettävissä viittaamaan koko vastaavaan URL-osoitteeseen.
Vaikka korvaus on säännöllisen lausekkeen ominaisuus, voit käyttää sitä myös Wildcardissa, koska Redirect Web muuntaa Wildcardin sisäisesti säännölliseksi lausekkeeksi.
Säännöllinen lauseke
Säännöllinen lauseke (Regex) on tehokas työkalu tekstin kuvioiden vastaavuuteen, ja sitä käytetään laajalti myös ohjelmoinnissa. Sen avulla voit määrittää tietyn kuvion, joka vastaa merkkijonojen joukkoa. Tässä muutamia esimerkkejä.
- Vastaamaan
https://example.com/hello, voit käyttäähttps://example.com/.*. Tämä vastaa mitä tahansa merkkijonoahttps://example.com/jälkeen. - Vastaamaan
https://example.com/search?q=hello, voit käyttäähttps://example.com/search\?q=(.*). Tämä vastaaq-parametrin arvoa ja tallentaa sen sieppausryhmään. Voit sitten viitata siihen käyttämällä$1Uudelleenohjaa kohteeseen -asetuksessa. - Vastaamaan mitä tahansa URL-osoitetta, joka sisältää sanan
blog, voit käyttää.*blog.*.
Voit viitata sieppausryhmiin Uudelleenohjaa kohteeseen tai Korvaava -asetuksissa käyttämällä $1, $2, ... tai $0 viittaamaan koko vastaavuuteen.
Redirect Web käyttää Applen Regex-moottoria.
Lisätietoja Regex-syntaksista löytyy resursseista, kuten RegExr.