URL()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Compatibilidad con navegadores

Ver también

  • La interfaz a la que pertenece: URL.