Saltar al contenido principal

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.
    • 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.
  • 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.

nota

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

Tipos Soportados: DNR

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

Tipos Soportados: DNR

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.

aviso

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

Plataformas Soportadas: macOS

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.
aviso

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.

tip

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

Tipos Soportados: Original Plataformas Soportadas: macOS

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.

aviso

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

Tipos Soportados: Original

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 en https%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 a aGVsbG8=, y decodificarlo de nuevo a hello.
  • 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 es l y el Reemplazo es y, se modifica a heyyo.
nota

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
  • 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

Tipos Soportados: Original

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 usar https://example.com/*. Esto coincidirá con cualquier cadena después de https://example.com/.
  • Para que coincida con https://example.com/search?q=hello, puede usar https://example.com/search?q=*. Esto coincidirá con cualquier valor para el parámetro q.
  • 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.

nota

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 usar https://example.com/(.*). Esto coincidirá con cualquier cadena después de https://example.com/ y la almacenará en un grupo de captura.
  • Para que coincida con https://example.com/search?q=hello, puede usar https://example.com/search\?q=(.*). Esto coincidirá con el valor del parámetro q 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.