Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
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 constructorURL() devuelve un objetoURL 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 unDOMException de tipoSYNTAX_ERROR.
Nota: Esta característica está disponible enWeb Workers.
Sintaxis
url = new URL(url, [base])
Parámetros
urlUn
USVStringque representa una URL absoluta o relativa. Siurl es una URL relativa, se requierebase, y se usará como URL base. Si url es una URL absoluta, se ignorará unabase 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) obase +url (en el caso de URL relativas) no es una URL válida. |
Ejemplos
// Urls basevar 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álidanew URL("/es/docs"); // Provoca una excepción TypeError ya que '/es/docs' no es una URL válidanew 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.