Aller au contenu principal

Paramètres de règle

Cette page fournit des informations détaillées sur chaque paramètre de l'écran Modifier la règle dans l'application Redirect Web.

Options​

Type​

Spécifiez l'option Type pour contrôler la manière dont l'application gère la redirection. Vous avez le choix entre :

  • Original (Par défaut)
    • Cela utilise les API Web traditionnelles pour contrôler la redirection. De plus, cela utilise l'API Tabs comme solution de secours.
      • Dans Firefox, cela utilise l'API WebRequest pour gérer la redirection.
    • Vous pouvez utiliser toutes les options à l'exception des Types de ressources et des Méthodes de requête.
    • C'est plus lent que le type Déclaratif et cela peut entraîner des requêtes réseau supplémentaires.
  • DNR (Expérimental pour Safari) :
    • Ce type fonctionne beaucoup plus rapidement que le type Original car il n'initie pas de requête réseau pour l'URL source.
    • Cela vous permet de spécifier les Types de ressources et les Méthodes de requête.
    • ⚠️ Vous ne pouvez pas utiliser certaines options, telles que le Traitement des groupes de capture et les Modèles d'URL exclus, car elles ne sont pas encore prises en charge par l'API DNR.
    • ⚠️ Dans Safari, vous ne pouvez pas actuellement inclure de barres verticales (|) dans votre motif d'expression régulière. Détails
    • ⚠️ Comme l'API DNR de Safari présente encore quelques problèmes, nous considérons qu'il s'agit toujours d'une fonctionnalité expérimentale pour Safari. Vous pouvez trouver la liste de tous les problèmes connus ici.

Rediriger depuis​

L'option Rediriger depuis vous permet de spécifier un motif d'URL des pages web depuis lesquelles vous souhaitez rediriger. Vous pouvez choisir entre Joker ou Expression régulière.

Par exemple, si vous spécifiez https://example.com/* avec un Joker, cela correspondra à https://example.com/ ou https://example.com/hello.

remarque

Dans l'option Rediriger vers, vous pouvez référencer la correspondance entière en utilisant $0 ou des correspondances partielles en utilisant $1, $2, ... Consultez les détails dans Motif d'URL sur cette page.

Types de ressources​

Types pris en charge : DNR

L'option Types de ressources vous permet de spécifier les catégories de requêtes web, telles que les images, les fichiers JavaScript et les feuilles de style, auxquelles la règle s'applique. Par exemple, si vous définissez script, vous pouvez rediriger les fichiers JavaScript chargés par les pages web.

Actuellement, les suivants sont disponibles : main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Le paramètre par défaut est main_frame, qui est la page de niveau supérieur chargée dans un onglet.

Veuillez consulter les détails de chaque type de ressource dans les mdn web docs.

Méthodes de requête​

Types pris en charge : DNR

L'option Méthodes de requête vous permet de définir les méthodes HTTP cibles de l'URL source.

Toutes les méthodes sont définies par défaut.

Veuillez consulter les détails de chaque méthode dans les mdn web docs.

attention

Dans Safari, cette option pourrait ne pas être disponible car l'implémentation d'Apple pour le type DNR ne semble pas la gérer actuellement. Nous avons envoyé un retour à Apple sous le numéro FB14502272.

Navigateurs cibles​

Plateformes prises en charge : macOS

L'option Navigateurs cibles vous permet de spécifier à quel navigateur la règle doit ou ne doit pas être appliquée.

  • Il y a 2 types de navigateurs que vous pouvez choisir :
    • Navigateurs que vous pouvez choisir par défaut : Vous pouvez choisir Safari, Chrome, Firefox, Edge, Opera, Arc, Brave et Vivaldi par défaut. Cela ne différencie pas les variantes du même navigateur, comme Safari et Safari Technology Preview.
    • Navigateurs spécifiés par l'utilisateur : En appuyant sur le bouton Ajouter de la fenêtre contextuelle, vous pouvez sélectionner n'importe quel navigateur autre que Safari ou Safari Technology Preview qui a l'extension Redirect Web installée.
  • La case à cocher Tous sauf ceux sélectionnés vous permet de cibler tous les navigateurs à l'exception de ceux que vous avez choisis.
attention

Redirect Web ne peut pas différencier si le navigateur est Safari ou Safari Technology Preview car l'application vérifie le processus parent de l'extension pour le détecter, mais ces deux navigateurs partagent le même processus parent (/sbin/launchd).

Rediriger vers​

L'option Rediriger vers spécifie une URL de destination vers laquelle vous souhaitez rediriger, depuis l'URL source correspondant à l'option Rediriger depuis. Vous pouvez également substituer les groupes de capture par $1, $2, ... ou la correspondance entière par $0. Ces éléments vous aident à spécifier dynamiquement la destination. Consultez les détails dans Motif d'URL sur cette page.

Par exemple, si vous définissez la règle suivante :

  • Rediriger depuis : https://google.com/* (Joker)
  • Rediriger vers : https://apple.com/$1

et qu'elle correspond à https://google.com/hello, alors l'URL de destination sera https://apple.com/hello.

De plus, vous pouvez modifier les textes de $1, $2, ... avant d'effectuer les substitutions. Consultez la section Traitement des groupes de capture pour les détails.

astuce

Vous pouvez spécifier un schéma d'URL personnalisé pour ouvrir une application. Voici des exemples d'applications qui prennent en charge le 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

Application​

Types pris en charge : Original Plateformes prises en charge : macOS

Si vous souhaitez spécifier une application pour ouvrir l'URL de destination, utilisez la zone de liste déroulante Application. Ceci n'est disponible que sur macOS.

