Extraer segmentos de ruta de una URL y convertirlos en rutas

PublicadoHerramientaAnalizador de Segmentos de Ruta URL

Contenido
  1. El problema de contar mal los fragmentos al pasar una URL larga a una ruta
  2. Cómo descomponerla solo con el navegador, sin herramientas
  3. Errores habituales al leer el resultado
  4. Conclusión
  5. Preguntas frecuentes

Si copias una URL larga de la barra de direcciones o de un log y quieres convertirla en una ruta, es fácil liarse: hasta dónde llega la ruta, dónde empieza la consulta y qué fragmento se convierte en variable. Este artículo es para ti. Yendo directo al grano: descomponer una URL se resuelve con unas pocas reglas.

Solo los fragmentos de ruta separados por barras reciben un índice; la consulta que va después de ? no cuenta como segmento de ruta, y que un segmento se convierta o no en variable se decide con una única condición fija. Este artículo trata únicamente de cómo se hace ese cálculo exactamente y de cómo leer el resultado.

Resumen ① Una URL se divide en protocolo (https:), host (hostname), segmentos de ruta y consulta, y solo los fragmentos de ruta separados por barras reciben un índice en orden /0, /1. ② La consulta que va después de ? no cuenta como segmento de ruta: se extrae en su propia tabla de clave-valor, y los fragmentos vacíos que generan las barras consecutivas o la barra final se descartan automáticamente. ③ Si un segmento está formado solo por números o tiene nueve caracteres o más, se sustituye por un parámetro dinámico (:variable / [variable]); en caso contrario, se deja tal cual estaba.

El problema de contar mal los fragmentos al pasar una URL larga a una ruta

Imagina que quieres convertir en ruta una URL como https://shop.example.com/products/948213/reviews/?sort=recent.

Aquí hay tres puntos en los que la gente suele atascarse. Si ?sort=recent es un fragmento de ruta más, si la barra del final crea un fragmento vacío que desplaza los índices, y si solo hay que capturar como variable un valor con la forma de 948213.

Si resuelves estas tres cosas a ojo, es fácil que la ruta acabe sin coincidir con la petición real. Por suerte, todo este criterio son reglas mecánicas: si entiendes el principio, obtendrás siempre la misma respuesta.

Cómo descomponerla solo con el navegador, sin herramientas

Este cálculo se puede reproducir tal cual con la API URL integrada en el navegador. Basta con pegar lo siguiente en la consola de las herramientas de desarrollo (F12).

const u = new URL("https://shop.example.com/products/948213/reviews/?sort=recent");
u.protocol;                            // "https:"
u.hostname;                            // "shop.example.com"
u.pathname;                            // "/products/948213/reviews/"
u.pathname.split("/").filter(Boolean); // ["products", "948213", "reviews"]
[...u.searchParams];                   // [["sort", "recent"]]

El orden de los pasos es este.

  1. protocol y hostname se separan primero como protocolo y host.
  2. Se corta pathname por la barra (/) y se descartan las cadenas vacías. Aquí desaparecen todas: la que genera la barra inicial, las de las barras consecutivas y la de la barra final.
  3. A los fragmentos restantes se les numera de delante hacia atrás como 0, 1, 2. Por eso el ejemplo anterior da tres: products (/0), 948213 (/1) y reviews (/2).
  4. La consulta que va después de ? se lee aparte con searchParams, como pares clave-valor. No entra en la cuenta de fragmentos de ruta.

Por último, se decide si cada fragmento es una variable. La regla es sencilla: si está formado solo por números o si su longitud supera los ocho caracteres (nueve o más), se sustituye por una variable; si no, se deja tal cual. En el ejemplo anterior solo 948213 es numérico, así que se convierte en variable, mientras que products y reviews se quedan como están.

Compruébalo con nuestra herramienta.

Analizador de Segmentos de Ruta URL

Con el Analizador de Segmentos de Ruta URL, pega una URL y verás al instante sus segmentos de ruta, la query y los patrones de ruta de Express y Next.js. Funciona gratis, sin instalar nada ni iniciar sesión.

Errores habituales al leer el resultado

La confusión más frecuente es contar los parámetros de consulta como segmentos de ruta. ?sort=recent no es un segmento: va aparte, en la tabla de consulta, así que después del índice /2 no continúa un /3.

La segunda es creer que la barra final desplaza los índices un puesto. Como los fragmentos vacíos se descartan, /reviews y /reviews/ dan el mismo resultado de segmentos.

La tercera es esperar que "todo lo que parece un id se convierta en variable". El criterio no mira el significado del valor, solo su forma (si es numérico y su longitud). Por eso un id corto de texto (como abc) se queda como está, y si lo necesitas puedes escribir un nombre en el campo de nombre de variable para convertirlo en variable.

