URL()
El constructor URL() devuelve un objeto URL recién creado que representa la URL definida por los parámetros.
Si la URL base dada o la URL resultante no son URL válidas, se lanza un DOMException de tipo SYNTAX_ERROR.
Nota: Esta característica está disponible en Web Workers
Sintaxis
url = new URL(url, [base])
Parámetros
url-
Un
USVString(en-US) que representa una URL absoluta o relativa. Si url es una URL relativa, se requiere base, y se usará como URL base. Si url es una URL absoluta, se ignorará una base determinada. base{optional_inline}}-
Un
USVString(en-US) representa la URL base a usar en caso de que la URL sea una URL relativa. Si no se especifica, el valor predeterminado es''.
Excepciones
| Excepción | Explicación |
|---|---|
TypeError |
url (en el caso de URL absolutas) o base + url (en el caso de URL relativas) no es una URL válida. |
Ejemplos
js
// Urls base
var m = "https://developer.mozilla.org";
var a = new URL("/", m); // => 'https://developer.mozilla.org/'
var b = new URL(m); // => 'https://developer.mozilla.org/'
new URL("es/docs", b); // => 'https://developer.mozilla.org/es/docs'
var d = new URL("/es/docs", b); // => 'https://developer.mozilla.org/es/docs'
new URL("/es/docs", d); // => 'https://developer.mozilla.org/es/docs'
new URL("/es/docs", a); // => 'https://developer.mozilla.org/es/docs'
new URL("/es/docs", "https://developer.mozilla.org/fr-FR/toto");
// => 'https://developer.mozilla.org/es/docs'
new URL("/es/docs", ""); // Provoca una excepción TypeError ya que '' no es una URL válida
new URL("/es/docs"); // Provoca una excepción TypeError ya que '/es/docs' no es una URL válida
new URL("http://www.example.com"); // => 'http://www.example.com/'
new URL("http://www.example.com", b); // => 'http://www.example.com/'
new URL("//foo.com", "https://example.com"); // => 'https://foo.com' (ver URL relativas)
Especificaciones
| Specification |
|---|
| URL Standard # constructors |
Compatibilidad con navegadores
BCD tables only load in the browser
Ver también
- La interfaz a la que pertenece:
URL.