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 hitaampaa kuin Deklaratiivinen tyyppi ja saattaa aiheuttaa ylimääräisiä verkkopyyntöjä.
• 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ää joitakin 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ää pystyviivoja (|) säännöllisen lausekkeen kuvioosi. Tiedot
  • ⚠️ Koska Safarin DNR APIssa on edelleen joitakin ongelmia, pidämme sitä edelleen kokeellisena ominaisuutena Safarille. Löydät luettelon kaikista tunnetuista ongelmista täältä.

Ohjaa kohteesta

Ohjaa kohteesta -vaihtoehdon avulla voit määrittää URL-kuvion verkkosivuille, joista haluat ohjata uudelleen. Voit valita joko Jokerimerkin tai Säännöllisen lausekkeen.

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

note

Ohjaa kohteeseen -vaihtoehdossa voit viitata koko vastaavuuteen käyttämällä $0 tai osittaisiin vastaavuuksiin käyttämällä $1, $2, ... Katso lisätietoja URL-kuvio -osiosta tällä sivulla.

Resurssityypit

Resurssityypit-vaihtoehdon avulla voit määrittää verkkopyyntöjen luokat, kuten kuvat, JavaScriptit ja tyylisivut, joihin sääntöä sovelletaan. Esimerkiksi, jos asetat script, voit ohjata uudelleen verkkosivujen lataamia JavaScript-tiedostoja.

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

Oletusasetus on main_frame, joka on välilehteen ladattu ylätason sivu.

Tarkista kunkin resurssityypin yksityiskohdat mdn web docs -sivustolta.

Pyynnön menetelmät

Pyynnön menetelmät -vaihtoehdon avulla voit asettaa lähde-URL-osoitteen kohde-HTTP-menetelmät.

Kaikki menetelmät on asetettu oletuksena.

Tarkista kunkin menetelmän yksityiskohdat mdn web docs -sivustolta.

warning

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-tunnuksella.

Kohdeselaimet

Kohdeselaimet-vaihtoehdon 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 kaikki selaimet paitsi ne, jotka olet valinnut.

warning

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).

Ohjaa kohteeseen

Ohjaa kohteeseen -vaihtoehto määrittää kohde-URL-osoitteen, johon haluat ohjata uudelleen lähde-URL-osoitteesta, joka vastaa Ohjaa kohteesta -vaihtoehtoa. Voit myös korvata sieppausryhmät $1, $2, ... tai koko vastaavuuden $0. Nämä auttavat sinua määrittämään kohteen dynaamisesti. Katso lisätietoja URL-kuvio -osiosta tällä sivulla.

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

• Ohjaa kohteesta: https://google.com/* (Jokerimerkki)
• Ohjaa 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 tekstien $1, $2, ... ennen korvauksia. Katso Sieppausryhmän käsittely -osiosta lisätietoja.

tip

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ä.

warning

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

Sieppausryhmän käsittely

The Sieppausryhmän käsittely -vaihtoehdon avulla voit määrittää, miten käsitellään siepattuja ryhmiä, jotka voit korvata Ohjaa kohteeseen -vaihtoehdossa $1, $2...

Näin sieppausryhmät tehdään:

• Jokerimerkki: * ja ? vastaavat tekstit siepataan automaattisesti.
• Säännöllinen lauseke: Kuvion osan sisällä () vastaavat tekstit 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 https%3A%2F%2Fexample.com%2Fhello. Dekoodaus toimii päinvastoin.
• Base64-koodaus/dekoodaus: Tämä dekoodaa/koodaa tekstin Base64 -muotoon. Esimerkiksi, voit koodata hello muotoon aGVsbG8= ja dekoodata sen takaisin muotoon hello.
• Korvaa esiintymät: Tämä korvaa yhden tai useamman merkin ryhmässä, joka vastaa Kohdetta, Korvauksella. Esimerkiksi, jos Ryhmä on hello ja Kohde on l ja Korvaus on y, se muunnetaan muotoon heyyo.

note

Tämä on tarkoitettu kunkin sieppausryhmän käsittelyyn, eikä se vaikuta siihen, mitkä URL-osoitteet jätetään pois Poissuljetut URL-kuviot -kohdasta. Esimerkiksi, oletetaan, että sinulla on tämä sääntö:

• Ohjaa kohteesta: https://example.com/(hello.*)
• Sieppausryhmän käsittely:
  • Ryhmä: $1
  • Kohde: .* (Säännöllinen lauseke)
  • Korvaus: hello
• 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

Poissuljetut URL-kuviot -vaihtoehdon avulla voit määrittää URL-osoitteet, joita ei ohjata uudelleen. 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öllistä lauseketta tai jokerimerkkikuvioita.

Esimerkit

Esimerkit-vaihtoehdon avulla voit testata uudelleenohjaussääntöäsi antamalla esimerkkiosoitteita. Lisäämällä esimerkkiosoitteen voit tarkistaa, toimiiko sääntö odotetusti ennen sen todellista soveltamista.

Kommentit

Kommentit-vaihtoehdon 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.

Voit kirjoittaa kommentteja seuraavissa muodoissa:

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

URL-kuvio

URL-kuvioita käytetään URL-osoitteiden vastaavuuksien etsimiseen Ohjaa kohteesta, Poissuljetut URL-kuviot ja Sieppausryhmän käsittely -vaihtoehdoissa. Voit määrittää ne valitsemalla joko Jokerimerkin tai Säännöllisen lausekkeen.

Jokerimerkki

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

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

Voit käyttää myös korvausta jokerimerkeissä, 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.

note

Vaikka korvaus on säännöllisen lausekkeen ominaisuus, voit käyttää sitä myös jokerimerkeissä, koska Redirect Web muuntaa jokerimerkin sisäisesti säännölliseksi lausekkeeksi.

Säännöllinen lauseke

Säännöllinen lauseke (Regex) on tehokas työkalu kuvioiden vastaavuuksien etsimiseen tekstistä, ja sitä käytetään laajalti myös ohjelmoinnissa. Sen avulla voit määrittää tietyn kuvion, joka vastaa merkkijonojoukkoa. Tässä muutamia esimerkkejä.

• Vastaamaan https://example.com/hello, voit käyttää https://example.com/.*. Tämä vastaa mitä tahansa merkkijonoa https://example.com/ jälkeen.
• Vastaamaan 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 Ohjaa kohteeseen -vaihtoehdossa.
• Vastaamaan mitä tahansa URL-osoitetta, joka sisältää sanan blog, voit käyttää .*blog.*.

Voit viitata sieppausryhmiin Ohjaa kohteeseen tai Korvaus -kohdassa 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.