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, Document
y Window
tienen una interface Location
asignada, accessible desde Document.location
y Window.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 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 metodo
assign()
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 boton Atras para navegar a esta. Location.toString()
- Retorna un
DOMString
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.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 La definición de 'Location' en esta especificación. |
Living Standard | No change from HTML5. |
HTML5 La definición de 'Location' en esta especificación. |
Recommendation | Definicion inicial. |
Compatibilidad con navegadores
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
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
- Dos metodos que crean tal objeto:
Window.location
yDocument.location
. - URL relacionadas a interfaces:
URL
,URLSearchParams
yHTMLHyperlinkElementUtils