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

Nota: Aún puede usar un objeto URL existente para la base, que se enchufa al atributo href del objeto.

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
# dom-url-url

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también

  • La interfaz a la que pertenece: URL.