Passa al contenuto principale

Impostazioni delle Regole

Questa pagina fornisce informazioni dettagliate su ogni impostazione nella schermata Modifica Regola nell'app Redirect Web.

Opzioni​

Tipo​

Specifica l'opzione Tipo per controllare come l'app gestisce il reindirizzamento. Puoi scegliere tra questi:

  • Originale (Predefinito)
    • Questo utilizza le API Web tradizionali per controllare il reindirizzamento. Inoltre, utilizza l'API Tabs come fallback.
      • In Firefox, utilizza l'API WebRequest per gestire il reindirizzamento.
    • Puoi utilizzare tutte le opzioni tranne Tipi di Risorsa e Metodi di Richiesta.
    • Questo è più lento del tipo Dichiarativo e potrebbe causare richieste di rete aggiuntive.
  • DNR (Sperimentale per Safari):
    • Questo tipo funziona molto più velocemente del tipo Originale perché non avvia una richiesta di rete per l'URL di origine.
    • Questo ti permette di specificare Tipi di Risorsa e Metodi di Richiesta.
    • ⚠️ Non puoi usare alcune opzioni, come Elaborazione Gruppi di Cattura e Pattern URL Esclusi poiché non sono ancora state supportate dall'API DNR.
    • ⚠️ In Safari, attualmente non puoi includere pipe (|) nel tuo pattern di Espressione Regolare. Dettagli
    • ⚠️ Poiché l'API DNR di Safari ha ancora alcuni problemi, consideriamo che sia ancora una funzionalità sperimentale per Safari. Puoi trovare l'elenco di tutti i problemi noti qui.

Reindirizza Da​

L'opzione Reindirizza Da ti consente di specificare un pattern URL delle pagine web da cui desideri reindirizzare. Puoi scegliere tra Carattere Jolly o Espressione Regolare.

Ad esempio, se specifichi https://example.com/* con Carattere Jolly, corrisponderà a https://example.com/ o https://example.com/hello.

note

Nell'opzione Reindirizza A, puoi fare riferimento all'intera corrispondenza usando $0 o a corrispondenze parziali usando $1, $2, ... Controlla i dettagli in Pattern URL in questa pagina.

Tipi di Risorsa​

Tipi Supportati: DNR

L'opzione Tipi di Risorsa ti consente di specificare le categorie di richieste web, come immagini, JavaScript e fogli di stile, a cui si applica la regola. Ad esempio, se imposti script, puoi reindirizzare i file JavaScript caricati dalle pagine web.

Attualmente, sono disponibili: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

L'impostazione predefinita è main_frame, che è la pagina di livello superiore caricata in una scheda.

Si prega di controllare i dettagli di ogni tipo di risorsa nei mdn web docs.

Metodi di Richiesta​

Tipi Supportati: DNR

L'opzione Metodi di Richiesta ti consente di impostare i metodi HTTP di destinazione dell'URL di origine.

Tutti i metodi sono impostati per impostazione predefinita.

Si prega di controllare i dettagli di ogni metodo nei mdn web docs.

warning

In Safari, questa opzione potrebbe non essere disponibile perché l'implementazione di Apple per il tipo DNR non sembra gestirla attualmente. Abbiamo inviato un feedback ad Apple come FB14502272.

Browser di Destinazione​

Piattaforme Supportate: macOS

L'opzione Browser di Destinazione ti consente di specificare a quale browser la regola dovrebbe o non dovrebbe essere applicata.

  • Ci sono 2 tipi di browser che puoi scegliere:
    • Browser che puoi scegliere per impostazione predefinita: Puoi scegliere Safari, Chrome, Firefox, Edge, Opera, Arc, Brave e Vivaldi per impostazione predefinita. Questo non differenzia le varianti dello stesso browser, come Safari e Safari Technology Preview.
    • Browser specificati dall'utente: Toccando il pulsante Aggiungi sul popover, puoi selezionare qualsiasi browser diverso da Safari o Safari Technology Preview che abbia l'estensione Redirect Web installata.
  • La casella di controllo Tutti tranne i selezionati ti consente di scegliere come destinazione tutti i browser tranne quelli che hai scelto.
