URL()

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.

Syntax

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 à ''.

Remarque : 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écification

Spécification	Statut	Commentaire
URL La définition de 'URL.URL()' dans cette spécification.	Standard évolutif	initialisation.

Compatibilité des navigateurs

Update compatibility data on GitHub

	Ordinateur						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Webview Android	Chrome pour Android	Firefox pour Android	Opera pour Android	Safari sur iOS	Samsung Internet
`URL()` constructor	Chrome Support complet 19	Edge Support complet 12	Firefox Support complet 26	IE Aucun support Non	Opera Support complet 15	Safari Support partiel 6 Notes Support partiel 6 Notes Notes In Safari 14 and earlier, calling the `URL` constructor with a base URL whose value is `undefined` causes Safari to throw a `TypeError`; see WebKit bug 216841.	WebView Android Support complet ≤37	Chrome Android Support complet 25	Firefox Android Support complet 26	Opera Android Support complet 14	Safari iOS Support partiel 6 Notes Support partiel 6 Notes Notes In Safari 14 and earlier, calling the `URL` constructor with a base URL whose value is `undefined` causes Safari to throw a `TypeError`; see WebKit bug 216841.	Samsung Internet Android Support complet 1.5

Légende

Support complet: Support complet
Support partiel: Support partiel
Aucun support: Aucun support
Voir les notes d'implémentation.: Voir les notes d'implémentation.

À voir également

L'interface à laquelle il appartient : URL.