Extraer segmentos de ruta de una URL y convertirlos en rutas

Contenido
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.
protocolyhostnamese separan primero como protocolo y host.- Se corta
pathnamepor 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. - 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) yreviews(/2). - La consulta que va después de
?se lee aparte consearchParams, 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.
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) | Veredicto | Express.js | Next.js App Router |
|---|---|---|---|
users (/0) | Texto, ocho caracteres o menos | users | users |
123 (/1) | Solo números | :param1 | [param1] |
posts (/2) | Texto, ocho caracteres o menos | posts | posts |
abc (/3) | Texto, ocho caracteres o menos | abc | abc |
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
:variableen Express y como carpeta[variable]en Next.js App Router.
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