La interface Location representa la ubicación (URL) del objeto al que esta vinculado. Los cambios hechos on ella son reflejados en el objeto al cual esta relacionado. Ambas interfaces, DocumentWindow tienen una interface Location asingnada, accessible desde Document.locationWindow.location respectivamente.

Propiedades

La interface Location no hereda ninguna propiedad, pero las implementa desde URLUtils.

Location.href
Es un DOMString que contiene la URL completa. Si es cambiada, el documento asociado navegará a la nueva pagina. Puede ser cambiada desde un origen diferente que el asociado al documento.
Location.protocol
Es un DOMString que contiene el esquema del protocolo de la URL, incluyendo el ':' final.
Location.host
Es un DOMString que contiene el host, el cual esta compuesta por: hostname,  ':', y el port de la URL.
Location.hostname
Es un DOMString que contiene el dominio de la URL.
Location.port
Es un DOMString que contiene el numero del puerto de la URL.
Location.pathname
Es un DOMString que contiene el '/' inicial, seguido por la ruta de la URL.
Location.search
Es un DOMString que contiene un '?' seguido por los parametros o el "querystring" de la URL. Navegadores modernos proveen URLSearchParams y URL.searchParams para hacer mas facil de obtener los parametros desde el querystring.
Location.hash
Es un DOMString que contiene un '#' seguido por el fragmento identificador de la URL.
Location.username
Es un DOMString que contiene el username (usuario) especificado antes del dominio.
Location.password
Es un DOMString que contiene el password (contraseña) especificado antes del dominio.
Location.origin Read only
Es un DOMString que contiene la forma canonica del origin (origen) de la URL.

Metodos

La interface Location no hereda ningun metodo, pero los implementa desde URLUtils.

Location.assign()
Carga el recurso en la URL proporcionada en el parámetro.
Location.reload()
Recarga el recurso desde la URL actual. Si unico y opcional parametro es Boolean, el cual, cuando es true, hace que la pagina siempre sea recargada desde el servidor. Si es false o no es especificado, el navegador puede recargar la pagina desde su cache.
Location.replace()
Reemplaza el recurso actual por el recibido como URL. La diferencia con el metodo assign() es que luego de usar replace() la pagina actual no va a ser guardada en la sesión History, esto significa que el usuario no podrá usar el boton Atras para navegar a esta.
Location.toString()
Retorna un DOMString que contiene la URL completa. Es un sinonimo de URLUtils.href, aunque este no puede ser utilizado para modificar el valor.

Ejemplo

// Crear un elemento <a> y usar la propiedad href para el proposito de este ejemplo.
// Una alternativa mas correcta es navegar a la URL y usar document.location o window.location
var url = document.createElement('a');
url.href = 'https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container';
console.log(url.href);      // https://developer.mozilla.org/en-US/search?q=URL#search-results-close-container
console.log(url.protocol);  // https:
console.log(url.host);      // developer.mozilla.org:8080
console.log(url.hostname);  // developer.mozilla.org
console.log(url.port);      // 8080
console.log(url.pathname);  // /en-US/search
console.log(url.search);    // ?q=URL
console.log(url.hash);      // #search-results-close-container
console.log(url.origin);    // https://developer.mozilla.org

Especificaciones

Especificacion Estado Comentario
HTML Living Standard
The definition of 'Location' in that specification.
Living Standard No change from HTML5.
HTML5
The definition of 'Location' in that specification.
Recommendation Definicion inicial.

Compatibilidad con navegadores

Caracteristica Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Soporte basico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
origin en Windows.location ? ? 21 (21) ? ? ?
origin en todos los objetos location (pero en Workes, usa WorkerLocation ? ? 26 (26) ? ? ?
username and password ? ? 26 (26) ? ? ?
Caracteristica Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Soporte basico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
origin en Windows.location ? ? 21.0 (21) ? ? ?
origin en todos los objetos location (pero en Workers, usa WorkerLocation) ? ? 26.0 (26) ? ? ?
username y password ? ? 26.0 (26) ? ? ?

Vea también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: BrodaNoel
 Última actualización por: BrodaNoel,