CKTIS / JavaScript
history.replaceState — actualizar la entrada actual del historial
history.replaceState actualiza el estado y, opcionalmente, la URL de la entrada actual del historial sin recargar la página. No añade una entrada, por lo que no crea un paso adicional para el botón Atrás.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
history.replaceState(data, unused)
history.replaceState(data, unused, url)history.replaceState(data, unused, url) reemplaza el estado de la entrada actual; history.pushState añade una entrada. Es una API del navegador definida por HTML, no una función de una edición concreta de ECMAScript. Disponer de Node 24 no demuestra que esté disponible en el navegador.
Pasa "" como argumento histórico obligatorio unused; no establece el título. Si se omite url, la dirección se conserva. El método devuelve undefined. No recarga el documento ni dispara por sí mismo popstate o hashchange.
data se clona de forma estructurada para almacenarlo; no se serializa como JSON. Lee el valor guardado mediante history.state; modificar después el objeto de entrada no cambia el valor almacenado. Las funciones y los nodos DOM no se pueden almacenar de esta manera y provocan DataCloneError.
Las reglas de reescritura comparan la URL propuesta con la URL actual del documento, no con su origen. Por ejemplo, un documento en about:blank puede cambiar el fragmento de su URL aunque herede su origen. Una URL no permitida, un documento que no esté completamente activo o las restricciones de frecuencia de llamadas pueden provocar SecurityError. Usa este método para corregir la vista actual, no para crear un nuevo paso de navegación.
Ejemplos
(() => {
const previousState = history.state;
const previousURL = location.href;
const previousLength = history.length;
const data = { tab: "details" };
const url = new URL(location.href);
url.hash = "details";
try {
history.replaceState(data, "", url.href);
data.tab = "changed";
console.log(history.state.tab);
console.log(location.hash);
console.log(history.length === previousLength);
} finally {
history.replaceState(previousState, "", previousURL);
}
})();Resultado
details #details true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.