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
-
- 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
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
BCD tables only load in the browser
À voir également
- L'interface à laquelle il appartient :
URL
.