Las partes de una URL
const url = new URL("https://ana:clave@tienda.com:8080/productos/te?color=verde&pagina=2#opiniones");
console.log(url.protocol); // https:
console.log(url.username, url.password);
console.log(url.hostname, url.port);
console.log(url.host); // con el puerto
console.log(url.origin); // protocolo + host
console.log(url.pathname);
console.log(url.search);
console.log(url.hash);
Las partes se pueden cambiar, y la URL se actualiza entera:
const url = new URL("https://tienda.com/productos");
url.pathname = "/productos/té verde";
url.hash = "precio";
console.log(url.href);
Fíjate en que los caracteres especiales del camino se codificaron solos.
Rutas relativas
El segundo argumento es la base contra la que se resuelve una ruta relativa, igual que hace el navegador con un enlace:
const base = "https://tienda.com/es/productos/te";
console.log(new URL("cafe", base).href); // hermano
console.log(new URL("../ayuda", base).href); // sube un nivel
console.log(new URL("/carrito", base).href); // desde la raíz
console.log(new URL("?pagina=2", base).href); // solo cambia la búsqueda
¿Es una URL válida?
new URL lanza un TypeError si el texto no es una URL. Para comprobar sin try/catch:
console.log(URL.canParse("https://ejemplo.com")); // true
console.log(URL.canParse("no es una url")); // false
console.log(URL.parse("tampoco")); // null, en lugar de lanzar
console.log(URL.parse("/perfil", "https://a.com")?.href);
URLSearchParams
url.searchParams es un objeto para leer y escribir los parámetros de búsqueda, que se encarga de la codificación:
const url = new URL("https://tienda.com/buscar?q=te&etiqueta=oferta&etiqueta=nuevo");
const p = url.searchParams;
console.log(p.get("q"), p.has("pagina"));
console.log(p.getAll("etiqueta")); // un parámetro puede repetirse
p.set("q", "té & café"); // reemplaza
p.append("pagina", "2"); // agrega
p.delete("etiqueta");
console.log(url.search);
for (const [clave, valor] of p) console.log(clave, "=", valor);
También se puede usar sola, por ejemplo para armar el cuerpo de un formulario o leer los parámetros de la página actual:
const params = new URLSearchParams({ nombre: "Ana López", edad: 31 });
console.log(params.toString());
const leidos = new URLSearchParams("?orden=precio&desc=1");
console.log(Object.fromEntries(leidos));
Resumen
new URL(texto, base?)separa una dirección en partes:protocol,hostname,pathname,search,hash…- La base resuelve rutas relativas como un navegador.
URL.canParseyURL.parsecomprueban sin lanzar errores.searchParamslee y escribe parámetros (get,getAll,set,append,delete) y codifica por ti.- Nunca armes URLs concatenando textos.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Direcciones por partes
Resuelto
Elige una respuesta en cada pregunta.
En
https://tienda.com:8080/buscar?q=te#arriba, ¿qué es?q=te?¿Por qué usar
searchParams.seten lugar de armar"?q=" + texto?¿Qué hace
new URL("../ayuda", "https://a.com/es/buscar")?¿Qué diferencia hay entre
URL.parse(texto)ynew URL(texto)?
Ordena la salida: Leer y cambiar una URL
Resuelto
Una URL que se lee, se cambia y se resuelve. Ordena lo que aparecería en la consola.
1const url = new URL("https://tienda.com/buscar?q=te+verde&pagina=2#resultados");2 3console.log(url.hostname, url.pathname);4console.log(url.searchParams.get("q"));5 6url.searchParams.set("pagina", "3");7url.searchParams.append("orden", "precio");8console.log(url.search);9 10console.log(new URL("../ayuda", "https://tienda.com/es/buscar").href);Consola, de arriba abajo
- ?q=te+verde&pagina=3&orden=precio
- tienda.com /buscar
- https://tienda.com/ayuda
- te verde
searchParams.get decodifica: el + vuelve a ser un espacio. set reemplaza un parámetro y append agrega uno, y el search se actualiza solo. La ruta relativa sube un nivel desde /es/.
Detective: Una ruta sin base
Resuelto
Una función que arma enlaces a perfiles falla en Node.js. Encuentra la línea y elige el arreglo.
Consola
node:internal/url:816
href = bindingUrl.parse(input, base, true);
^
TypeError: Invalid URL
at new URL (node:internal/url:816:25)
at enlacePerfil (perfil.js:2:15) {
code: 'ERR_INVALID_URL',
input: '/perfil/ana'
}Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Agregar filtros a una URL
Resuelto
Escribe conFiltros(direccion, filtros) con URL y searchParams.
$ node programa.js
Lo que debe cumplir
- Imprime las dos direcciones con sus filtros (pendiente)
- Reemplaza en lugar de duplicar: no queda ningún
pagina=1(pendiente) - Usa
new URLysearchParams.set(pendiente)
Una solución
1function conFiltros(direccion, filtros) {2 const url = new URL(direccion);3 for (const [clave, valor] of Object.entries(filtros)) {4 url.searchParams.set(clave, valor);5 }6 return url.href;7}8 9console.log(conFiltros("https://tienda.com/buscar?q=te", { orden: "precio", pagina: 2 }));10console.log(conFiltros("https://tienda.com/buscar?pagina=1", { pagina: 3, marca: "té & café" }));Fíjate en la segunda dirección: el & de "té & café" se codificó como %26. Concatenando, ese & habría partido el parámetro en dos. searchParams codifica por ti.