Noteikumu iestatījumi

Šajā lapā ir sniegta detalizēta informācija par katru iestatījumu lietotnes RedirectWeb ekrānā Rediģēt noteikumu.

Iespējas

Tips

Norādiet opciju Tips, lai kontrolētu, kā lietotne apstrādā pāradresāciju. Varat izvēlēties kādu no šiem:

• Original (Noklusējums)
  • Šis izmanto tradicionālās tīmekļa API, lai kontrolētu pāradresāciju. Papildus tas izmanto Tabs API kā rezerves variantu.
    • Pārlūkprogrammā Firefox tas izmanto WebRequest API, lai apstrādātu pāradresāciju.
  • Varat izmantot visas opcijas, izņemot Resursu tipi un Pieprasījuma metodes.
  • ⚠️ Šis ir lēnāks nekā Declarative tips un var izraisīt papildu tīmekļa pieprasījumus.
• DNR (Eksperimentāls Safari pārlūkam):
  • Šis tips darbojas daudz ātrāk nekā Original tips, jo tas neuzsāk tīmekļa pieprasījumu avota URL.
  • Tas ļauj norādīt Resursu tipus un Pieprasījuma metodes.
  • ⚠️ Jūs nevarat izmantot dažas opcijas, piemēram, Tveršanas grupu apstrāde un Izslēgtie URL paraugi, jo DNR API tās vēl neatbalsta.
  • ⚠️ Safari pārlūkā pašlaik savā regulārās izteiksmes (Regular Expression) paraugā nevar iekļaut caurules (|). Sīkāka informācija
  • ⚠️ Tā kā Safari DNR API joprojām ir dažas problēmas, mēs uzskatām, ka tā joprojām ir eksperimentāla funkcija Safari pārlūkam. Visu zināmo problēmu sarakstu varat atrast šeit.

Pāradresēt no

Opcija Pāradresēt no ļauj norādīt tīmekļa lapu URL paraugu, no kurām vēlaties pāradresēt. Varat izvēlēties vai nu Wildcard, vai Regular Expression.

Piemēram, ja norādāt https://example.com/* ar Wildcard, tas atbilst https://example.com/ vai https://example.com/hello.

note

Opcijā Pāradresēt uz varat atsaukties uz visu atbilstību, izmantojot $0, vai daļējām atbilstībām, izmantojot $1, $2, ... Skatiet sīkāku informāciju sadaļā URL paraugs šajā lapā.

Resursu tipi

Opcija Resursu tipi ļauj norādīt tīmekļa pieprasījumu kategorijas, piemēram, attēlus, JavaScript un stila lapas, kurām tiek piemērots noteikums. Piemēram, ja iestatāt script, varat pāradresēt JavaScript failus, kurus ielādē tīmekļa lapas.

Pašlaik ir pieejami šādi tipi: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Noklusējuma iestatījums ir main_frame, kas ir augstākā līmeņa lapa, kas ielādēta cilnē.

Lūdzu, pārbaudiet katra resursa tipa informāciju mdn web docs.

Pieprasījuma metodes

Opcija Pieprasījuma metodes ļauj iestatīt avota URL mērķa HTTP metodes.

Pēc noklusējuma ir iestatītas visas metodes.

Lūdzu, pārbaudiet katras metodes informāciju mdn web docs.

warning

Safari pārlūkā šī opcija var nebūt pieejama, jo Apple DNR tipa implementācija to pašlaik neapstrādā. Mēs nosūtījām atsauksmi Apple kā FB14502272.

Mērķa pārlūkprogrammas

Opcija Mērķa pārlūkprogrammas ļauj norādīt, kurai pārlūkprogrammai noteikums ir jāpiemēro vai nav jāpiemēro.

• Varat izvēlēties 2 veidu pārlūkprogrammas:
  • Pārlūkprogrammas, kuras varat izvēlēties pēc noklusējuma: Pēc noklusējuma varat izvēlēties Safari, Chrome, Firefox, Edge, Opera, Arc, Brave un Vivaldi. Tas nenodala tās pašas pārlūkprogrammas variantus, piemēram, Safari un Safari Technology Preview.
  • Lietotāja norādītās pārlūkprogrammas: Pieskaroties pogai Pievienot uznirstošajā logā, varat izvēlēties jebkuru pārlūkprogrammu, izņemot Safari vai Safari Technology Preview, kurā ir instalēts RedirectWeb paplašinājums.
