Saltar al contenido principal

Configuración de reglas

Esta página proporciona información detallada de cada configuración en la pantalla Editar regla de la aplicación Redirect Web.

Opciones​

Tipo​

Especifica la opción Tipo para controlar cómo la aplicación maneja la redirección. Puedes elegir entre estas:

  • Original (Predeterminado)
  • 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 te permite especificar Tipos de recursos y Métodos de solicitud.
    • ⚠️ No puedes usar algunas opciones, como Procesamiento de grupos de captura y Patrones de URL excluidos, ya que aún no son compatibles con la API de DNR.
    • ⚠️ En Safari, actualmente no puedes incluir barras verticales (|) en tu 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. Puedes encontrar la lista de todos los problemas conocidos aquí.

Redirigir desde​

La opción Redirigir desde te permite especificar un patrón de URL de las páginas web desde las que deseas redirigir. Puedes elegir entre Comodín o Expresión Regular.

Por ejemplo, si especificas https://example.com/* con Comodín, coincidirá con https://example.com/ o https://example.com/hello.

nota

En la opción Redirigir a, puedes hacer referencia a la coincidencia completa usando $0 o a coincidencias parciales usando $1, $2, ... Consulta los detalles en Patrón de URL en esta página.

Tipos de recursos​

Tipos admitidos: DNR

La opción Tipos de recursos te 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 configuras script, puedes 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.

Consulta los detalles de cada tipo de recurso en mdn web docs.

Métodos de solicitud​

Tipos admitidos: DNR

La opción Métodos de solicitud te permite establecer los métodos HTTP de destino de la URL de origen.

Todos los métodos están configurados por defecto.

Consulta 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 admitidas: macOS

La opción Navegadores de destino te permite especificar a qué navegador se debe o no aplicar la regla.

  • Hay 2 tipos de navegadores que puedes elegir:
    • Navegadores que puedes elegir por defecto: Puedes 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, puedes seleccionar cualquier navegador que no sea Safari o Safari Technology Preview que tenga instalada la extensión Redirect Web.
  • La casilla de verificación Todo excepto lo seleccionado te permite apuntar a todos los navegadores excepto los que hayas 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 deseas redirigir, desde la URL de origen que coincide con la opción Redirigir desde. También puedes sustituir grupos de captura con $1, $2, ... o la coincidencia completa con $0. Esto te ayuda a especificar dinámicamente el destino. Consulta los detalles en Patrón de URL en esta página.

Por ejemplo, si configuras 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, puedes modificar los textos de $1, $2, ... antes de realizar las sustituciones. Consulta la sección Procesamiento de grupos de captura para obtener los detalles.

tip

Puedes 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 admitidos: Original Plataformas admitidas: macOS

Si deseas especificar una aplicación en la que deseas abrir la URL de destino, utiliza el cuadro combinado Aplicación. Esto solo está disponible en macOS.

aviso

Solo puedes abrir una aplicación que admita App Sandbox. Además, asegúrate de que la aplicación admita la apertura de la URL que deseas abrir.

Procesamiento de grupos de captura​

Tipos admitidos: Original

La opción Procesamiento de grupos de captura te permite especificar cómo procesar los grupos capturados que puedes 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.

Puedes elegir uno o más de los siguientes procesos:

  • Codificar/Decodificar URL: Esto aplica codificación porcentual o decodificación a un grupo de captura. Por ejemplo, si codificas 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, puedes 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 a las URL excluidas por los Patrones de URL excluidos. Por ejemplo, supongamos que tienes esta regla:

  • Redirigir desde: https://example.com/(hello.*)
  • Procesamiento de grupos 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 admitidos: Original

La opción Patrones de URL excluidos te 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.

Puedes especificar patrones de URL excluidos usando tipos de patrón de Expresión Regular o Comodín.

Ejemplos​

La opción Ejemplos te permite probar tu regla de redirección proporcionando URLs de ejemplo. Al agregar una URL de ejemplo, puedes verificar si la regla funciona como se espera antes de aplicarla realmente.

Comentarios​

La opción Comentarios te permite agregar notas o comentarios sobre tu regla de redirección. Esto puede ser útil para llevar un registro de por qué creaste una regla específica o para proporcionar contexto a otros que puedan ver tus reglas.

Puedes escribir comentarios en los siguientes formatos:

  • Texto sin formato (Predeterminado): Texto simple sin ningún formato.
  • Markdown: Puedes usar sintaxis Markdown de GitHub, incluyendo algunas extensiones que GFM no admite. Por ejemplo, puedes crear encabezados, listas, enlaces y más.
  • AsciiDoc: Puedes usar sintaxis AsciiDoc para formatear tus comentarios.

Patrón de URL​

Los patrones de URL se utilizan para hacer coincidir URLs en las opciones Redirigir desde, Patrones de URL excluidos y Procesamiento de grupos de captura. Para especificarlos, puedes elegir entre Comodín o Expresión Regular.

Comodín​

Comodín es un tipo de patrón más simple que te permite usar * (coincide con cualquier cosa) y ? (coincide con cualquier carácter individual) como comodines. Aquí tienes algunos ejemplos:

  • Para que coincida con https://example.com/hello, puedes 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, puedes 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, puedes usar *blog*.

También puedes usar sustituciones en Comodín, lo que significa que puedes hacer referencia a porciones de la URL coincidente usando $1, $2, etc. Por ejemplo, si usas 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 puedes 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 poderosa para hacer coincidir patrones en texto y también se usa ampliamente en programación. Te permite definir un patrón específico que coincide con un conjunto de cadenas. Aquí tienes algunos ejemplos.

  • Para que coincida con https://example.com/hello, puedes 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, puedes usar https://example.com/search\?q=(.*). Esto coincidirá con el valor del parámetro q y lo almacenará en un grupo de captura. Luego puedes hacer referencia a él usando $1 en la opción Redirigir a.
  • Para que coincida con cualquier URL que contenga la palabra blog, puedes usar .*blog.*.

Puedes hacer referencia a los grupos de captura en Redirigir a o Reemplazo usando $1, $2, ... o $0 para hacer referencia a toda la coincidencia.

Redirect Web funciona con el motor Regex de Apple.

Puedes encontrar más información sobre la sintaxis de Regex en recursos como RegExr.