Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

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_ERRORest levée.

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

Syntax

url = new URL(url, [base])

Parameters

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.

Example

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 Status Comment
URL
La définition de 'URL.URL()' dans cette spécification.
Standard évolutif initialisation.

Browser compatibility

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple Oui1226 Non Oui Oui
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple ? ? ? ? ? ? ?

See also

  • L'interface à laquelle il appartient : URL.

 

Étiquettes et contributeurs liés au document

Contributeurs à cette page : cdelamarre
Dernière mise à jour par : cdelamarre,