CKTIS / JavaScript
URL.hash et URL.href : fragment et URL complète
Utilisez `hash` pour lire ou modifier le fragment, et `href` pour lire ou remplacer l’URL complète. La seule lecture de `hash` ne distingue pas un fragment vide d’un fragment absent.
Version : Current web platform; runtime support varies
Syntaxe
const url = new URL(input, base); // Omit base for an absolute input.
url.hash; // Fragment string
url.hash = fragment;
url.href; // Full serialized URL
url.href = absoluteUrl;hash et href sont des propriétés d’instance de URL, et non des méthodes ou des propriétés statiques. url.hash renvoie le fragment non vide précédé de #, ou "" si le fragment est vide ou absent. url.href renvoie l’URL sérialisée dans son intégralité, chaîne de requête comprise si elle existe. Un # final dans href distingue un fragment vide d’un fragment absent.
Affectez à url.hash le texte du fragment avec ou sans # initial. Les caractères tels que les espaces sont encodés en pourcentage si nécessaire, mais ne sont pas décodés automatiquement à la lecture. url.hash = "" supprime le fragment ; url.hash = "#" laisse un fragment vide. Le fragment est distinct de la chaîne de requête : url.searchParams gère les paramètres de cette chaîne, et le fragment n’est pas envoyé automatiquement au serveur lors d’une requête HTTP.
Une affectation à url.href analyse la nouvelle valeur et remplace l’URL entière dans le même objet. Si l’analyse échoue, elle lève une exception TypeError. Le setter ne résout pas les références relatives par rapport à l’URL actuelle ; utilisez pour cela new URL(relative, base).href avec une base valide.
Modifier un objet URL ne déclenche pas de navigation, contrairement à une affectation à window.location.href. Avant de naviguer vers une URL non fiable, vérifiez que son schéma et son origine sont autorisés : une analyse réussie ne rend pas l’URL sûre. URL est une API de la plateforme web, pas une fonctionnalité d’ECMAScript 2024 ; sa disponibilité dépend de l’environnement d’exécution.
Exemples
{
const url = new URL("https://example.com/guide?lang=en");
const show = () => console.log(JSON.stringify([url.hash, url.href]));
url.hash = "quick start";
show();
url.hash = "#";
show();
url.hash = "";
show();
url.href = "https://example.org/start#intro";
show();
}Résultat
["#quick%20start","https://example.com/guide?lang=en#quick%20start"] ["","https://example.com/guide?lang=en#"] ["","https://example.com/guide?lang=en"] ["#intro","https://example.org/start#intro"]
Chaque ligne affiche `[hash, href]`. Remarquez `%20`, le `#` final uniquement sur la deuxième ligne et le remplacement de l’URL entière sur la dernière.
Leçons associées
- JavaScript · Leçon 30 · Avancé · Version : 4