URL()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.
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
USVStringrepré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
USVStringrepré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écifications
| Specification |
|---|
| URL # dom-url-url |
Compatibilité des navigateurs
Chargement…
Voir aussi
- L'interface à laquelle il appartient :
URL.