Setări regulă

Această pagină oferă informații detaliate despre fiecare setare din ecranul Editare regulă din aplicația Redirect Web.

Opțiuni

Tip

Specificați opțiunea Tip pentru a controla modul în care aplicația gestionează redirecționarea. Puteți alege dintre următoarele:

• Original (Implicit)
  • Aceasta utilizează API-uri Web tradiționale pentru a controla redirecționarea. Suplimentar, folosește API-ul Tabs ca soluție de rezervă.
    • În Firefox, utilizează API-ul WebRequest pentru a gestiona redirecționarea.
  • Puteți utiliza toate opțiunile, cu excepția Tipurilor de Resurse și a Metodelor de Cerere.
  • Aceasta este mai lentă decât tipul Declarativ și poate cauza cereri de rețea suplimentare.
• DNR (Experimental pentru Safari):
  • Acest tip funcționează mult mai rapid decât tipul Original, deoarece nu inițiază o cerere de rețea pentru URL-ul sursă.
  • Aceasta vă permite să specificați Tipuri de Resurse și Metode de Cerere.
  • ⚠️ Nu puteți utiliza unele opțiuni, cum ar fi Procesarea Grupurilor de Captură și Modelele URL Excluse, deoarece acestea nu sunt încă acceptate de API-ul DNR.
  • ⚠️ În Safari, în prezent nu puteți include bare verticale (|) în modelul dvs. de Expresie Regulară. Detalii
  • ⚠️ Deoarece API-ul DNR al Safari are încă unele probleme, considerăm că este încă o funcționalitate experimentală pentru Safari. Puteți găsi lista tuturor problemelor cunoscute aici.

Redirecționare de la

Opțiunea Redirecționare de la vă permite să specificați un model URL al paginilor web de la care doriți să redirecționați. Puteți alege fie Wildcard, fie Expresie Regulară.

De exemplu, dacă specificați https://example.com/* cu Wildcard, se va potrivi cu https://example.com/ sau https://example.com/hello.

[!NOTĂ] În opțiunea Redirecționare către, puteți face referire la întreaga potrivire folosind $0 sau la potriviri parțiale folosind $1, $2, ... Verificați detaliile în Model URL pe această pagină.

Tipuri de Resurse

Opțiunea Tipuri de Resurse vă permite să specificați categoriile de cereri web, cum ar fi imagini, scripturi JavaScript și foi de stil, la care se aplică regula. De exemplu, dacă setați script, puteți redirecționa fișierele JavaScript încărcate de paginile web.

În prezent, sunt disponibile următoarele: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Setarea implicită este main_frame, care reprezintă pagina de nivel superior încărcată într-o filă.

Vă rugăm să verificați detaliile fiecărui tip de resursă în documentația web mdn.

Metode de Cerere

Opțiunea Metode de Cerere vă permite să setați metodele HTTP țintă ale URL-ului sursă.

Toate metodele sunt setate implicit.

Vă rugăm să verificați detaliile fiecărei metode în documentația web mdn.

[!ATENȚIE] În Safari, această opțiune s-ar putea să nu fie disponibilă, deoarece implementarea Apple pentru tipul DNR nu pare să o gestioneze în prezent. Am trimis feedback către Apple ca FB14502272.

Browsere Țintă

Opțiunea Browsere Țintă vă permite să specificați căror browsere ar trebui sau nu ar trebui să li se aplice regula.

• Există 2 tipuri de browsere pe care le puteți alege:
  • Browsere pe care le puteți alege implicit: Puteți alege implicit Safari, Chrome, Firefox, Edge, Opera, Arc, Brave și Vivaldi. Aceasta nu diferențiază variantele aceluiași browser, cum ar fi Safari și Safari Technology Preview.
  • Browsere specificate de utilizator: Atingând butonul Adăugare din popover, puteți selecta orice browser, altul decât Safari sau Safari Technology Preview, care are instalată extensia Redirect Web.
• Caseta de bifare Toate, cu excepția celor selectate vă permite să vizați fiecare browser, cu excepția celor alese de dvs.

[!ATENȚIE] Redirect Web nu poate diferenția dacă browserul este Safari sau Safari Technology Preview, deoarece aplicația verifică procesul părinte al extensiei pentru a-l detecta, dar aceste două browsere partajează același proces părinte (/sbin/launchd).

Redirecționare către

Opțiunea Redirecționare către specifică un URL de destinație către care doriți să redirecționați, de la URL-ul sursă potrivit cu opțiunea Redirecționare de la. De asemenea, puteți substitui grupurile de captură cu $1, $2, ... sau întreaga potrivire cu $0. Acestea vă ajută să specificați dinamic destinația. Verificați detaliile în Model URL pe această pagină.

De exemplu, dacă setați următoarea regulă:

• Redirecționare de la: https://google.com/* (Wildcard)
• Redirecționare către: https://apple.com/$1

și se potrivește cu https://google.com/hello, atunci URL-ul de destinație va fi https://apple.com/hello.

În plus, puteți modifica textele $1, $2, ... înainte de a efectua substituții. Verificați secțiunea Procesarea Grupurilor de Captură pentru detalii.

[!SUGESTIE] Puteți specifica o schemă URL personalizată pentru a deschide o aplicație. Acestea sunt exemple de aplicații care suportă 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

Aplicație

Dacă doriți să specificați o aplicație cu care să deschideți URL-ul de destinație, utilizați caseta combinată Aplicație. Aceasta este disponibilă numai pe macOS.

