CKTIS / JavaScript
URL — analyser et modifier des adresses
URL décompose une adresse en éléments, résout les références relatives et permet de modifier les paramètres de requête.
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
new URL(url, base?)URL est une API WHATWG, et non une API ECMAScript. new URL(url, base?) analyse une adresse ; les références relatives nécessitent une base. En cas d’échec de l’analyse, une TypeError est levée.
href expose l’adresse sérialisée complète, tandis que pathname expose son chemin. Pour HTTP(S), origin contient le schéma, l’hôte et, le cas échéant, le port, mais pas le chemin. La résolution par rapport à une base n’est pas une concaténation : le / final compte.
searchParams est un objet URLSearchParams lié à l’adresse : ses modifications mettent celle-ci à jour. Passe les valeurs sans les encoder au préalable ; les espaces sont sérialisés sous la forme +. Une analyse réussie ne garantit pas qu’une adresse est sûre — vérifie que protocol et origin sont autorisés.
Exemples
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Résultat
/app/items https://example.com/app/items?q=red+shoes
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.