CKTIS / JavaScript
`URL.origin`, `URL.pathname` et `URL.search`
Distinguez l’origine, le chemin et la chaîne de requête d’une URL analysée, puis lisez ses paramètres sans découper l’adresse à la main.
Version : Current web platform; runtime support varies
Syntaxe
const url = new URL(input);
const resolved = new URL(input, base);
url.origin;
url.pathname;
url.search;
url.pathname = "/catalog";
url.search = "page=2";origin, pathname et search sont des propriétés d’une instance de URL, pas des méthodes. URL est une API de la plateforme web, pas une fonctionnalité d’ECMAScript 2024 : vérifiez que votre environnement d’exécution la fournit. Utilisez new URL(input) pour une URL absolue et indiquez une base adaptée avec new URL(input, base) pour une référence relative. Si la base fournie est invalide ou si l’analyse échoue, le constructeur lève une exception TypeError. Modifier l’objet URL ne déclenche pas de navigation.
origin est en lecture seule. Pour HTTP(S), la propriété contient le schéma, le nom d’hôte et le port s’il diffère du port par défaut. Elle exclut les identifiants, le chemin, la requête et le fragment. Une origine opaque, comme celle d’une URL data:, est sérialisée sous la forme de la chaîne "null", et non de la valeur null. Deux chaînes de ce type ne prouvent pas que l’origine est la même. Le résultat pour file: dépend de l’implémentation.
pathname est le chemin sérialisé, sans la requête ni le fragment. Pour HTTP(S), il commence par / et le chemin racine est /. Les séquences encodées avec le signe %, comme %20, ne sont pas décodées automatiquement. Vous pouvez affecter un nouveau chemin HTTP(S). D’autres schémas peuvent avoir un chemin opaque sans / initial.
search renvoie la chaîne de requête avec son ? initial, sans le fragment et sans décoder les séquences en %. Si la requête est absente ou vide, y compris avec un ? seul, le résultat est "". Affectez une nouvelle requête avec ou sans ? initial ; affecter "" la supprime.
Utilisez url.searchParams.get("q") pour lire la valeur décodée d’un paramètre. Modifier searchParams met à jour le même objet URL et peut changer la sérialisation des valeurs existantes : un espace écrit %20 peut devenir +. Lisez href pour obtenir l’URL complète, fragment compris.
Exemples
{
const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
console.log(url.origin);
console.log(url.pathname);
console.log(url.search);
console.log(url.searchParams.get("q"));
url.searchParams.set("page", "2");
console.log(url.href);
}Résultat
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
La normalisation retire le port par défaut `443` et le segment de chemin `.`. `search` conserve `%20`, `get("q")` renvoie une valeur avec un espace et l’ajout de `page=2` fait apparaître cet espace sous la forme `+` dans la requête.
Leçons associées
- JavaScript · Leçon 38 · Avancé · Version : 4