[!ATENȚIE] Puteți deschide numai o aplicație care suportă App Sandbox. De asemenea, asigurați-vă că aplicația suportă deschiderea URL-ului pe care doriți să îl deschideți.

Procesarea Grupurilor de Captură

Opțiunea Procesarea Grupurilor de Captură vă permite să specificați cum să procesați grupurile capturate pe care le puteți substitui în opțiunea Redirecționare către cu $1, $2...

Acestea sunt modurile de a crea grupuri de captură:

• Wildcard: Textele potrivite cu * și ? sunt capturate automat.
• Expresie Regulară: Textele potrivite cu o parte a modelului din interiorul () sunt capturate.

Puteți alege unul sau mai multe dintre următoarele procese:

• Codificare/Decodificare URL: Aceasta aplică codificarea în procente sau decodificarea unui grup de captură. De exemplu, dacă codificați https://example.com/hello, este convertit în https%3A%2F%2Fexample.com%2Fhello. Decodificarea funcționează invers.
• Codificare/Decodificare Base64: Aceasta decodifică/codifică un text în Base64. De exemplu, puteți codifica hello în aGVsbG8=, și decodifica înapoi în hello.
• Înlocuire Apariții: Aceasta înlocuiește unul sau mai multe caractere dintr-un grup, potrivite de o Țintă, cu o Înlocuire. De exemplu, dacă Grupul este hello și Ținta este l și Înlocuirea este y, este modificat în heyyo.

[!NOTĂ] Aceasta este pentru procesarea fiecărui grup de captură și nu afectează URL-urile care sunt excluse de Modelele URL Excluse. De exemplu, să presupunem că aveți această regulă:

• Redirecționare de la: https://example.com/(hello.*)
• Procesarea Grupurilor de Captură:
  • Grup: $1
  • Țintă: .* (Expresie Regulară)
  • Înlocuire: hello
• Model URL Exclus: https://example.com/hello

În acest caz, https://example.com/hello_world nu va fi exclus, în timp ce https://example.com/hello va fi exclus.

Modele URL Excluse

Opțiunea Modele URL Excluse vă permite să specificați URL-urile care nu sunt redirecționate. Aceasta poate fi utilă pentru a evita buclele de redirecționare sau pentru a exclude anumite părți ale unui site web de la redirecționare.

Puteți specifica modele URL excluse utilizând fie tipurile de model Expresie Regulară, fie Wildcard.

Exemple

Opțiunea Exemple vă permite să testați regula de redirecționare oferind URL-uri eșantion. Adăugând un URL eșantion, puteți verifica dacă regula funcționează conform așteptărilor înainte de a o aplica efectiv.

Comentarii

Opțiunea Comentarii vă permite să adăugați note sau comentarii despre regula dvs. de redirecționare. Aceasta poate fi utilă pentru a ține evidența motivului pentru care ați creat o anumită regulă sau pentru a oferi context altor persoane care ar putea vizualiza regulile dvs.

Model URL

Există 3 opțiuni unde puteți specifica unul sau mai multe modele URL: Redirecționare de la, Modele URL Excluse și Procesarea Grupurilor de Captură. Pentru a le specifica, puteți alege fie Wildcard, fie Expresie Regulară.

Wildcard

Wildcard este un tip de model mai simplu care vă permite să utilizați * (se potrivește cu orice) și ? (se potrivește cu orice caracter unic) ca wildcards. Iată câteva exemple:

• Pentru a se potrivi cu https://example.com/hello, puteți utiliza https://example.com/*. Aceasta va potrivi orice șir după https://example.com/.
• Pentru a se potrivi cu https://example.com/search?q=hello, puteți utiliza https://example.com/search?q=*. Aceasta va potrivi orice valoare pentru parametrul q.
• Pentru a se potrivi cu orice URL care conține cuvântul blog, puteți utiliza *blog*.

Puteți utiliza substituția și în Wildcard, ceea ce înseamnă că puteți face referire la porțiuni ale URL-ului potrivit utilizând $1, $2, etc. De exemplu, dacă utilizați https://example.com/*-world-*, iar URL-ul este https://example.com/hello-world-goodbye, atunci $1 ar fi "hello" și $2 ar fi "goodbye". $0 este, de asemenea, disponibil pentru a face referire la întregul URL potrivit.

[!Notă] Deși substituția este o caracteristică a Expresiei Regulate, o puteți utiliza și pentru Wildcard, deoarece Redirect Web convertește intern Wildcard în Expresie Regulară.

Expresie Regulară

Expresia Regulară (Regex) este un instrument puternic pentru potrivirea modelelor în text, propulsat de motorul de expresii regulate al Apple, descris aici. Vă permite să definiți un model specific care se potrivește cu un set de șiruri. Iată câteva exemple.

• Pentru a se potrivi cu https://example.com/hello, puteți utiliza https://example.com/(.*). Aceasta va potrivi orice șir după https://example.com/ și îl va stoca într-un grup de captură.
• Pentru a se potrivi cu https://example.com/search?q=hello, puteți utiliza https://example.com/search\?q=(.*). Aceasta va potrivi valoarea parametrului q și o va stoca într-un grup de captură.
• Pentru a se potrivi cu orice URL care conține cuvântul blog, puteți utiliza .*blog.*.

Puteți face referire la grupurile de captură în Redirecționare către sau Înlocuire utilizând $1, $2, ... sau $0 pentru a face referire la întreaga potrivire.

Mai multe informații despre sintaxa Regex pot fi găsite în resurse precum RegExr.