URL()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Le constructeur URL() renvoie un nouvel objet URL représentant l'URL définie par les paramètres.

Si l'URL de base donnée ou l'URL résultante ne sont pas des URL valides, une DOMException de type SYNTAX_ERROR est levée.

Note: Cette fonctionnalité est disponible via les Web Workers.

Syntaxe

url = new URL(url, [base])

Paramètres

url: Un USVString représentant une URL absolue ou relative. Si l'URL est une URL relative, la base est obligatoire et sera utilisée comme URL de base. Si url est une URL absolue, une base donnée sera ignorée.
base Facultatif: Un USVString représentant l'URL de base à utiliser dans le cas où l'URL est une URL relative. Si non spécifié, il est par défaut à ''.

Note : Vous pouvez toujours utiliser un objet URL existant pour la base, qui se stringifie en attribut href de l'objet.

Exceptions

Exception	Explication
`TypeError`	url (dans le cas d'URL absolues) ou base + URL (dans le cas d'URL relatives) n'est pas une URL valide.

Exemple

var a = new URL("/", "https://developer.mozilla.org"); // Crée une URL pointant vers 'https://developer.mozilla.org/'
var b = new URL("https://developer.mozilla.org"); // Crée une URL pointant vers 'https://developer.mozilla.org/'
var c = new URL("en-US/docs", b); // Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs'
var d = new URL("/en-US/docs", b); // Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs'
var f = new URL("/en-US/docs", d); // Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs'
var g = new URL("/en-US/docs", "https://developer.mozilla.org/fr-FR/toto");
// Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs'
var h = new URL("/en-US/docs", a); // Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs'
var i = new URL("/en-US/docs", ""); // Déclenche une exception TypeError car '' n'est pas une URL valide
var j = new URL("/en-US/docs"); // Déclenche une exception TypeError car '/ fr-US / docs' n'est pas une URL valide
var k = new URL("http://www.example.com", "https://developers.mozilla.com");
// Crée une URL pointant vers 'http://www.example.com/'
var l = new URL("http://www.example.com", b); // Crée une URL pointant vers 'http://www.example.com/'

Spécifications

Specification
URL Standard # dom-url-url

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

L'interface à laquelle il appartient : URL.