Configuración de Reglas
Esta página proporciona información detallada de cada configuración en la pantalla Editar Regla en la aplicación Redirect Web.
Opciones
Tipo
Especifique la opción Tipo para controlar cómo la aplicación maneja la redirección. Puede elegir entre estas:
- Original (Predeterminado)
- Esto utiliza las API web tradicionales para controlar la redirección. Además, utiliza la API de Pestañas como respaldo.
- 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.
- Esto es más lento que el tipo Declarativo y puede causar solicitudes de red adicionales.
- Esto utiliza las API web tradicionales para controlar la redirección. Además, utiliza la API de Pestañas como respaldo.
- 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.
- Esto le permite especificar Tipos de Recursos y Métodos de Solicitud.
- ⚠️ No puede usar algunas opciones, como Procesamiento de Grupo de Captura y Patrones de URL Excluidos, ya que aún no son compatibles con la API de DNR.
- ⚠️ En Safari, actualmente no puede incluir barras verticales (
|
) en su patrón de Expresión Regular. Detalles - ⚠️ Dado que la API de DNR de Safari todavía tiene algunos problemas, consideramos que sigue siendo una característica 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 Comodín o Expresión Regular.
Por ejemplo, si especifica https://example.com/*
con Comodín, coincide con https://example.com/
o https://example.com/hello
.
En la opción Redirigir A, puede hacer referencia a la coincidencia completa usando $0
o 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, estos 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 mdn web docs.
Métodos de Solicitud
La opción Métodos de Solicitud le permite establecer los métodos HTTP de destino de la URL de origen.
Todos los métodos están configurados por defecto.
Consulte los detalles de cada método en mdn web docs.
En Safari, esta opción puede no estar disponible porque la implementación de Apple para el tipo DNR no parece manejarla actualmente. Enviamos comentarios a Apple como FB14502272.
Navegadores de Destino
La opción Navegadores de Destino le permite especificar a qué navegador se debe o no se debe 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 Agregar en el menú emergente, 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 grupos de captura con $1
, $2
, ... o la coincidencia completa con $0
. Esto le ayuda a especificar dinámicamente el destino. 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 sustituciones. Consulte la sección Procesamiento de Grupo de Captura para obtener los detalles.
Puede especificar un esquema de URL personalizado para abrir una aplicación. Estos son ejemplos de aplicaciones que admiten enlaces profundos:
- 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, use 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 la apertura de la URL que desea abrir.
Procesamiento de Grupo de Captura
La opción Procesamiento de Grupo 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 de porcentaje o decodificación 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 de forma opuesta. - 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 qué URL se excluyen por los Patrones de URL Excluidos. Por ejemplo, digamos que tiene esta regla:
- Redirigir Desde:
https://example.com/(hello.*)
- Procesamiento de Grupo de Captura:
- Grupo:
$1
- Objetivo:
.*
(Expresión Regular) - Reemplazo:
hello
- Grupo:
- Patrón de URL Excluido:
https://example.com/hello
En este caso, https://example.com/hello_world
no se excluirá mientras que https://example.com/hello
sí se excluirá.
Patrones de URL Excluidos
La opción Patrones de URL Excluidos 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 excluidos usando 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 ejemplo. Al agregar una URL de ejemplo, puede verificar si la regla funciona como se espera antes de aplicarla.
Comentarios
La opción Comentarios le permite agregar 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 otros 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 Excluidos y Procesamiento de Grupo 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 porciones 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.
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
Expresión Regular (Regex) es una herramienta poderosa 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 la coincidencia completa.
Más información sobre la sintaxis de Regex se puede encontrar en recursos como RegExr.