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 façon dont l'application gère la redirection. Vous pouvez choisir parmi les options suivantes :
- Original (Par défaut)
- Ceci utilise les API Web traditionnelles pour contrôler la redirection. De plus, il utilise l'API Tabs comme solution de repli.
- Dans Firefox, il utilise l'API WebRequest pour gérer la redirection.
- Vous pouvez utiliser toutes les options autres que Types de ressources et Méthodes de requête.
- Ceci est plus lent que le type Déclaratif et peut entraîner des requêtes réseau supplémentaires.
- Ceci utilise les API Web traditionnelles pour contrôler la redirection. De plus, il utilise l'API Tabs comme solution de repli.
- 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 Traitement des groupes de capture et Modèles d'URL exclus car elles ne sont pas encore prises en charge par l'API DNR.
- ⚠️ Dans Safari, vous ne pouvez actuellement pas inclure de barres verticales (
|
) dans votre modèle d'expression régulière. Détails - ⚠️ Étant donné que 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 modèle d'URL des pages web à partir desquelles vous souhaitez rediriger. Vous pouvez choisir entre Joker ou Expression régulière.
Par exemple, si vous spécifiez https://example.com/*
avec Joker, cela correspond à https://example.com/
ou https://example.com/hello
.
Dans l'option Rediriger vers, vous pouvez référencer la correspondance entière en utilisant $0
ou les correspondances partielles en utilisant $1
, $2
, ... Vérifiez les détails dans Modèle d'URL sur cette page.
Types de ressources
L'option Types de ressources vous permet de spécifier les catégories de requêtes web, telles que les images, les JavaScripts 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, ceux-ci 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 vérifier les détails de chaque type de ressource dans mdn web docs.
Méthodes de requête
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 vérifier les détails de chaque méthode dans mdn web docs.
Dans Safari, cette option peut ne pas être disponible car l'implémentation d'Apple pour le type DNR ne semble pas la gérer actuellement. Nous avons envoyé des commentaires à Apple sous le numéro FB14502272.
Navigateurs cibles
L'option Navigateurs cibles vous permet de spécifier à quel navigateur la règle doit ou ne doit pas être appliquée.
- Il existe 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, telles que Safari et Safari Technology Preview.
- Navigateurs spécifiés par l'utilisateur : En appuyant sur le bouton Ajouter dans 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 Tout sauf la sélection vous permet de cibler tous les navigateurs sauf ceux que vous avez choisis.
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, à partir de l'URL source correspondant à l'option Rediriger depuis. Vous pouvez également substituer des groupes de capture avec $1
, $2
, ... ou la correspondance entière avec $0
. Ceux-ci vous aident à spécifier dynamiquement la destination. Vérifiez les détails dans Modèle 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 des substitutions. Vérifiez la section Traitement des groupes de capture pour les détails.
Vous pouvez spécifier un schéma d'URL personnalisé pour ouvrir une application. Voici des exemples d'applications qui prennent en charge le lien profond :
- 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
Si vous souhaitez spécifier une application dans laquelle vous souhaitez ouvrir l'URL de destination, utilisez la zone de liste déroulante Application. Ceci n'est disponible que sur macOS.
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
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 modèle à l'intérieur de
()
sont capturés.
Vous pouvez choisir un ou plusieurs des processus suivants :
- Encodage/Décodage d'URL : Ceci applique l'encodage en pourcentage ou le décodage à un groupe de capture. Par exemple, si vous encodez
https://example.com/hello
, il est converti enhttps%3A%2F%2Fexample.com%2Fhello
. Le décodage fonctionne dans le sens inverse. - Encodage/Décodage Base64 : Ceci décode/encode un texte en Base64. Par exemple, vous pouvez encoder
hello
enaGVsbG8=
, et le décoder enhello
. - Remplacer les occurrences : Ceci remplace un ou plusieurs caractères dans un groupe, correspondant à une Cible, par un Remplacement. Par exemple, si le Groupe est
hello
et la Cible estl
et le Remplacement esty
, il est modifié enheyyo
.
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
- Groupe :
- Modèle d'URL exclu :
https://example.com/hello
Dans ce cas, https://example.com/hello_world
ne sera pas exclu tandis que https://example.com/hello
sera exclu.
Modèles d'URL exclus
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 d'être redirigées.
Vous pouvez spécifier des modèles d'URL exclus en utilisant des types de modèles d'expression régulière ou de joker.
Exemples
L'option Exemples vous permet de tester votre règle de redirection en fournissant des exemples d'URL. 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 savoir pourquoi vous avez créé une règle spécifique ou pour fournir un contexte à d'autres personnes qui pourraient consulter vos règles.
Modèle d'URL
Il existe 3 options pour spécifier un ou plusieurs modèles d'URL. Rediriger depuis, Modèles d'URL exclus et Traitement des groupes de capture. Pour les spécifier, vous pouvez choisir Joker ou Expression régulière.
Joker
Joker est un type de modèle 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 utiliserhttps://example.com/*
. Cela correspondra à n'importe quelle chaîne aprèshttps://example.com/
. - Pour correspondre à
https://example.com/search?q=hello
, vous pouvez utiliserhttps://example.com/search?q=*
. Cela correspondra à n'importe quelle valeur pour le paramètreq
. - Pour correspondre à n'importe quelle URL contenant le mot
blog
, vous pouvez utiliser*blog*
.
Vous pouvez également utiliser la substitution dans Joker, ce qui signifie que vous pouvez référencer des parties 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.
Bien que la substitution soit une fonctionnalité de l'expression régulière, vous pouvez également l'utiliser pour Joker car Redirect Web convertit en interne Joker en expression régulière.
Expression régulière
L'expression régulière (Regex) est un outil puissant pour faire correspondre des modèles dans le texte, alimenté par le moteur d'expression régulière d'Apple qui est décrit ici. Il vous permet de définir un modèle spécifique qui correspond à un ensemble de chaînes. Voici quelques exemples.
- Pour correspondre à
https://example.com/hello
, vous pouvez utiliserhttps://example.com/(.*)
. Cela correspondra à n'importe quelle chaîne aprèshttps://example.com/
et la stockera dans un groupe de capture. - Pour correspondre à
https://example.com/search?q=hello
, vous pouvez utiliserhttps://example.com/search\?q=(.*)
. Cela correspondra à la valeur du paramètreq
et la stockera dans un groupe de capture. - Pour correspondre à n'importe quelle URL contenant 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.