Historial
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
La interfaz History
(Historial) permite la manipulación del historial de sesiones del navegador, es decir, las páginas visitadas en la pestaña o marco en el que se carga la página actual.
Solo hay una instancia de history
(es un singleton.) accesible a través del objeto global history
.
Propiedades de instancia
La interfaz History
no hereda ninguna propiedad.
length
Read only-
Devuelve un
Integer
que representa el número de elementos en el historial de la sesión, incluida la página cargada actualmente. Por ejemplo, para una página cargada en una nueva pestaña, esta propiedad devuelve1
. scrollRestoration
-
Permite que las aplicaciones web establezcan explícitamente el comportamiento de restauración de desplazamiento predeterminado en la navegación del historial. Esta propiedad puede ser
auto
omanual
. state
Read only-
Devuelve un valor
any
que representa el estado en la parte superior de la pila de historial. Esta es una forma de ver el estado sin tener que esperar un eventopopstate
.
Métodos de instancia
La interfaz History
no hereda ningún método.
back()
-
Este método asíncrono va a la página anterior en el historial de la sesión, la misma acción que cuando el usuario hace clic en el botón Atrás del navegador. Equivalente a
history.go(-1)
.Llamar a este método para volver más allá de la primera página en el historial de la sesión no tiene ningún efecto y no genera una excepción.
forward()
-
Este método asincrónico va a la página siguiente en el historial de la sesión, la misma acción que cuando el usuario hace clic en el botón Adelante del navegador; esto es equivalente a
history.go(1)
.Llamar a este método para avanzar más allá de la página más reciente en el historial de la sesión no tiene ningún efecto y no genera una excepción.
go()
-
Carga asíncronamente una página del historial de la sesión, identificada por su ubicación relativa a la página actual, por ejemplo,
-1
para la página anterior o1
para la página siguiente. Si especifica un valor fuera de los límites (por ejemplo, si especifica "-1" cuando no hay páginas visitadas anteriormente en el historial de la sesión), este método no tiene ningún efecto. Llamar ago()
sin parámetros o un valor de0
vuelve a cargar la página actual. pushState()
-
Inserta los datos proporcionados en la pila del historial de la sesión con el título especificado (y, si se proporciona, la URL). El DOM trata los datos como opacos; puede especificar cualquier objeto de JavaScript que se pueda serializar. Tenga en cuenta que todos los navegadores, excepto Safari, actualmente ignoran el parámetro title. Para obtener más información, consulte Trabajar con la API History.
replaceState()
-
Actualiza la entrada más reciente en la pila de historial para tener los datos, el título y, si se proporciona, la URL especificada. El DOM trata los datos como opacos; puede especificar cualquier objeto de JavaScript que se pueda serializar. Tenga en cuenta que todos los navegadores, excepto Safari, actualmente ignoran el parámetro title. Para obtener más información, consulte Trabajar con la API History.
Especificaciones
Specification |
---|
HTML Standard # the-history-interface |
Compatibilidad con navegadores
BCD tables only load in the browser
Véase también
- Objeto global
history