• Izvēles rūtiņa Visi, izņemot atlasītos ļauj mērķēt uz katru pārlūkprogrammu, izņemot tās, kuras esat izvēlējies.

warning

RedirectWeb nevar atšķirt, vai pārlūkprogramma ir Safari vai Safari Technology Preview, jo lietotne pārbauda paplašinājuma vecāku procesu, lai to noteiktu, taču šīm divām pārlūkprogrammām ir viens un tas pats vecāku process (/sbin/launchd).

Pāradresēt uz

Opcija Pāradresēt uz norāda galamērķa URL, uz kuru vēlaties pāradresēt no avota URL, kas atbilst opcijai Pāradresēt no. Varat arī aizstāt tveršanas grupas ar $1, $2, ... vai visu atbilstību ar $0. Tie palīdz dinamiski norādīt galamērķi. Skatiet sīkāku informāciju sadaļā URL paraugs šajā lapā.

Piemēram, ja iestatāt šādu noteikumu:

• Pāradresēt no: https://google.com/* (Wildcard)
• Pāradresēt uz: https://apple.com/$1

un tas atbilst https://google.com/hello, tad galamērķa URL būs https://apple.com/hello.

Turklāt pirms aizstāšanas varat modificēt $1, $2, ... tekstus. Sīkāku informāciju skatiet sadaļā Tveršanas grupu apstrāde.

tip

Varat norādīt pielāgotu URL shēmu, lai atvērtu lietotni. Šie ir piemēri lietotnēm, kas atbalsta dziļās saites (deep linking):

• 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

Lietojumprogramma

Ja vēlaties norādīt lietotni, ar kuru vēlaties atvērt galamērķa URL, izmantojot Lietojumprogramma kombinēto lodziņu. Tas ir pieejams tikai macOS.

warning

Varat atvērt tikai tādu lietotni, kas atbalsta App Sandbox. Tāpat pārliecinieties, vai lietotne atbalsta tā URL atvēršanu, kuru vēlaties atvērt.

Tveršanas grupu apstrāde

Opcija Tveršanas grupu apstrāde ļauj norādīt, kā apstrādāt tvertās grupas, kuras varat aizstāt opcijā Pāradresēt uz ar $1, $2...

Lūk, kā izveidot tveršanas grupas:

• Wildcard: Teksti, kas atbilst * un ?, tiek automātiski tverti.
• Regular Expression: Teksti, kas atbilst parauga daļai iekavās (), tiek tverti.

Varat izvēlēties vienu vai vairākus no šiem procesiem:

• URL kodēšana/dekodēšana: Tas piemēro procentuālo kodēšanu vai dekodēšanu tveršanas grupai. Piemēram, ja kodējat https://example.com/hello, tas tiek pārvērsts par https%3A%2F%2Fexample.com%2Fhello. Dekodēšana darbojas pretējā veidā.
• Base64 kodēšana/dekodēšana: Tas dekodē/kodē tekstu Base64 formātā. Piemēram, varat kodēt hello uz aGVsbG8= un atkodēt to atpakaļ uz hello.
• Aizstāt gadījumus: Tas aizstāj vienu vai vairākas rakstzīmes grupā, kurām atbilst Mērķis, ar Aizstājēju. Piemēram, ja Grupa ir hello, Mērķis ir l un Aizstājējs ir y, tas tiek modificēts uz heyyo.

note

Tas ir paredzēts katras tveršanas grupas apstrādei, un tas neietekmē to, kuri URL ir izslēgti ar Izslēgtie URL paraugi. Pieņemsim, ka jums ir šāds noteikums:

• Pāradresēt no: https://example.com/(hello.*)
• Tveršanas grupu apstrāde:
  • Grupa: $1
  • Mērķis: .* (Regular Expression)
  • Aizstājējs: hello
• Izslēgtais URL paraugs: https://example.com/hello

Šajā gadījumā https://example.com/hello_world netiks izslēgts, savukārt https://example.com/hello tiks izslēgts.

Izslēgtie URL paraugi

Opcija Izslēgtie URL paraugi ļauj norādīt URL, kas netiek pāradresēti. Tas var būt noderīgi, lai izvairītos no pāradresācijas cilpām vai izslēgtu noteiktas vietnes daļas no pāradresācijas.

Varat norādīt izslēgtos URL paraugus, izmantojot Regular Expression vai Wildcard paraugu veidus.