warning

Redirect Web non può differenziare se il browser è Safari o Safari Technology Preview perché l'app controlla il processo genitore dell'estensione per rilevarlo, ma questi due browser condividono lo stesso processo genitore (/sbin/launchd).

Reindirizza A​

L'opzione Reindirizza A specifica un URL di destinazione a cui desideri reindirizzare, dall'URL di origine corrispondente all'opzione Reindirizza Da. Puoi anche sostituire i gruppi di cattura con $1, $2, ... o l'intera corrispondenza con $0. Questi ti aiutano a specificare dinamicamente la destinazione. Controlla i dettagli in Pattern URL in questa pagina.

Ad esempio, se imposti la seguente regola:

  • Reindirizza Da: https://google.com/* (Carattere Jolly)
  • Reindirizza A: https://apple.com/$1

e corrisponde a https://google.com/hello, allora l'URL di destinazione sarà https://apple.com/hello.

Inoltre, puoi modificare i testi di $1, $2, ... prima di effettuare le sostituzioni. Controlla la sezione Elaborazione Gruppi di Cattura per i dettagli.

suggerimento

Puoi specificare uno schema URL personalizzato per aprire un'app. Questi sono esempi di app che supportano il 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

Applicazione​

Tipi Supportati: Originale Piattaforme Supportate: macOS

Se desideri specificare un'app in cui desideri aprire l'URL di destinazione, utilizza la casella combinata Applicazione. Questa è disponibile solo su macOS.

warning

Puoi aprire solo un'app che supporta App Sandbox. Inoltre, assicurati che l'app supporti l'apertura dell'URL che desideri aprire.

Elaborazione Gruppi di Cattura​

Tipi Supportati: Originale

L'opzione Elaborazione Gruppi di Cattura ti consente di specificare come elaborare i gruppi catturati che puoi sostituire nell'opzione Reindirizza A con $1, $2...

Ecco come creare gruppi di cattura:

  • Carattere Jolly: I testi corrispondenti a * e ? vengono catturati automaticamente.
  • Espressione Regolare: I testi corrispondenti a parte del pattern all'interno di () vengono catturati.

Puoi scegliere uno o più dei seguenti processi:

  • Codifica/Decodifica URL: Questo applica la codifica percentuale o la decodifica a un gruppo di cattura. Ad esempio, se codifichi https://example.com/hello, viene convertito in https%3A%2F%2Fexample.com%2Fhello. La decodifica funziona in modo opposto.
  • Codifica/Decodifica Base64: Questo decodifica/codifica un testo in Base64. Ad esempio, puoi codificare hello in aGVsbG8=, e decodificarlo di nuovo in hello.
  • Sostituisci Occorrenze: Questo sostituisce uno o più caratteri in un gruppo, corrispondenti a un Target, con una Sostituzione. Ad esempio, se il Gruppo è hello e il Target è l e la Sostituzione è y, viene modificato in heyyo.
note

Questo serve per elaborare ogni gruppo di cattura e non influisce sugli URL esclusi dai Pattern URL Esclusi. Ad esempio, supponiamo che tu abbia questa regola:

  • Reindirizza Da: https://example.com/(hello.*)
  • Elaborazione Gruppi di Cattura:
    • Gruppo: $1
    • Target: .* (Espressione Regolare)
    • Sostituzione: hello
  • Pattern URL Escluso: https://example.com/hello

In questo caso, https://example.com/hello_world non sarà escluso mentre https://example.com/hello sarà escluso.

Pattern URL Esclusi​

Tipi Supportati: Originale

L'opzione Pattern URL Esclusi ti consente di specificare gli URL che non vengono reindirizzati. Questo può essere utile per evitare loop di reindirizzamento o per escludere determinate parti di un sito web dal reindirizzamento.

