Skip to main content

Setări Reguli

Această pagină oferă informații detaliate despre fiecare setare din ecranul Editare Regulă din aplicația RedirectWeb.

Opțiuni​

Tip​

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

  • Original (Implicit)
    • Acesta utilizează API-uri Web tradiționale pentru a controla redirecționarea. În plus, utilizează Tabs API ca rezervă.
      • În Firefox, utilizează WebRequest API pentru a gestiona redirecționarea.
    • Puteți utiliza toate opțiunile, cu excepția Tipuri de Resurse și Metode de Cerere.
    • ⚠️ Acesta 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ă.
    • Acest lucru 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 Capturare și Modele URL Excluse, deoarece acestea nu au fost încă suportate de API-ul DNR.
    • ⚠️ În Safari, în prezent nu puteți include pipe-uri (|) în modelul dumneavoastră de Expresie Regulată. Detalii
    • ⚠️ Deoarece API-ul DNR din Safari are încă unele probleme, considerăm că aceasta este încă o funcție 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 Regulată.

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

note

Î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​

Supported Types: DNR

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

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

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

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

Metode de Cerere​

Supported Types: DNR

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

Toate metodele sunt setate în mod implicit.

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

warning

Î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 sub numărul FB14502272.

Browsere Țintă​

Supported Platforms: macOS

Opțiunea Browsere Țintă vă permite să specificați cărui browser ar trebui sau nu să i 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 Safari, Chrome, Firefox, Edge, Opera, Arc, Brave și Vivaldi în mod implicit. Acest lucru nu diferențiază variantele aceluiași browser, cum ar fi Safari și Safari Technology Preview.
    • Browsere specificate de utilizator: Prin apăsarea butonului Adaugă din popover, puteți selecta orice browser în afară de Safari sau Safari Technology Preview care are instalată extensia RedirectWeb.
  • Caseta de selectare Toate cu excepția celor selectate vă permite să vizați fiecare browser, cu excepția celor pe care le-ați ales.
warning

RedirectWeb 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 înlocui grupurile de capturare cu $1, $2, ... sau întreaga potrivire cu $0. Acestea vă ajută să specificați dinamic destinația. Verificați detaliile în Model URL din 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 face înlocuirile. Verificați secțiunea Procesarea Grupurilor de Capturare pentru detalii.

tip

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​

Supported Types: Original Supported Platforms: macOS

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

warning

Puteți deschide doar 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 Capturare​

Supported Types: Original

Opțiunea Procesarea Grupurilor de Capturare vă permite să specificați modul de procesare a grupurilor capturate pe care le puteți înlocui în opțiunea Redirecționare Către cu $1, $2 ...

Iată cum se creează grupurile de capturare:

  • Wildcard: Textele potrivite cu * și ? are automat capturate.
  • Expresie Regulată: Textele potrivite cu partea din model din interiorul () sunt capturate.

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

  • Codificare/Decodificare URL: Aceasta aplică percent-encoding sau decodificare unui grup de capturare. De exemplu, dacă codificați https://example.com/hello, acesta 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 îl puteți decodifica înapoi în hello.
  • Înlocuirea Aparițiilor: 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, iar Înlocuirea este y, acesta este modificat în heyyo.
note

Aceasta este pentru procesarea fiecărui grup de capturare și nu afectează URL-urile care sunt excluse prin Modele URL Excluse. De exemplu, să presupunem că aveți această regulă:

  • Redirecționare De La: https://example.com/(hello.*)
  • Procesarea Grupurilor de Capturare:
    • Grup: $1
    • Țintă: .* (Expresie Regulată)
    • Î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​

Supported Types: Original

Opțiunea Modele URL Excluse vă permite să specificați URL-urile care nu sunt redirecționate. Acest lucru 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 folosind tipurile de modele Expresie Regulată sau Wildcard.

Exemple​

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

Avansat​

  • [DNR] Redirecționare Cadru Principal: Această opțiune este disponibilă numai pentru tipul DNR. Vă permite să specificați modul de gestionare a redirecționării pentru tipul de resursă main_frame. Opțiunile disponibile sunt:
    • Raw: Redirecționează cadrul principal către URL-ul specificat fără nicio modificare.
    • Prin Pagină Intermediară: Redirecționează cadrul principal către o pagină intermediară, care apoi redirecționează către URL-ul de destinație specificat. Acest lucru este util pentru deschiderea aplicațiilor folosind deep linking, deoarece pagina intermediară poate gestiona o logică de redirecționare mai complexă.

Comentarii​

Opțiunea Comentarii vă permite să adăugați orice note sau comentarii despre regula dumneavoastră de redirecționare. Acest lucru poate fi util pentru a urmări de ce ați creat o anumită regulă sau pentru a oferi context altora care ar putea să vă vizualizeze regulile.

Puteți scrie comentarii în următoarele formate:

  • Text Simplu (Implicit): Text simplu fără nicio formatare.
  • Markdown: Puteți utiliza sintaxele Markdown de la GitHub, inclusiv unele extensii pe care GFM nu le suportă. De exemplu, puteți crea titluri, liste, linkuri și multe altele.
  • AsciiDoc: Puteți utiliza sintaxele AsciiDoc pentru a vă forma comentariile.

Model URL​

Modelele URL sunt folosite pentru a potrivi URL-urile în opțiunile Redirecționare De La, Modele URL Excluse și Procesarea Grupurilor de Capturare. Pentru a le specifica, puteți alege fie Wildcard, fie Expresie Regulată.

Wildcard​

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

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

De asemenea, puteți utiliza înlocuirea și în Wildcard, ceea ce înseamnă că puteți face referire la părți ale URL-ului potrivit folosind $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.

note

Deși înlocuirea este o funcție a Expresiilor Regulate, o puteți utiliza și pentru Wildcard, deoarece RedirectWeb convertește intern Wildcard în Expresie Regulată.

Expresie Regulată​

Expresia Regulată (Regex) este un instrument puternic pentru potrivirea modelelor în text și este, de asemenea, utilizat pe scară largă în programare. Vă permite să definiți un model specific care se potrivește cu un set de șiruri. Iată câteva exemple.

  • Pentru a potrivi https://example.com/hello, puteți utiliza https://example.com/.*. Aceasta va potrivi orice șir după https://example.com/.
  • Pentru a potrivi 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 capturare. Puteți apoi să faceți referire la aceasta folosind $1 în opțiunea Redirecționare Către.
  • Pentru a potrivi orice URL care conține cuvântul blog, puteți utiliza .*blog.*.

Puteți face referire la grupurile de capturare în Redirecționare Către sau Înlocuire folosind $1, $2, ... sau $0 pentru a face referire la întreaga potrivire.

RedirectWeb este bazat pe motorul Regex de la Apple.

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