CKTIS / JavaScript
URL.hash — le fragment de l’URL
URL.hash lit et définit le fragment d’une URL. Découvrez son comportement d’encodage et la différence entre un fragment vide et un fragment absent.
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
url.hash
url.hash = fragmentURL.hash est une propriété d’instance modifiable de URL, et non une méthode statique. Elle renvoie le fragment précédé de #, ou "" si le fragment est vide ou absent.
L’affectation accepte un texte avec ou sans # initial. Les caractères qui le nécessitent sont encodés en pourcentage ; leur lecture ne les décode pas. Une espace devient %20.
url.hash = '' supprime le fragment. url.hash = '#' conserve un fragment vide : url.hash renvoie toujours "", mais url.href se termine par #. Il s’agit d’une API Web du WHATWG URL Standard, et non d’une fonctionnalité définie par ECMAScript.
Exemples
const url = new URL('https://example.org/');
url.hash = 'part one';
console.log(url.hash);
url.hash = '#';
console.log(JSON.stringify(url.hash), url.href);
url.hash = '';
console.log(url.href);Résultat
#part%20one "" https://example.org/# https://example.org/
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.