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

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

Exceptions

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

Browser compatibility

See also

• L'interface à laquelle il appartient : URL.