Skip to main content

Sääntöasetukset

Tällä sivulla on yksityiskohtaista tietoa jokaisesta asetuksesta RedirectWeb-sovelluksen Muokkaa sääntöä -näytössä.

Valinnat

Tyyppi

Määritä Tyyppi-valinta hallitaksesi sitä, miten sovellus käsittelee uudelleenohjausta. Voit valita seuraavista:

  • Alkuperäinen (Oletus)
    • Tämä käyttää perinteisiä Web-rajapintoja (API) uudelleenohjauksen hallintaan. Lisäksi se käyttää Tabs-rajapintaa varajärjestelmänä.
    • Voit käyttää kaikkia muita valintoja paitsi Resurssityyppejä ja Pyyntömenetelmiä.
    • ⚠️ Tämä on hitaampi kuin Deklaratiivinen tyyppi ja saattaa aiheuttaa ylimääräisiä verkkopyyntöjä.
  • DNR (Kokeellinen Safarille):
    • Tämä tyyppi toimii huomattavasti nopeammin kuin Alkuperäinen tyyppi, koska se ei aloita verkkopyyntöä alkuperäiseen URL-osoitteeseen.
    • Tämän avulla voit määrittää Resurssityypit ja Pyyntömenetelmät.
    • ⚠️ Joitakin valintoja ei voi käyttää, kuten Sieppausryhmien käsittelyä ja Poissuljettuja URL-malleja, koska DNR-rajapinta ei vielä tue niitä.
    • ⚠️ Safarissa säännöllisen lausekkeen (Regular Expression) kuvio ei tällä hetkellä voi sisältää putkimerkkejä (|). Lisätietoja
    • ⚠️ Koska Safarin DNR-rajapinnassa on edelleen joitakin ongelmia, pidämme sitä edelleen kokeellisena ominaisuutena Safarille. Löydät listan kaikista tunnetuista ongelmista täältä.

Uudelleenohjaa kohteesta

Uudelleenohjaa kohteesta -valinnan avulla voit määrittää niiden verkkosivujen URL-mallin, joilta haluat uudelleenohjata. Voit valita joko Jokerimerkin tai Säännöllisen lausekkeen.

Esimerkiksi, jos määrität Jokerimerkillä https://example.com/*, se vastaa osoitteita https://example.com/ tai https://example.com/hello.

note

Uudelleenohjaa kohteeseen -valinnassa voit viitata koko osumaan käyttämällä $0 tai osittaisiin osumiin käyttämällä $1, $2, ... Katso yksityiskohdat tämän sivun kohdasta URL-malli.

Resurssityypit

Tuetut tyypit: DNR

Resurssityypit-valinnan avulla voit määrittää verkkopyyntöjen luokat, kuten kuvat, JavaScript-tiedostot ja tyylitiedostot, joihin sääntöä sovelletaan. Esimerkiksi, jos asetat arvoksi script, voit uudelleenohjata verkkosivujen lataamat JavaScript-tiedostot.

Tällä hetkellä saatavilla olevat: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Oletusasetus on main_frame, joka on välilehdelle ladattu ylimmän tason sivu.

Tarkista kunkin resurssityypin yksityiskohdat MDN-dokumentaatiosta.

Pyyntömenetelmät

Tuetut tyypit: DNR

Pyyntömenetelmät-valinnan avulla voit asettaa lähde-URL-osoitteen kohteena olevat HTTP-menetelmät.

Kaikki menetelmät on asetettu oletuksena.

Tarkista kunkin menetelmän yksityiskohdat MDN-dokumentaatiosta.

warning

Safarissa tämä valinta ei välttämättä ole käytettävissä, koska Applen DNR-tyypin toteutus ei näytä tällä hetkellä käsittelevän sitä. Olemme lähettäneet tästä palautetta Applelle (tunnus FB14502272).

Kohdeselaimet

Tuetut alustat: macOS

Kohdeselaimet-valinnan avulla voit määrittää, mihin selaimeen sääntöä sovelletaan tai ei sovelleta.

  • Voit valita kahdentyyppisiä selaimia:
    • Oletuksena valittavissa olevat selaimet: Voit valita oletuksena Safarin, Chromen, Firefoxin, Edgen, Operan, Arcin, Braven ja Vivaldin. Tämä ei erottele saman selaimen eri variantteja, kuten Safari ja Safari Technology Preview.
    • 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 RedirectWeb-laajennus on asennettu.
  • Kaikki paitsi valitut -valintaruutu mahdollistaa kaikkien muiden selaimien kohdentamisen paitsi niiden, jotka olet valinnut.
warning

RedirectWeb ei pysty erottamaan, onko selain Safari vai Safari Technology Preview, koska sovellus tarkistaa laajennuksen emoprosessin tunnistaakseen sen, mutta nämä kaksi selainta jakavat saman emoprosessin (/sbin/launchd).

