Location

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

* Some parts of this feature may have varying levels of support.

La interfaceLocation representa la ubicación (URL) del objeto al que esta vinculado. Los cambios hechos en ella son reflejados en el objeto al cual está relacionado. Ambas interfaces,Document yWindow tienen una interfaceLocation asignada, accessible desdeDocument.location yWindow.location respectivamente.

Propiedades

La interfaceLocationno hereda ninguna propiedad, pero las implementa desdeURLUtils.

Location.href: Es unDOMString 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 unDOMString que contiene el esquema del protocolo de la URL, incluyendo el':' final.
Location.host: Es unDOMString que contiene el host, el cual esta compuesta por:hostname,':', y elport de la URL.
Location.hostname: Es unDOMString que contiene el dominio de la URL.
Location.port: Es unDOMString que contiene el numero del puerto de la URL.
Location.pathname: Es unDOMString que contiene el'/' inicial, seguido por la ruta de la URL.
Location.search: Es unDOMString que contiene un'?' seguido por los parametros o el "querystring" de la URL. Navegadores modernos proveenURLSearchParams yURL.searchParams para hacer mas facil de obtener los parametros desde el querystring.
Location.hash: Es unDOMString que contiene un'#' seguido por el fragmento identificador de la URL.
Location.username: Es unDOMString que contiene elusername (usuario) especificado antes del dominio.
Location.password: Es unDOMString que contiene elpassword (contraseña) especificado antes del dominio.
Location.originRead only: Es unDOMString que contiene la forma canonica delorigin (origen) de la URL.

Metodos

La interfaceLocation no hereda ningun metodo, pero los implementa desdeURLUtils.

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 esBoolean, el cual, cuando estrue, hace que la pagina siempre sea recargada desde el servidor. Si esfalse 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 metodoassign() es que luego de usarreplace() la pagina actual no va a ser guardada en la sesiónHistory, esto significa que el usuario no podrá usar el botonAtras para navegar a esta.
Location.toString(): Retorna unDOMString que contiene la URL completa. Es un sinonimo deURLUtils.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.locationvar 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-containerconsole.log(url.protocol); // https:console.log(url.host); // developer.mozilla.org:8080console.log(url.hostname); // developer.mozilla.orgconsole.log(url.port); // 8080console.log(url.pathname); // /en-US/searchconsole.log(url.search); // ?q=URLconsole.log(url.hash); // #search-results-close-containerconsole.log(url.origin); // https://developer.mozilla.org