attention

Vous ne pouvez ouvrir qu'une application qui prend en charge App Sandbox. Assurez-vous également que l'application prend en charge l'ouverture de l'URL que vous souhaitez ouvrir.

Traitement des groupes de capture​

Types pris en charge : Original

L'option Traitement des groupes de capture vous permet de spécifier comment traiter les groupes capturés que vous pouvez substituer dans l'option Rediriger vers avec $1, $2...

Voici comment créer des groupes de capture :

  • Joker : Les textes correspondant à * et ? sont automatiquement capturés.
  • Expression régulière : Les textes correspondant à une partie du motif à l'intérieur de () sont capturés.

Vous pouvez choisir un ou plusieurs des processus suivants :

  • Encodage/Décodage d'URL : Cela applique un encodage en pourcentage ou un décodage à un groupe de capture. Par exemple, si vous encodez https://example.com/hello, il est converti en https%3A%2F%2Fexample.com%2Fhello. Le décodage fonctionne de manière inverse.
  • Encodage/Décodage Base64 : Cela décode/encode un texte en Base64. Par exemple, vous pouvez encoder hello en aGVsbG8= et le décoder pour retrouver hello.
  • Remplacer les occurrences : Cela remplace un ou plusieurs caractères dans un groupe, correspondant à une Cible, par un Remplacement. Par exemple, si le Groupe est hello, la Cible est l et le Remplacement est y, il est modifié en heyyo.
remarque

Ceci est destiné au traitement de chaque groupe de capture et n'affecte pas les URL exclues par les Modèles d'URL exclus. Par exemple, supposons que vous ayez cette règle :

  • Rediriger depuis : https://example.com/(hello.*)
  • Traitement des groupes de capture :
    • Groupe : $1
    • Cible : .* (Expression régulière)
    • Remplacement : hello
  • Modèle d'URL exclus : https://example.com/hello

Dans ce cas, https://example.com/hello_world ne sera pas exclue alors que https://example.com/hello le sera.

Modèles d'URL exclus​

Types pris en charge : Original

L'option Modèles d'URL exclus vous permet de spécifier les URL qui ne sont pas redirigées. Cela peut être utile pour éviter les boucles de redirection ou pour exclure certaines parties d'un site web de la redirection.

Vous pouvez spécifier des modèles d'URL exclus en utilisant des expressions régulières ou des jokers.

Exemples​

L'option Exemples vous permet de tester votre règle de redirection en fournissant des URL d'exemple. En ajoutant une URL d'exemple, vous pouvez vérifier si la règle fonctionne comme prévu avant de l'appliquer réellement.

Commentaires​

L'option Commentaires vous permet d'ajouter des notes ou des commentaires sur votre règle de redirection. Cela peut être utile pour garder une trace des raisons pour lesquelles vous avez créé une règle spécifique ou pour fournir un contexte à d'autres personnes qui pourraient consulter vos règles.

Motif d'URL​

Il y a 3 options où vous pouvez spécifier un ou plusieurs motifs d'URL : Rediriger depuis, Modèles d'URL exclus et Traitement des groupes de capture. Pour les spécifier, vous pouvez choisir entre Joker ou Expression régulière.

Joker​

Le Joker est un type de motif plus simple qui vous permet d'utiliser * (correspond à n'importe quoi) et ? (correspond à n'importe quel caractère unique) comme jokers. Voici quelques exemples :

  • Pour correspondre à https://example.com/hello, vous pouvez utiliser https://example.com/*. Cela correspondra à n'importe quelle chaîne après https://example.com/.
  • Pour correspondre à https://example.com/search?q=hello, vous pouvez utiliser https://example.com/search?q=*. Cela correspondra à n'importe quelle valeur pour le paramètre q.
  • Pour correspondre à n'importe quelle URL qui contient le mot blog, vous pouvez utiliser *blog*.

Vous pouvez également utiliser la substitution avec les Jokers, ce qui signifie que vous pouvez référencer des portions de l'URL correspondante en utilisant $1, $2, etc. Par exemple, si vous utilisez https://example.com/*-world-*, et que l'URL est https://example.com/hello-world-goodbye, alors $1 serait "hello" et $2 serait "goodbye". $0 est également disponible pour référencer l'URL entière correspondante.

[!Note] Bien que la substitution soit une fonctionnalité des Expressions régulières, vous pouvez également l'utiliser pour les Jokers car Redirect Web convertit en interne les Jokers en Expressions régulières.

Expression régulière​

L'Expression régulière (Regex) est un outil puissant pour faire correspondre des motifs dans le texte, alimenté par le moteur d'expression régulière d'Apple décrit ici. Il vous permet de définir un motif spécifique qui correspond à un ensemble de chaînes de caractères. Voici quelques exemples.

  • Pour correspondre à https://example.com/hello, vous pouvez utiliser https://example.com/(.*). Cela correspondra à n'importe quelle chaîne après https://example.com/ et la stockera dans un groupe de capture.
  • Pour correspondre à https://example.com/search?q=hello, vous pouvez utiliser https://example.com/search\?q=(.*). Cela correspondra à la valeur du paramètre q et la stockera dans un groupe de capture.
  • Pour correspondre à n'importe quelle URL qui contient le mot blog, vous pouvez utiliser .*blog.*.

Vous pouvez référencer les groupes de capture dans Rediriger vers ou Remplacement en utilisant $1, $2, ... ou $0 pour référencer la correspondance entière.

Plus d'informations sur la syntaxe Regex peuvent être trouvées dans des ressources comme RegExr.