Para comprobar si un atajo de Mac codifica el texto de búsqueda seleccionado, inspeccione el valor que llega a su URL final: añada una acción Vista rápida después de que el atajo cree la URL, ejecútelo con una frase de prueba que contenga espacios y caracteres reservados, y compruebe si esos caracteres aparecen como secuencias de escape por porcentaje. Una ejecución exitosa por sí sola no demuestra que el texto de búsqueda se haya codificado correctamente; la URL visible le ofrece una forma de inspeccionar lo que el atajo realmente ensambló. Apple documenta Vista rápida para previsualizar el contenido transferido entre las acciones de un atajo, y su guía de Mac describe flujos de trabajo basados en URL que requieren que el texto esté codificado en formato URL. (Testing your actions in Shortcuts on Mac; Use another app’s URL scheme in Shortcuts on Mac)

Identifique el texto y la URL que necesita inspeccionar

Un atajo de búsqueda suele tomar una frase seleccionada, la coloca en una URL de búsqueda y abre esa URL. La parte que se debe verificar es el valor de consulta (query value) que contiene la frase, no solo si la URL final comienza con una dirección web. Por ejemplo, si la URL de búsqueda tiene la forma https://example.com/search?q=..., inspeccione el valor después de q=. El dominio de ejemplo es meramente ilustrativo; utilice el servicio de búsqueda y el parámetro reales para los que está diseñado su atajo.

Revise las acciones del atajo de arriba a abajo. Encuentre dónde entra el texto seleccionado en el flujo de trabajo, dónde se ensambla la URL o la consulta de búsqueda y la acción que abre la URL. La guía de Atajos de Apple explica que las acciones conectadas transfieren su salida hacia adelante, y que una acción Vista rápida puede previsualizar el contenido que se mueve entre acciones. (Action connections in Shortcuts on Mac; Testing your actions in Shortcuts on Mac)

Ponga el texto seleccionado a disposición de un atajo de Mac

Si está revisando un atajo existente, confirme que esté configurado para recibir texto seleccionado. En Atajos, abra el atajo, abra sus Detalles y active Usar como acción rápida o Mostrar en la hoja para compartir. Apple indica que esto añade una acción de entrada al principio del flujo de trabajo. Luego seleccione una frase en una app e invoque el atajo desde las opciones para compartir de la app o desde las Acciones rápidas disponibles. El menú exacto depende de la app y de cómo esté habilitado el atajo. (Run a shortcut while working on your Mac)

Según Apple, un atajo iniciado desde el Dock no recibe contenido de la app actual. Si lo inicia de esa manera, es posible que se ejecute sin la selección que pretende probar. Compruebe la acción de entrada del atajo y ejecútelo desde una app de origen compatible con texto seleccionado. (Run a shortcut while working on your Mac; Limit the input for a shortcut when run from another app on Mac)

Previsualice la URL completa antes de que se abra

En el editor de atajos, inserte Vista rápida entre la acción que crea la URL final y la acción que la abre. Ejecute el atajo con una frase de prueba inofensiva como red & blue sky. Vista rápida debería mostrar la salida de la acción anterior. Esto le permite inspeccionar la URL construida antes de que la reciba la acción de apertura; no valida por sí mismo que el proveedor de búsqueda acepte la URL o interprete la consulta como se esperaba. Apple recomienda Vista rápida como un método para identificar qué contenido fluye entre las acciones del atajo. (Testing your actions in Shortcuts on Mac)

Lea el valor de la consulta en la previsualización. En un componente de consulta típico codificado con porcentaje, un espacio puede aparecer como %20, y un signo de et (&) que pertenezca a la frase de búsqueda puede aparecer como %26. Si el signo de et permanece como un & literal dentro del valor, un analizador de URL puede tratarlo como el inicio de otro parámetro. Este es un ejemplo de diagnóstico, no una garantía sobre el formato de consulta de todos los servicios de búsqueda. Los propios ejemplos de esquemas de URL de Atajos de Apple utilizan %20 para los espacios y describen explícitamente el texto suministrado como codificado en URL. (Run a shortcut using a URL scheme on Mac)

Compruebe qué acción realiza la codificación

Busque en el editor de acciones la opción Codificar URL e inspeccione si recibe la variable del texto seleccionado antes de que ese valor se inserte en la consulta. El propósito documentado de la acción es codificar o descodificar texto para su uso en una URL añadiendo o eliminando secuencias de escape por porcentaje. (URL Encode) Apple también documenta la construcción de URL con la acción URL y su apertura con Abrir URL o Abrir URL X-Callback, pero su guía advierte que los esquemas de URL pueden requerir texto codificado y pueden ser difíciles de depurar. (Use another app’s URL scheme in Shortcuts on Mac)

La comprobación útil radica en la posición de la acción y en la previsualización, no simplemente en la presencia de una acción con «URL» en su nombre. Confirme que el texto seleccionado fluya hacia el paso de codificación y que el resultado codificado (no la selección original) sea lo que se inserta como valor de consulta. Luego, confirme que la previsualización de Vista rápida muestre los caracteres de escape esperados. Evite codificar un valor ya codificado por segunda vez: los signos de porcentaje pueden codificarse a su vez, transformando %20 en %2520. Ese patrón en la previsualización es una pista para inspeccionar el flujo de trabajo en busca de codificaciones repetidas.

Interprete el resultado y sus límites

Si la previsualización muestra espacios con secuencias de escape y caracteres reservados dentro del valor de consulta, eso es evidencia de que la URL ensamblada contiene texto codificado. Si muestra espacios sin formato, es posible que el texto seleccionado no haya pasado por un codificador, que se haya insertado la variable incorrecta o que esté previsualizando la salida de una acción anterior. Si falta la frase, verifique la entrada del atajo y las conexiones de las variables antes de cambiar la estructura de su URL.

Una previsualización puede mostrar la cadena de URL que ensambló el atajo; no puede establecer cómo procesará la consulta un servicio de búsqueda en particular, si la URL se abrirá con éxito o si el servicio aplica sus propias reglas. Para una comprobación funcional final, elimine o mueva la acción de diagnóstico Vista rápida y utilice el atajo con una frase de muestra que no sea confidencial. Apple documenta los controles de Mac para recibir contenido y abrir URL, pero no promete un comportamiento de consulta idéntico en todos los servicios de búsqueda. (Run a shortcut while working on your Mac; Use another app’s URL scheme in Shortcuts on Mac)

Fuentes