Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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 = fragment

URL.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.

Sources