CKTIS / JavaScript
history.pushState() — une entrée d’historique sans rechargement
history.pushState() ajoute normalement une entrée à l’historique de session, enregistre un état et modifie éventuellement l’URL sans charger un nouveau document. La mise à jour de l’interface reste à votre charge.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
history.pushState(state, unused[, url]);history.pushState() est une API de navigateur définie par HTML, et non par ECMAScript ; les moteurs de navigateur actuels la prennent en charge. La disponibilité de Node 24 ne prouve pas qu’elle y soit disponible. La méthode ajoute normalement une entrée à l’historique de session, mais sur un document about:blank initial, elle remplace l’entrée actuelle au lieu d’en ajouter une. Dans les deux cas, elle ne charge pas de nouveau document et renvoie undefined. En revanche, history.replaceState() met à jour l’entrée actuelle sans en ajouter de nouvelle.
state est sérialisé et n’est pas conservé sous forme de référence ; vous pouvez le lire avec history.state. Les fonctions ne peuvent pas être enregistrées de cette manière et provoquent DataCloneError. Le paramètre obligatoire unused reçoit généralement la valeur '' ; il ne définit pas le titre de la page.
L’argument facultatif url peut être relatif ; si vous l’omettez, l’adresse reste inchangée. Sur les pages HTTP(S), il doit conserver la même origine : schéma, hôte et port. Une URL interdite, un document qui n’est pas entièrement actif ou des appels trop fréquents peuvent provoquer SecurityError.
L’appel ne déclenche ni popstate ni hashchange, même si le fragment change. Mettez vous-même l’interface à jour ; pour la navigation Précédent/Suivant, gérez popstate et event.state. L’exemple montre qu’une modification ultérieure de l’objet fourni ne modifie pas l’état enregistré.
Exemples
(() => {
const state = { page: 2 };
const url = new URL(location.href);
url.hash = 'cktis-page-2';
const result = history.pushState(state, '', url.href);
state.page = 99;
console.log(JSON.stringify({
page: history.state.page,
hash: location.hash,
returnsUndefined: result === undefined
}));
})();Résultat
{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.