Configuración de Reglas
Esta página proporciona información detallada de cada configuración en la pantalla de Editar Regla de la aplicación web Redirect.
Opciones
Tipo
Especifique la opción Tipo para controlar cómo la aplicación gestiona la redirección. Puede elegir entre las siguientes:
- Original (Predeterminado)
- Utiliza las API web tradicionales para controlar la redirección. Además, emplea la API Tabs como alternativa.
- En Firefox, utiliza la API WebRequest para manejar la redirección.
- Puede usar todas las opciones excepto Tipos de Recursos y Métodos de Solicitud.
- Es más lento que el tipo Declarativo y puede causar solicitudes de red adicionales.
- Utiliza las API web tradicionales para controlar la redirección. Además, emplea la API Tabs como alternativa.
- DNR (Experimental para Safari):
- Este tipo funciona mucho más rápido que el tipo Original porque no inicia una solicitud de red para la URL de origen.
- Permite especificar Tipos de Recursos y Métodos de Solicitud.
- ⚠️ No puede usar algunas opciones, como el Procesamiento de Grupos de Captura y los Patrones de URL Excluidas, ya que aún no son compatibles con la API DNR.
- ⚠️ En Safari, actualmente no puede incluir barras verticales (
|
) en su patrón de Expresión Regular. Detalles - ⚠️ Dado que la API DNR de Safari todavía tiene algunos problemas, consideramos que sigue siendo una función experimental para Safari. Puede encontrar la lista de todos los problemas conocidos aquí.
Redirigir Desde
La opción Redirigir Desde le permite especificar un patrón de URL de las páginas web desde las que desea redirigir. Puede elegir entre Comodín o Expresión Regular.
Por ejemplo, si especifica https://example.com/*
con Comodín, coincidirá con https://example.com/
o https://example.com/hello
.
En la opción Redirigir A, puede hacer referencia a toda la coincidencia usando $0
o a coincidencias parciales usando $1
, $2
, ... Consulte los detalles en Patrón de URL en esta página.
Tipos de Recursos
La opción Tipos de Recursos le permite especificar las categorías de solicitudes web, como imágenes, JavaScripts y hojas de estilo, a las que se aplica la regla.
Por ejemplo, si establece script
, puede redirigir los archivos JavaScript cargados por las páginas web.
Actualmente, están disponibles:
main_frame
, sub_frame
, stylesheet
, script
, image
, font
, xmlhttprequest
, ping
, media
, websocket
, other
La configuración predeterminada es main_frame
, que es la página de nivel superior cargada en una pestaña.
Consulte los detalles de cada tipo de recurso en documentos web de mdn.
Métodos de Solicitud
La opción Métodos de Solicitud le permite establecer los métodos HTTP objetivo de la URL de origen.
Todos los métodos están configurados de forma predeterminada.
Consulte los detalles de cada método en documentos web de mdn.
En Safari, esta opción podría no estar disponible porque la implementación de Apple para el tipo DNR no parece manejarla actualmente. Hemos enviado comentarios a Apple como FB14502272.
Navegadores de Destino
La opción Navegadores de Destino le permite especificar a qué navegador se debe o no aplicar la regla.
- Hay 2 tipos de navegadores que puede elegir:
- Navegadores que puede elegir por defecto: Puede elegir Safari, Chrome, Firefox, Edge, Opera, Arc, Brave y Vivaldi por defecto. Esto no diferencia variantes del mismo navegador, como Safari y Safari Technology Preview.
- Navegadores especificados por el usuario: Al tocar el botón Añadir en el popover, puede seleccionar cualquier navegador que no sea Safari o Safari Technology Preview que tenga instalada la extensión Redirect Web.
- La casilla de verificación Todos excepto los seleccionados le permite apuntar a todos los navegadores excepto los que ha elegido.
Redirect Web no puede diferenciar si el navegador es Safari o Safari Technology Preview porque la aplicación verifica el proceso padre de la extensión para detectarlo, pero estos dos navegadores comparten el mismo proceso padre (/sbin/launchd
).
Redirigir A
La opción Redirigir A especifica una URL de destino a la que desea redirigir, desde la URL de origen que coincide con la opción Redirigir Desde. También puede sustituir los grupos de captura con $1
, $2
, ... o toda la coincidencia con $0
. Esto le ayuda a especificar el destino dinámicamente. Consulte los detalles en Patrón de URL en esta página.
Por ejemplo, si establece la siguiente regla:
- Redirigir Desde:
https://google.com/*
(Comodín) - Redirigir A:
https://apple.com/$1
y coincide con https://google.com/hello
, entonces la URL de destino será https://apple.com/hello
.
Además, puede modificar los textos de $1
, $2
, ... antes de realizar las sustituciones. Consulte la sección Procesamiento de Grupos de Captura para obtener más detalles.
Puede especificar un esquema de URL personalizado para abrir una aplicación. Estos son ejemplos de aplicaciones que admiten enlaces profundos (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
Aplicación
Si desea especificar una aplicación en la que desea abrir la URL de destino, utilice el cuadro combinado Aplicación. Esto solo está disponible en macOS.
Solo puede abrir una aplicación que admita App Sandbox. Además, asegúrese de que la aplicación admita abrir la URL que desea abrir.
Procesamiento de Grupos de Captura
La opción Procesamiento de Grupos de Captura le permite especificar cómo procesar los grupos capturados que puede sustituir en la opción Redirigir A con $1
, $2
...
Así es como se crean los grupos de captura:
- Comodín: Los textos que coinciden con
*
y?
se capturan automáticamente. - Expresión Regular: Los textos que coinciden con parte del patrón dentro de
()
se capturan.
Puede elegir uno o más de los siguientes procesos:
- Codificar/Decodificar URL: Esto aplica codificación o decodificación percent-encoding a un grupo de captura. Por ejemplo, si codifica
https://example.com/hello
, se convierte enhttps%3A%2F%2Fexample.com%2Fhello
. La decodificación funciona a la inversa. - Codificar/Decodificar Base64: Esto decodifica/codifica un texto en Base64. Por ejemplo, puede codificar
hello
aaGVsbG8=
, y decodificarlo de nuevo ahello
. - Reemplazar Ocurrencias: Esto reemplaza uno o más caracteres en un grupo, que coinciden con un Objetivo, con un Reemplazo. Por ejemplo, si el Grupo es
hello
y el Objetivo esl
y el Reemplazo esy
, se modifica aheyyo
.
Esto es para procesar cada grupo de captura y no afecta a las URL excluidas por los Patrones de URL Excluidas. Por ejemplo, supongamos que tiene esta regla:
- Redirigir Desde:
https://example.com/(hello.*)
- Procesamiento de Grupos de Captura:
- Grupo:
$1
- Objetivo:
.*
(Expresión Regular) - Reemplazo:
hello
- Grupo:
- Patrón de URL Excluida:
https://example.com/hello
En este caso, https://example.com/hello_world
no se excluirá, mientras que https://example.com/hello
sí lo hará.
Patrones de URL Excluidas
La opción Patrones de URL Excluidas le permite especificar las URL que no se redirigen. Esto puede ser útil para evitar bucles de redirección o para excluir ciertas partes de un sitio web de ser redirigidas.
Puede especificar patrones de URL excluidas utilizando tipos de patrón de Expresión Regular o Comodín.
Ejemplos
La opción Ejemplos le permite probar su regla de redirección proporcionando URL de muestra. Al añadir una URL de muestra, puede comprobar si la regla funciona como se esperaba antes de aplicarla.
Comentarios
La opción Comentarios le permite añadir notas o comentarios sobre su regla de redirección. Esto puede ser útil para llevar un registro de por qué creó una regla específica o para proporcionar contexto a otras personas que puedan ver sus reglas.
Patrón de URL
Hay 3 opciones en las que puede especificar uno o más patrones de URL. Redirigir Desde, Patrones de URL Excluidas y Procesamiento de Grupos de Captura. Para especificarlos, puede elegir Comodín o Expresión Regular.
Comodín
Comodín es un tipo de patrón más simple que le permite usar *
(coincide con cualquier cosa) y ?
(coincide con cualquier carácter único) como comodines. Aquí hay algunos ejemplos:
- Para que coincida con
https://example.com/hello
, puede usarhttps://example.com/*
. Esto coincidirá con cualquier cadena después dehttps://example.com/
. - Para que coincida con
https://example.com/search?q=hello
, puede usarhttps://example.com/search?q=*
. Esto coincidirá con cualquier valor para el parámetroq
. - Para que coincida con cualquier URL que contenga la palabra
blog
, puede usar*blog*
.
También puede usar la sustitución en Comodín, lo que significa que puede hacer referencia a partes de la URL coincidente usando $1
, $2
, etc. Por ejemplo, si usa https://example.com/*-world-*
, y la URL es https://example.com/hello-world-goodbye
, entonces $1
sería "hello" y $2
sería "goodbye". $0
también está disponible para hacer referencia a toda la URL coincidente.
[!Note] Aunque la sustitución es una característica de la Expresión Regular, también puede usarla para Comodín porque Redirect Web convierte internamente Comodín a Expresión Regular.
Expresión Regular
La Expresión Regular (Regex) es una herramienta potente para hacer coincidir patrones en texto, impulsada por el motor de expresiones regulares de Apple que se describe aquí. Le permite definir un patrón específico que coincide con un conjunto de cadenas. Aquí hay algunos ejemplos.
- Para que coincida con
https://example.com/hello
, puede usarhttps://example.com/(.*)
. Esto coincidirá con cualquier cadena después dehttps://example.com/
y la almacenará en un grupo de captura. - Para que coincida con
https://example.com/search?q=hello
, puede usarhttps://example.com/search\?q=(.*)
. Esto coincidirá con el valor del parámetroq
y lo almacenará en un grupo de captura. - Para que coincida con cualquier URL que contenga la palabra
blog
, puede usar.*blog.*
.
Puede hacer referencia a los grupos de captura en Redirigir A o Reemplazo usando $1
, $2
, ... o $0
para hacer referencia a toda la coincidencia.
Puede encontrar más información sobre la sintaxis de Regex en recursos como RegExr.