URL()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since abril de 2021.
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
USVStringque 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
USVStringrepresenta 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("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
Loading…
Ver también
- La interfaz a la que pertenece:
URL.