Piemēri

Opcija Piemēri ļauj pārbaudīt pāradresācijas noteikumu, norādot parauga URL. Pievienojot parauga URL, varat pārbaudīt, vai noteikums darbojas, kā paredzēts, pirms tā faktiskās piemērošanas.

Papildu

• [DNR] Galvenā rāmja pāradresācija: Šī opcija ir pieejama tikai DNR tipam. Tā ļauj norādīt, kā apstrādāt pāradresāciju main_frame resursa tipam. Pieejamās opcijas ir:
  • Raw: Pāradresē galveno rāmi uz norādīto URL bez jebkādām modifikācijām.
  • Via Intermediate Page: Pāradresē galveno rāmi uz starplapu, kas pēc tam pāradresē uz norādīto galamērāa URL. Tas ir noderīgi lietotņu atvēršanai, izmantojot dziļās saites, jo starplapa var apstrādāt sarežģītāku pāradresācijas loģiku.

Komentāri

Opcija Komentāri ļauj pievienot jebkādas piezīmes vai komentārus par pāradresācijas noteikumu. Tas var būt noderīgi, lai sekotu līdzi tam, kāpēc izveidojāt konkrētu noteikumu, vai sniegtu kontekstu citiem, kuri varētu skatīt jūsu noteikumus.

Komentārus var rakstīt šādos formātos:

• Vienkāršs teksts (Noklusējums): Vienkāršs teksts bez jebkāda formatējuma.
• Markdown: Varat izmantot GitHub Markdown sintakses, tostarp dažus paplašinājumus, kurus GFM neatbalsta. Piemēram, varat izveidot virsrakstus, sarakstus, saites un daudz ko citu.
• AsciiDoc: Varat izmantot AsciiDoc sintakses, lai formatētu komentārus.

URL paraugs

URL paraugi tiek izmantoti, lai saskaņotu URL opcijās Pāradresēt no, Izslēgtie URL paraugi un Tveršanas grupu apstrāde. Lai tos norādītu, varat izvēlēties Wildcard vai Regular Expression.

Wildcard

Wildcard is a simpler pattern type that allows you to use * (matches anything) and ? (matches any single character) as wildcards. Here are some examples:

• Lai saskaņotu https://example.com/hello, varat izmantot https://example.com/*. Tas atbildīs jebkurai virknei pēc https://example.com/.
• Lai saskaņotu https://example.com/search?q=hello, varat izmantot https://example.com/search?q=*. Tas atbildīs jebkurai parametra q vērtībai.
• Lai saskaņotu jebkuru URL, kurā ir vārds blog, varat izmantot *blog*.

Varat arī izmantot aizstāšanu arī Wildcard, kas nozīmē, ka varat atsaukties uz saskaņotā URL daļām, izmantojot $1, $2 utt. Piemēram, ja izmantojat https://example.com/*-world-* un URL ir https://example.com/hello-world-goodbye, tad $1 būtu "hello" un $2 būtu "goodbye". $0 ir pieejams arī, lai atsauktos uz visu saskaņoto URL.

note

Lai gan aizstāšana ir Regular Expression funkcija, varat to izmantot arī Wildcard, jo RedirectWeb iekšēji pārvērš Wildcard par Regular Expression.

Regular Expression

Regular Expression (Regex) ir spēcīgs rīks rakstu saskaņošanai tekstā, un tas tiek plaši izmantots programmēšanā. Tas ļauj definēt konkrētu paraugu, kas atbilst virkņu kopai. Šeit ir daži piemēri.

• Lai saskaņotu https://example.com/hello, varat izmantot https://example.com/.*. Tas atbildīs jebkurai virknei pēc https://example.com/.
• Lai saskaņotu https://example.com/search?q=hello, varat izmantot https://example.com/search\?q=(.*). Tas atbildīs parametra q vērtībai un saglabās to tveršanas grupā. Pēc tam varat uz to atsaukties, izmantojot $1 opcijā Pāradresēt uz.
• Lai saskaņotu jebkuru URL, kurā ir vārds blog, varat izmantot .*blog.*.

Varat atsaukties uz tveršanas grupām Pāradresēt uz vai Aizstājējs, izmantojot $1, $2, ... vai $0, lai atsauktos uz visu atbilstību.

RedirectWeb darbina Apple Regex dzinējs.

Papildinformāciju par Regex sintaksi var atrast tādos resursos kā RegExr.