Uudelleenohjaa kohteeseen

Uudelleenohjaa kohteeseen -valinta määrittää kohde-URL-osoitteen, johon haluat uudelleenohjata Uudelleenohjaa kohteesta -valinnalla täsmätystä lähde-URL-osoitteesta. Voit myös korvata sieppausryhmiä tunnuksilla $1, $2, ... tai koko osuman tunnuksella $0. Nämä auttavat sinua määrittämään kohteen dynaamisesti. Katso yksityiskohdat tämän sivun kohdasta URL-malli.

Esimerkiksi, jos asetat seuraavan säännön:

  • Uudelleenohjaa kohteesta: https://google.com/* (Jokerimerkki)
  • Uudelleenohjaa kohteeseen: https://apple.com/$1

ja se täsmää osoitteeseen https://google.com/hello, niin kohde-URL-osoite on https://apple.com/hello.

Lisäksi voit muokata tunnusten $1, $2, ... tekstejä ennen korvauksia. Katso lisätietoja osiosta Sieppausryhmien käsittely.

tip

Voit määrittää mukautetun URL-mallin sovelluksen avaamiseksi. Tässä on 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

Tuetut tyypit: Alkuperäinen Tuetut alustat: macOS

Jos haluat määrittää sovelluksen, jolla haluat avata kohde-URL-osoitteen, käytä Sovellus-valintalaatikkoa. Tämä on käytettävissä vain macOS:ssä.

warning

Voit avata vain sovelluksen, joka tukee App Sandboxia. Varmista myös, että sovellus tukee haluamasi URL-osoitteen avaamista.

Sieppausryhmien käsittely

Tuetut tyypit: Alkuperäinen

Sieppausryhmien käsittely -valinnan avulla voit määrittää, miten käsitellään siepattuja ryhmiä, joita voit korvata Uudelleenohjaa kohteeseen -valinnassa tunnuksilla $1, $2...

Näin teet sieppausryhmiä:

  • Jokerimerkki: Merkeillä * ja ? täsmätyt tekstit siepataan automaattisesti.
  • Säännöllinen lauseke: Kuvion sisällä suluilla () täsmätyt tekstit siepataan.

Voit valita yhden tai useamman seuraavista käsittelyistä:

  • URL-koodaus/dekoodaus: Tämä soveltaa prosenttikoodausta tai dekoodausta sieppausryhmään. Esimerkiksi, jos koodaat https://example.com/hello, se muunnetaan muotoon https%3A%2F%2Fexample.com%2Fhello. Dekoodaus toimii päinvastoin.
  • Base64-koodaus/dekoodaus: Tämä dekoodaa/koodaa tekstin Base64-muotoon. Esimerkiksi voit koodata sanan hello muotoon aGVsbG8= ja dekoodata sen takaisin sanaksi hello.
  • Esiintymien korvaaminen: Tämä korvaa yhdessä ryhmässä yhden tai useamman merkin, jotka täsmäävät Kohteeseen, Korvaavalla tekstillä. Esimerkiksi, jos Ryhmä on hello, Kohde on l ja Korvaava teksti on y, se muuttuu muotoon heyyo.
note

Tämä on kunkin sieppausryhmän käsittelyä varten, eikä se vaikuta siihen, mitkä URL-osoitteet on suljettu pois Poissuljetut URL-mallit -asetuksella. Esimerkiksi, jos sinulla on tämä sääntö:

  • Uudelleenohjaa kohteesta: https://example.com/(hello.*)
  • Sieppausryhmien käsittely:
    • Ryhmä: $1
    • Kohde: .* (Säännöllinen lauseke)
    • Korvaava teksti: hello
  • Poissuljettu URL-malli: https://example.com/hello

Tässä tapauksessa https://example.com/hello_world ei ole poissuljettu, kun taas https://example.com/hello on poissuljettu.

Poissuljetut URL-mallit

Tuetut tyypit: Alkuperäinen

Poissuljetut URL-mallit -valinnan avulla voit määrittää URL-osoitteet, joita ei uudelleenohjata. Tämä voi olla hyödyllistä uudelleenohjaussilmukoiden välttämiseksi tai verkkosivuston tiettyjen osien jättämiseksi uudelleenohjauksen ulkopuolelle.

Voit määrittää poissuljetut URL-mallit käyttämällä joko säännöllistä lauseketta tai jokerimerkkimallia.

Esimerkit

Esimerkit-valinnan avulla voit testata uudelleenohjaussääntöäsi antamalla esimerkkiosoitteita. Lisäämällä esimerkkiosoitteen voit tarkistaa, toimiiko sääntö odotetulla tavalla ennen sen varsinaista käyttöönottoa.

