Saltar al contenido principal

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

nota

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

Supported Types: 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, 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

Supported Types: DNR

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.

aviso

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

Supported Platforms: macOS

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

tip

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

Supported Types: Original Supported Platforms: macOS

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.

aviso

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

Supported Types: Original

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 en https%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 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 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
  • 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

Supported Types: Original

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 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 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 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 toda la coincidencia.

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