Para verificar se um atalho do Mac codifica o texto de pesquisa selecionado, inspecione o valor que chega ao seu URL final: adicione uma ação Vista Rápida depois de o atalho criar o URL, execute-o com uma frase de teste contendo espaços e carateres reservados e verifique se esses carateres aparecem como códigos de escape percentuais. Uma execução bem-sucedida por si só não prova que o texto de pesquisa foi codificado corretamente; o URL visível oferece uma forma de inspecionar o que o atalho realmente construiu. A Apple documenta a Vista Rápida para pré-visualizar conteúdos transferidos entre ações de atalhos, e o seu guia do Mac descreve fluxos de trabalho baseados em URL que exigem que o texto seja codificado para URL. (Testing your actions in Shortcuts on Mac; Use another app’s URL scheme in Shortcuts on Mac)

Identifique o texto e o URL que precisa de inspecionar

Um atalho de pesquisa normalmente pega numa frase selecionada, insere-a num URL de pesquisa e abre esse URL. A parte a verificar é o valor da consulta (query) que contém a frase — e não apenas se o URL final começa com um endereço web. Por exemplo, se o URL de pesquisa tiver o formato https://example.com/search?q=..., inspecione o valor a seguir a q=. O domínio de exemplo é apenas ilustrativo; utilize o serviço de pesquisa e o parâmetro reais para os quais o seu atalho foi criado.

Analise as ações do atalho de cima para baixo. Descubra onde o texto selecionado entra no fluxo de trabalho, onde o URL ou a consulta de pesquisa é montado e a ação que abre o URL. O manual dos Atalhos da Apple explica que as ações ligadas transmitem o seu resultado para a ação seguinte e que uma ação Vista Rápida pode pré-visualizar o conteúdo que transita entre ações. (Action connections in Shortcuts on Mac; Testing your actions in Shortcuts on Mac)

Disponibilizar o texto selecionado para um atalho do Mac

Se estiver a verificar um atalho existente, confirme se este está configurado para receber texto selecionado. Na aplicação Atalhos, abra o atalho, aceda aos seus Detalhes e ative Usar como Ação Rápida ou Mostrar na Folha de Partilha. A Apple indica que isto adiciona uma ação de entrada no início do fluxo de trabalho. Em seguida, selecione uma frase numa aplicação e execute o atalho a partir das opções de partilha da aplicação ou das Ações Rápidas disponíveis. O menu exato depende da aplicação e de como o atalho está ativado. (Run a shortcut while working on your Mac)

Um atalho iniciado a partir da Dock não recebe conteúdos da aplicação atual, de acordo com a Apple. Se o iniciar dessa forma, ele poderá ser executado sem a seleção que pretende testar. Verifique a ação de entrada do atalho e execute-o a partir de uma aplicação de origem suportada com o texto selecionado. (Run a shortcut while working on your Mac; Limit the input for a shortcut when run from another app on Mac)

Pré-visualizar o URL concluído antes de abrir

No editor de atalhos, insira a Vista Rápida entre a ação que cria o URL final e a ação que o abre. Execute o atalho com uma frase de teste inofensiva, como red & blue sky. A Vista Rápida deverá apresentar o resultado da ação anterior. Isto permite-lhe inspecionar o URL construído antes que a ação de abertura o receba; por si só, não valida se o fornecedor de pesquisa aceita o URL ou interpreta a consulta conforme pretendido. A Apple recomenda a Vista Rápida como uma forma de identificar o conteúdo que flui entre as ações do atalho. (Testing your actions in Shortcuts on Mac)

Leia o valor da consulta na pré-visualização. Num componente de consulta percent-encoded típico, um espaço pode surgir como %20, e um e comercial (&) pertencente à frase de pesquisa pode surgir como %26. Se o e comercial permanecer um & literal dentro do valor, um analisador de URL poderá tratá-lo como o início de outro parâmetro. Este é um exemplo de diagnóstico, não uma garantia sobre o formato de consulta de todos os serviços de pesquisa. Os próprios exemplos de esquemas de URL dos Atalhos da Apple usam %20 para espaços e descrevem explicitamente o texto fornecido como codificado para URL. (Run a shortcut using a URL scheme on Mac)

Verificar que ação efetua a codificação

Procure a ação Codificar URL no editor de ações e inspecione se esta recebe a variável de texto selecionado antes de esse valor ser inserido na consulta. O objetivo documentado da ação é codificar ou descodificar texto para utilização num URL, adicionando ou removendo códigos de escape percentuais. (URL Encode) A Apple também documenta a construção de URLs com a ação URL e a sua abertura com Abrir URLs ou Abrir URL X-Callback, mas o seu guia adverte que os esquemas de URL podem exigir texto codificado e podem ser difíceis de depurar. (Use another app’s URL scheme in Shortcuts on Mac)

A verificação mais útil reside na posição da ação e na pré-visualização, e não apenas na presença de uma ação com "URL" no nome. Confirme se o texto selecionado segue para a etapa de codificação e se o resultado codificado — e não a seleção original — é o que é inserido como o valor da consulta. Em seguida, confirme se a pré-visualização da Vista Rápida apresenta os escapes esperados. Evite codificar um valor já codificado uma segunda vez: os próprios sinais de percentagem podem ser codificados, transformando %20 em %2520. Esse padrão na pré-visualização é uma pista para inspecionar o fluxo de trabalho em busca de codificações repetidas.

Interpretar o resultado e os seus limites

Se a pré-visualização apresentar espaços e carateres reservados com códigos de escape dentro do valor da consulta, isso é um indício de que o URL construído contém texto codificado. Se apresentar espaços simples, o texto selecionado poderá não ter passado por um codificador, a variável errada poderá ter sido inserida ou poderá estar a pré-visualizar o resultado de uma ação anterior. Se a frase estiver em falta, verifique a entrada do atalho e as ligações de variáveis antes de alterar a estrutura do respetivo URL.

Uma pré-visualização pode mostrar a string de URL que o atalho montou; não pode determinar como um serviço de pesquisa específico processará a consulta, se o URL abre com sucesso ou se o serviço aplica regras próprias. Para uma verificação funcional final, remova ou mova a ação de diagnóstico Vista Rápida e utilize o atalho com uma frase de exemplo não confidencial. A Apple documenta os controlos do Mac para receber conteúdos e abrir URLs, mas não garante um comportamento de consulta idêntico em diferentes serviços de pesquisa. (Run a shortcut while working on your Mac; Use another app’s URL scheme in Shortcuts on Mac)

Fontes