Pour vérifier si un raccourci Mac encode le texte de recherche sélectionné, inspectez la valeur qui parvient à son URL finale : ajoutez une action Coup d'œil après la construction de l'URL par le raccourci, exécutez-le avec une phrase test contenant des espaces et des caractères réservés, et vérifiez si ces caractères apparaissent sous forme de séquences d'échappement avec pourcentages. Une exécution réussie ne prouve pas à elle seule que le texte de recherche a été correctement encodé ; l'URL visible vous permet d'inspecter ce que le raccourci a réellement assemblé. Apple documente Coup d'œil pour prévisualiser le contenu transmis entre les actions d'un raccourci, et son guide Mac décrit des flux de travail basés sur des URL qui nécessitent que le texte soit encodé au format URL. (Tester vos actions dans Raccourcis sur Mac ; Utiliser le schéma d’URL d’une autre app dans Raccourcis sur Mac)

Identifier le texte et l'URL que vous devez inspecter

Un raccourci de recherche récupère généralement une expression sélectionnée, la place dans une URL de recherche et ouvre cette URL. La partie à vérifier est la valeur de la requête contenant l'expression — pas seulement si l'URL finale commence par une adresse web. Par exemple, si l'URL de recherche est sous la forme https://example.com/search?q=..., inspectez la valeur située après q=. Le domaine d'exemple n'est donné qu'à titre indicatif ; utilisez le service de recherche et le paramètre réels pour lesquels votre raccourci est conçu.

Passez en revue les actions du raccourci de haut en bas. Repérez l'endroit où le texte sélectionné entre dans le flux de travail, où l'URL ou la requête de recherche est assemblée, ainsi que l'action qui ouvre l'URL. Le guide de Raccourcis d'Apple explique que les actions connectées transmettent leur résultat à la suivante, et qu'une action Coup d'œil permet de prévisualiser le contenu circulant entre les actions. (Connexions d’actions dans Raccourcis sur Mac ; Tester vos actions dans Raccourcis sur Mac)

Rendre le texte sélectionné accessible à un raccourci Mac

Si vous vérifiez un raccourci existant, confirmez qu'il est configuré pour recevoir du texte sélectionné. Dans Raccourcis, ouvrez le raccourci, accédez à ses Détails et activez Utiliser comme action rapide ou Afficher dans la feuille de partage. Apple indique que cela ajoute une action d'entrée au début du flux. Sélectionnez ensuite une expression dans une application et lancez le raccourci depuis les options de partage ou les actions rapides disponibles de l'application. Le menu exact dépend de l'application et de la manière dont le raccourci est activé. (Exécuter un raccourci pendant que vous travaillez sur votre Mac)

Selon Apple, un raccourci lancé depuis le Dock ne reçoit pas le contenu de l'application en cours d'utilisation. Si vous le lancez de cette façon, il risque de s'exécuter sans la sélection que vous souhaitez tester. Vérifiez l'action d'entrée du raccourci et exécutez-le depuis une application source prise en charge avec du texte sélectionné. (Exécuter un raccourci pendant que vous travaillez sur votre Mac ; Limiter l’entrée pour un raccourci lorsqu’il est exécuté depuis une autre app sur Mac)

Prévisualiser l'URL complète avant son ouverture

Dans l'éditeur de raccourcis, insérez Coup d'œil entre l'action qui crée l'URL finale et l'action qui l'ouvre. Exécutez le raccourci avec une expression de test inoffensive comme red & blue sky. Coup d'œil devrait afficher le résultat de l'action précédente. Cela vous permet d'inspecter l'URL construite avant que l'action d'ouverture ne la reçoive ; cela ne valide pas en soi que le moteur de recherche acceptera l'URL ou interprétera la requête comme prévu. Apple recommande Coup d'œil comme moyen d'identifier le contenu qui circule entre les actions des raccourcis. (Tester vos actions dans Raccourcis sur Mac)

Lisez la valeur de la requête dans l'aperçu. Dans un composant de requête encodé en pourcentages classique, un espace peut apparaître sous la forme %20, et une esperluette appartenant à la phrase de recherche peut apparaître sous la forme %26. Si l'esperluette reste un & littéral à l'intérieur de la valeur, un analyseur d'URL risque de la traiter comme le début d'un autre paramètre. Il s'agit d'un exemple à visée diagnostique, et non d'une garantie sur le format de requête de chaque service de recherche. Les exemples de schémas d'URL propres à Apple dans Raccourcis utilisent %20 pour les espaces et décrivent explicitement le texte fourni comme étant encodé pour les URL. (Exécuter un raccourci à l’aide d’un schéma d’URL sur Mac)

Vérifier quelle action effectue l'encodage

Recherchez Encoder l'URL dans les actions de l'éditeur et vérifiez si elle reçoit la variable du texte sélectionné avant que cette valeur ne soit insérée dans la requête. L'objectif documenté de cette action est d'encoder ou de décoder du texte destiné à être utilisé dans une URL en ajoutant ou en supprimant des séquences d'échappement avec pourcentages. (URL Encode) Apple documente également la construction d'URL avec l'action URL et leur ouverture avec Ouvrir les URL ou Ouvrir l'URL X-Callback, mais son guide avertit que les schémas d'URL peuvent nécessiter du texte encodé et s'avérer difficiles à déboguer. (Utiliser le schéma d’URL d’une autre app dans Raccourcis sur Mac)

La vérification utile repose sur l'emplacement de l'action et l'aperçu, et non sur la simple présence d'une action contenant « URL » dans son nom. Confirmez que le texte sélectionné est bien transmis à l'étape d'encodage, et que le résultat encodé — et non la sélection d'origine — est bien ce qui est inséré comme valeur de requête. Vérifiez ensuite que l'aperçu Coup d'œil affiche bien les échappements attendus. Évitez d'encoder une valeur déjà encodée une seconde fois : les signes de pourcentage peuvent eux-mêmes être encodés, transformant %20 en %2520. Ce schéma dans l'aperçu indique qu'il faut examiner le flux de travail à la recherche d'un encodage répété.

Interpréter le résultat et ses limites

Si l'aperçu affiche des espaces et des caractères réservés échappés à l'intérieur de la valeur de la requête, cela prouve que l'URL assemblée contient du texte encodé. S'il affiche des espaces bruts, le texte sélectionné n'est peut-être pas passé par un encodeur, la mauvaise variable a pu être insérée, ou vous prévisualisez peut-être le résultat d'une action antérieure. Si la phrase est absente, vérifiez les connexions des variables et des entrées du raccourci avant de modifier la structure de son URL.

Un aperçu peut afficher la chaîne d'URL assemblée par le raccourci ; il ne peut pas déterminer comment un service de recherche particulier traitera la requête, si l'URL s'ouvrira correctement, ou si le service appliquera ses propres règles. Pour une vérification fonctionnelle finale, supprimez ou déplacez l'action diagnostique Coup d'œil et utilisez le raccourci avec une phrase d'exemple non confidentielle. Apple documente les commandes Mac permettant de recevoir du contenu et d'ouvrir des URL, mais ne garantit pas un comportement de requête identique sur tous les services de recherche. (Exécuter un raccourci pendant que vous travaillez sur votre Mac ; Utiliser le schéma d’URL d’une autre app dans Raccourcis sur Mac)

Sources