Puoi specificare i pattern URL esclusi utilizzando tipi di pattern di Espressione Regolare o Carattere Jolly.

Esempi​

L'opzione Esempi ti consente di testare la tua regola di reindirizzamento fornendo URL di esempio. Aggiungendo un URL di esempio, puoi verificare se la regola funziona come previsto prima di applicarla effettivamente.

Commenti​

L'opzione Commenti ti consente di aggiungere note o commenti sulla tua regola di reindirizzamento. Questo può essere utile per tenere traccia del motivo per cui hai creato una regola specifica o per fornire contesto ad altri che potrebbero visualizzare le tue regole.

Puoi scrivere commenti nei seguenti formati:

  • Testo Semplice (Predefinito): Testo semplice senza alcuna formattazione.
  • Markdown: Puoi utilizzare le sintassi Markdown di GitHub, incluse alcune estensioni che GFM non supporta. Ad esempio, puoi creare titoli, elenchi, collegamenti e altro ancora.
  • AsciiDoc: Puoi utilizzare le sintassi AsciiDoc per formattare i tuoi commenti.

Pattern URL​

I pattern URL vengono utilizzati per abbinare gli URL nelle opzioni Reindirizza Da, Pattern URL Esclusi e Elaborazione Gruppi di Cattura. Per specificarli, puoi scegliere tra Carattere Jolly o Espressione Regolare.

Carattere Jolly​

Il Carattere Jolly è un tipo di pattern più semplice che ti consente di utilizzare * (corrisponde a qualsiasi cosa) e ? (corrisponde a qualsiasi singolo carattere) come caratteri jolly. Ecco alcuni esempi:

  • Per abbinare https://example.com/hello, puoi usare https://example.com/*. Questo abbinerà qualsiasi stringa dopo https://example.com/.
  • Per abbinare https://example.com/search?q=hello, puoi usare https://example.com/search?q=*. Questo abbinerà qualsiasi valore per il parametro q.
  • Per abbinare qualsiasi URL che contenga la parola blog, puoi usare *blog*.

Puoi anche usare la sostituzione nel Carattere Jolly, il che significa che puoi fare riferimento a porzioni dell'URL abbinato usando $1, $2, ecc. Ad esempio, se usi https://example.com/*-world-*, e l'URL è https://example.com/hello-world-goodbye, allora $1 sarebbe "hello" e $2 sarebbe "goodbye". $0 è anche disponibile per fare riferimento all'intero URL abbinato.

note

Sebbene la sostituzione sia una caratteristica dell'Espressione Regolare, puoi usarla anche per il Carattere Jolly perché Redirect Web converte internamente il Carattere Jolly in Espressione Regressione.

Espressione Regolare​

L'Espressione Regolare (Regex) è uno strumento potente per abbinare pattern nel testo ed è anche ampiamente utilizzato nella programmazione. Ti consente di definire un pattern specifico che corrisponde a un insieme di stringhe. Ecco alcuni esempi.

  • Per abbinare https://example.com/hello, puoi usare https://example.com/.*. Questo abbinerà qualsiasi stringa dopo https://example.com/.
  • Per abbinare https://example.com/search?q=hello, puoi usare https://example.com/search\?q=(.*). Questo abbinerà il valore del parametro q e lo memorizzerà in un gruppo di cattura. Puoi quindi farvi riferimento usando $1 nell'opzione Reindirizza A.
  • Per abbinare qualsiasi URL che contenga la parola blog, puoi usare .*blog.*.

Puoi fare riferimento ai gruppi di cattura in Reindirizza A o Sostituzione usando $1, $2, ... o $0 per fare riferimento all'intera corrispondenza.

Redirect Web è basato sul motore Regex di Apple.

Maggiori informazioni sulla sintassi Regex possono essere trovate in risorse come RegExr.