--- title: Location slug: Web/API/Location tags: - API - HTML DOM - Interface - Location - Referencia translation_of: Web/API/Location ---

{{APIRef("HTML DOM")}}

La interface Location 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, {{domxref("Document")}} y {{domxref("Window")}} tienen una interface Location asignada, accessible desde {{domxref("Document.location")}} y {{domxref("Window.location")}} respectivamente.

Propiedades

La interface Location no hereda ninguna propiedad, pero las implementa desde {{domxref("URLUtils")}}.

{{domxref("Location.href")}}
Es un {{domxref("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.
{{domxref("Location.protocol")}}
Es un {{domxref("DOMString")}} que contiene el esquema del protocolo de la URL, incluyendo el ':' final.
{{domxref("Location.host")}}
Es un {{domxref("DOMString")}} que contiene el host, el cual esta compuesta por: hostname,  ':', y el port de la URL.
{{domxref("Location.hostname")}}
Es un {{domxref("DOMString")}} que contiene el dominio de la URL.
{{domxref("Location.port")}}
Es un {{domxref("DOMString")}} que contiene el numero del puerto de la URL.
{{domxref("Location.pathname")}}
Es un {{domxref("DOMString")}} que contiene el '/' inicial, seguido por la ruta de la URL.
{{domxref("Location.search")}}
Es un {{domxref("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.
{{domxref("Location.hash")}}
Es un {{domxref("DOMString")}} que contiene un '#' seguido por el fragmento identificador de la URL.
{{domxref("Location.username")}}
Es un {{domxref("DOMString")}} que contiene el username (usuario) especificado antes del dominio.
{{domxref("Location.password")}}
Es un {{domxref("DOMString")}} que contiene el password (contraseña) especificado antes del dominio.
{{domxref("Location.origin")}} {{readOnlyInline}}
Es un {{domxref("DOMString")}} que contiene la forma canonica del origin (origen) de la URL.

Metodos

La interface Location no hereda ningun metodo, pero los implementa desde {{domxref("URLUtils")}}.

{{domxref("Location.assign()")}}
Carga el recurso en la URL proporcionada en el parámetro.
{{domxref("Location.reload()")}}
Recarga el recurso desde la URL actual. Si unico y opcional parametro es {{domxref("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.
{{domxref("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 {{domxref("History")}}, esto significa que el usuario no podrá usar el boton Atras para navegar a esta.
{{domxref("Location.toString()")}}
Retorna un {{domxref("DOMString")}} que contiene la URL completa. Es un sinonimo de {{domxref("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
{{SpecName('HTML WHATWG', "browsers.html#the-location-interface", "Location")}} {{Spec2('HTML WHATWG')}} No change from {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}} {{Spec2('HTML5 W3C')}} Definicion inicial.

Compatibilidad con navegadores

{{CompatibilityTable}}

Caracteristica Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Soporte basico {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
origin en Windows.location {{CompatUnknown}} {{CompatUnknown}} {{CompatGeckoDesktop("21")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
origin en todos los objetos location (pero en Workes, usa {{domxref("WorkerLocation")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatGeckoDesktop("26")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
username and password {{CompatUnknown}} {{CompatUnknown}} {{CompatGeckoDesktop("26")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
Caracteristica Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Soporte basico {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
origin en Windows.location {{CompatUnknown}} {{CompatUnknown}} {{CompatGeckoMobile("21")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
origin en todos los objetos location (pero en Workers, usa {{domxref("WorkerLocation")}}) {{CompatUnknown}} {{CompatUnknown}} {{CompatGeckoMobile("26")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
username y password {{CompatUnknown}} {{CompatUnknown}} {{CompatGeckoMobile("26")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}

Vea también