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
// 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('en-US/docs', b); // => 'https://developer.mozilla.org/en-US/docs'
var d = new URL('/en-US/docs', b); // => 'https://developer.mozilla.org/en-US/docs'
new URL('/en-US/docs', d); // => 'https://developer.mozilla.org/en-US/docs'
new URL('/en-US/docs', a); // => 'https://developer.mozilla.org/en-US/docs'
new URL('/en-US/docs', "https://developer.mozilla.org/fr-FR/toto");
// => 'https://developer.mozilla.org/en-US/docs'
new URL('/en-US/docs', ''); // Provoca una excepción TypeError ya que '' no es una URL válida
new URL('/en-US/docs'); // Provoca una excepción TypeError ya que '/en-US/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
.