En el modelo de objetos del navegador (BOM), el objeto location (disponible a través de window.location o de forma implícita como location) contiene información detallada sobre la URL actual del documento.
Su doble finalidad es analizar y descomponer las diferentes partes de una URL para trabajar con ellas de forma independiente, y modificarlas para redirigir el navegador hacia una nueva dirección.
Para entender sus propiedades, recordemos la estructura básica de una URL:
protocolo://maquina_host[:puerto]/camino_al_recurso?parametros#anclaje
Ejemplo: [http://www.marca.com:8080/champion?id=12#noticia](http://www.marca.com:8080/champion?id=12#noticia)
Propiedades principales de location
El objeto desglosa la URL en componentes accesibles mediante las siguientes propiedades:
| Propiedad | Descripción | Ejemplo (http://…:8080/path?query#hash) |
href |
Contiene la URL completa. Modificar esta propiedad redirige inmediatamente el navegador. | "http://...:8080/path?query#hash" |
protocol |
El protocolo utilizado para acceder al recurso, incluyendo los dos puntos finales. | "http:" o "https:" |
host |
El nombre del servidor (host) junto con el número de puerto (si está especificado). | "[www.marca.com:8080](https://www.marca.com:8080)" |
hostname |
El nombre de dominio del servidor o la dirección IP, excluyendo el puerto. | "[www.marca.com](https://www.marca.com)" |
port |
El número de puerto específico configurado en la URL. | "8080" (o cadena vacía si usa el puerto por defecto) |
pathname |
La ruta de acceso al recurso dentro del servidor. | "/champion" |
search |
La cadena de consulta (query string), incluyendo el signo de interrogación inicial (?). |
"?id=12" |
hash |
El anclaje o marcador interno en la página, incluyendo la almohadilla (#). |
"#noticia" |
Métodos principales de location
Los métodos de location permiten controlar la navegación y la carga de documentos de forma programática:
-
assign(url): Carga un nuevo documento indicando una URL. Es exactamente equivalente a reasignarlocation.href = url. -
replace(url): Sustituye la URL actual del documento por otra nueva. Su diferencia clave conassign()(o con cambiarhref) es que elimina la página actual del historial de navegación (history), impidiendo que el usuario pueda pulsar el botón «Atrás» para regresar a ella. -
reload(forceGet): Vuelve a cargar la página actual.-
Si se pasa
truecomo argumento, fuerza la recarga directamente desde el servidor (ignorando la caché del navegador). -
Si se pasa
falseo se omite, la página puede recargarse desde la caché local.
-
Ejemplo práctico de uso
Imagina que ejecutamos el siguiente código en la página [http://www.webestilo.com/javascript/ejem/ejem10.html](http://www.webestilo.com/javascript/ejem/ejem10.html):
console.log("Location href: " + location.href);
console.log("Location host: " + location.host);
console.log("Location hostname: " + location.hostname);
console.log("Location pathname: " + location.pathname);
console.log("Location port: " + location.port);
console.log("Location protocol: " + location.protocol);
Resultado en consola:
Location href: http://www.webestilo.com/javascript/ejem/ejem10.html
Location host: www.webestilo.com
Location hostname: www.webestilo.com
Location pathname: /javascript/ejem/ejem10.html
Location port:
Location protocol: http:
Ejemplos de navegación:
// Redirigir usando assign (queda guardado en el historial)
location.assign("https://www.ejemplo.com");
// Redirigir usando replace (la página actual no se puede recuperar con "Atrás")
location.replace("https://www.ejemplo.com");
// Recargar la página actual desde el servidor
location.reload(true);