Saltar al contenido
Biblioteca estándar

URL y URLSearchParams

Lección 5 de 79 min4 ejercicios

Armar una dirección pegando textos, "/buscar?q=" + texto, funciona hasta que alguien busca "té & café" y el & parte el parámetro en dos. La clase URL entiende las direcciones como el navegador: las separa en partes, resuelve rutas relativas y codifica cada carácter donde corresponde.

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.canParse y URL.parse comprueban sin lanzar errores.
  • searchParams lee 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

Elige una respuesta en cada pregunta.

  1. En https://tienda.com:8080/buscar?q=te#arriba, ¿qué es ?q=te?

  2. ¿Por qué usar searchParams.set en lugar de armar "?q=" + texto?

  3. ¿Qué hace new URL("../ayuda", "https://a.com/es/buscar")?

  4. ¿Qué diferencia hay entre URL.parse(texto) y new URL(texto)?

Ordena la salida: Leer y cambiar una URL

Una URL que se lee, se cambia y se resuelve. Ordena lo que aparecería en la consola.

const url = new URL("https://tienda.com/buscar?q=te+verde&pagina=2#resultados"); console.log(url.hostname, url.pathname);console.log(url.searchParams.get("q")); url.searchParams.set("pagina", "3");url.searchParams.append("orden", "precio");console.log(url.search); console.log(new URL("../ayuda", "https://tienda.com/es/buscar").href);

Consola, de arriba abajo

  1. ?q=te+verde&pagina=3&orden=precio
  2. tienda.com /buscar
  3. https://tienda.com/ayuda
  4. te verde

Detective: Una ruta sin base

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.

Laboratorio: Agregar filtros a una URL

Escribe conFiltros(direccion, filtros) con URL y searchParams.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

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 URL y searchParams.set (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.