Para ver cómo se representa el mismo segmento en los dos frameworks, tomemos el ejemplo por defecto de la herramienta, https://example.com/users/123/posts/abc:

Segmento (índice)VeredictoExpress.jsNext.js App Router
users (/0)Texto, ocho caracteres o menosusersusers
123 (/1)Solo números:param1[param1]
posts (/2)Texto, ocho caracteres o menospostsposts
abc (/3)Texto, ocho caracteres o menosabcabc

Así, la ruta final queda como /users/:param1/posts/abc en Express y como app/users/[param1]/posts/abc/page.tsx en Next.js App Router.

Los nombres de variable por defecto se asignan automáticamente según el índice: param0, param1, etc. Antes de cambiarlo verás :param1, no :userId; en cuanto escribes el nombre que quieras en el campo, cambia a la vez a :userId (Express) y [userId] (Next.js). Un fragmento de nueve caracteres o más, como introduction, cumple la condición y se convierte en variable aunque no sea numérico.

Conclusión

  • Una URL se divide en protocolo, host, ruta y consulta, y solo los fragmentos de ruta separados por barras reciben índices /0, /1.
  • La consulta que va después de ? se lee como pares clave-valor aparte, no como segmentos de ruta, y no se incluye en el número de segmentos.
  • Los fragmentos vacíos que generan las barras consecutivas y la barra final se descartan automáticamente, así que los índices no se desplazan.
  • Un segmento se sustituye por una variable cuando está formado solo por números o cuando tiene nueve caracteres o más; el resto se queda tal cual. Si escribes un nombre a mano, se convierte en variable independientemente de la condición.
  • El mismo segmento se representa como :variable en Express y como carpeta [variable] en Next.js App Router.
Analizador de Segmentos de Ruta URL

Con el Analizador de Segmentos de Ruta URL, pega una URL y verás al instante sus segmentos de ruta, la query y los patrones de ruta de Express y Next.js. Funciona gratis, sin instalar nada ni iniciar sesión.

Preguntas frecuentes

¿Los parámetros de consulta (lo que va después de ?) también cuentan como segmentos de ruta?

No. Lo que va después de ? no es ruta, es una cadena de consulta, así que no forma parte de los segmentos que se separan por barras. La consulta se lee aparte con searchParams y se muestra como tabla de clave-valor; no se añade a los índices de los segmentos de ruta (/0, /1…).

Si hay una barra final, ¿se desplazan los índices de los segmentos?

No. Como después de cortar la ruta por barras se descartan las cadenas vacías, el fragmento vacío que crean la barra del final o las barras consecutivas intermedias desaparece. Por eso /a/b/, /a/b y /a//b dan exactamente los mismos segmentos.

¿Qué criterio hace que un fragmento sea variable y otro se quede igual?

Se sustituye por una variable si cumple una de estas dos condiciones: que el segmento esté formado solo por números, o que su longitud supere los ocho caracteres (nueve o más). Este criterio mira solo la forma, no el significado del valor. Aunque no cumpla la condición, si escribes un nombre en el campo de nombre de variable, ese fragmento se convierte en variable.

¿Puedo introducir solo la ruta, sin protocolo (http/https)?

Sí. Las entradas que no empiezan por https:// se analizan añadiéndoles un host temporal, así que aunque pongas solo la ruta, como /users/123/posts/abc, los segmentos se descomponen igual. Las entradas especiales que fallan en el análisis estándar se tratan con un método alternativo que separa manualmente por ? y /.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Codificación URL: qué es el percent encoding y sus reglasDescubre por qué la URL no admite espacios ni texto no ASCII, cómo funciona el percent encoding y en qué se diferencian encodeURI y encodeURIComponent.
  2. User-Agent: estructura del encabezado y simulación de botsAprende cómo se compone la cadena User-Agent, cómo detectar navegador, móvil o bot con regex y Client Hints, y cómo probarlo sin dispositivos reales.
  3. CSS Grid: calcula fr y crea layouts responsivosAprende a usar fr, grid-template-areas y auto-fit con minmax() para diseñar cuadrículas de dos dimensiones y layouts responsivos sin media queries.
  4. XML a JSON: por qué cambian los arrays y los atributosAl convertir XML a JSON, los arrays se vuelven etiquetas repetidas y los atributos pasan a @attributes. Aquí tienes la regla para preverlo.
  5. XML bien formado: qué es y por qué es más estricto que HTMLEl navegador repara las etiquetas sin cerrar de HTML, pero XML rechaza el documento entero por un solo error. Aprende las reglas y cómo comprobarlas.
  6. Convertir YAML a JSON: reglas y errores al pasar tu configuraciónPor qué YAML no sirve en código o en una petición a la API, las reglas para convertir a JSON a mano y los puntos donde es fácil equivocarse.

Herramientas relacionadas