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

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.

Sources