Lisäasetukset

  • [DNR] Pääkehyksen uudelleenohjaus: Tämä valinta on käytettävissä vain DNR-tyypille. Sen avulla voit määrittää, miten käsitellään main_frame-resurssityypin uudelleenohjausta. Saatavilla olevat valinnat ovat:
    • Raaka: Ohjaa pääkehyksen määritettyyn URL-osoitteeseen ilman muutoksia.
    • Välisivun kautta: Ohjaa pääkehyksen välisivulle, joka ohjaa sitten määritettyyn kohde-URL-osoitteeseen. Tämä on hyödyllistä sovellusten avaamiseen syvälinkityksen avulla, koska välisivu voi käsitellä monimutkaisempaa uudelleenohjauslogiikkaa.

Kommentit

Kommentit-valinnan avulla voit lisätä huomautuksia tai kommentteja uudelleenohjaussäännöstäsi. Tämä voi olla hyödyllistä sen seuraamiseksi, miksi loit tietyn säännön, tai taustatiedon antamiseksi muille, jotka saattavat tarkastella sääntöjäsi.

Voit kirjoittaa kommentteja seuraavissa muodoissa:

  • Pelkkä teksti (Oletus): Yksinkertaista tekstiä ilman muotoiluja.
  • Markdown: Voit käyttää GitHubin Markdown-syntakseja, mukaan lukien joitakin laajennuksia, joita GFM ei tue. Voit esimerkiksi luoda otsikoita, luetteloita, linkkejä ja muuta.
  • AsciiDoc: Voit käyttää AsciiDoc-syntakseja kommenttiesi muotoiluun.

URL-malli

URL-malleja käytetään URL-osoitteiden täsmäämiseen Uudelleenohjaa kohteesta-, Poissuljetut URL-mallit- ja Sieppausryhmien käsittely -valinnoissa. Voit määrittää ne valitsemalla joko Jokerimerkin tai Säännöllisen lausekkeen.

Jokerimerkki

Jokerimerkki on yksinkertaisempi mallityyppi, jonka avulla voit käyttää merkkejä * (vastaa mitä tahansa) ja ? (vastaa mitä tahansa yksittäistä merkkiä) jokerimerkkeinä. Tässä on joitakin esimerkkejä:

  • Täsmäämään https://example.com/hello, voit käyttää https://example.com/*. Tämä vastaa mitä tahansa merkkijonoa osoitteen https://example.com/ jälkeen.
  • Täsmäämään https://example.com/search?q=hello, voit käyttää https://example.com/search?q=*. Tämä vastaa mitä tahansa arvoa q-parametrille.
  • Täsmäämään minkä tahansa URL-osoitteen, joka sisältää sanan blog, voit käyttää *blog*.

Voit käyttää korvaamista myös jokerimerkkien kanssa, mikä tarkoittaa, että voit viitata täsmätyn URL-osoitteen osiin tunnuksilla $1, $2 jne. Esimerkiksi, jos käytät kuviota https://example.com/*-world-* ja URL on https://example.com/hello-world-goodbye, niin $1 olisi "hello" and $2 olisi "goodbye". $0 on myös käytettävissä viittaamaan koko täsmättyyn URL-osoitteeseen.

note

Vaikka korvaaminen on säännöllisten lausekkeiden ominaisuus, voit käyttää sitä myös jokerimerkkien kanssa, koska RedirectWeb muuntaa jokerimerkit sisäisesti säännöllisiksi lausekkeiksi.

Säännöllinen lauseke

Säännöllinen lauseke (Regex) on tehokas työkalu tekstin kuvioiden täsmäämiseen, ja sitä käytetään laajasti myös ohjelmoinnissa. Sen avulla voit määritellä tietyn kuvion, joka vastaa joukkoa merkkijonoja. Tässä on joitakin esimerkkejä.

  • Täsmäämään https://example.com/hello, voit käyttää https://example.com/.*. Tämä vastaa mitä tahansa merkkijonoa osoitteen https://example.com/ jälkeen.
  • Täsmäämään https://example.com/search?q=hello, voit käyttää https://example.com/search\?q=(.*). Tämä vastaa q-parametrin arvoa ja tallentaa sen sieppausryhmään. Voit sitten viitata siihen käyttämällä $1 Uudelleenohjaa kohteeseen -valinnassa.
  • Täsmäämään minkä tahansa URL-osoitteen, joka sisältää sanan blog, voit käyttää .*blog.*.

Voit viitata sieppausryhmiin kohdissa Uudelleenohjaa kohteeseen tai Korvaava teksti tunnuksilla $1, $2, ... tai tunnuksella $0 viitaten koko osumaan.

RedirectWeb hyödyntää Applen Regex-moottoria.

Lisätietoja Regex-syntaksista löytyy lähteistä kuten RegExr.