URL

URL()

Crée et renvoie un objet URL faisant référence à l'URL indiquée via la chaîne de caractères passée en argument qui représente une URL absolue ou via les deux chaînes de caractères passées en arguments qui représentent respectivement une URL relative et une URL de base.

hash

Une chaîne de caractères contenant un '#' suivi de l'identifiant du fragment de l'URL.

host

Une chaîne de caractères contenant le domaine (c'est-à-dire le nom d'hôte), suivi de, si un port a été indiqué, de ':' puis du port de l'URL.

hostname

Une chaîne indiquant le domaine de l'URL.

href

Une chaîne de caractères qui renvoie tout l'URL.

origin Lecture seule

Renvoie une chaîne de caractères contenant l'origine de l'URL, c'est-à-dire la combinaison de son schéma, de son domaine et de son port.

password

Une chaîne de caractères contenant le mot de passe indiqué avant le nom de domaine.

pathname

Une chaîne de caractères contenant une barre oblique initiale '/' suivie du chemin de l'URL et qui n'inclut pas la chaîne de requête ou le fragment.

port

Une chaîne de caractères contenant le numéro de port de l'URL.

protocol

Une chaîne de caractères contenant le schéma du protocole de l'URL, incluant les deux-points ':' finaux.

search

Une chaîne de caractères indiquant la chaîne de paramètres de l'URL. Si des paramètres sont fournis, cette chaîne les contient tous et commence par un point d'interrogation ?.

searchParams Lecture seule

Un objet URLSearchParams qui peut être utilisé afin d'accéder aux paramètres individuels de la requête (qui sont également visibles depuis search).

username

Une chaîne de caractères contenant le nom d'utilisateur indiqué avant le nom de domaine.

toString()

Renvoie une chaîne de caractères contenant toute l'URL. Il s'agit d'un synonyme pour URL.href, bien que ce dernier ne puisse être utilisé pour modifier la valeur.

toJSON()

Renvoie une chaîne de caractères contenant tout l'URL. Elle fournit la même chaîne de caractères que la propriété href.

createObjectURL()

Renvoie une chaîne de caractères contenant une URL de blob unique, c'est-à-dire une URL dont le schéma est blob:, suivi d'une chaîne de caractères opaque identifiant de façon unique l'objet dans le navigateur.

revokeObjectURL()

Révoque un objet URL précédemment créé à l'aide de URL.createObjectURL().

Le constructeur prend un paramètre url, et un paramètre optionnel base utilisé si le paramètre url est une URL relative :

const url = new URL("../chats", "http://www.example.com/chiens");
console.log(url.hostname); // "www.example.com"
console.log(url.pathname); // "/chats"

Les propriétés de l'objet peuvent être utilisées pour construire l'URL :

url.hash = "spock";
console.log(url.href); // "http://www.example.com/chats#spock"

Les URL sont encodées selon les règles édictées par la RFC 3986. Ainsi, on aura :

url.pathname = "démonstration.html";
console.log(url.href); // "http://www.example.com/démonstration.html"

L'interface URLSearchParams peut être utilisée pour construire et manipuler le fragment de la requête.

Pour obtenir les paramètres de recherche de l'URL de la fenêtre courante, on pourra écrire :

// https://mon.site/?id=123
const parsedUrl = new URL(window.location.href);
console.log(parsedUrl.searchParams.get("id")); // "123"

La méthode toString() de URL renvoie la valeur de la propriété href. On peut donc utiliser le constructeur pour normaliser et encoder une URL directement.

const response = await fetch(
  new URL("http://www.example.com/démonstration.html"),
);

• Une prothèse d'émulation pour URL avec la bibliothèque tierce core-js
• L'API URL
• Qu'est-ce qu'une URL ?
• URLSearchParams.