URL

URL()

Crea y devuelve un objeto URL que hace referencia a la URL especificada utilizando una cadena de URL absoluta o una cadena de URL relativa y una cadena de URL base.

hash

Una cadena que contiene un '#' seguido del identificador de fragmento de la URL.

host

Una cadena que contiene el dominio (que es el hostname) seguido de (si se especificó un puerto) un ':' y el puerto de la URL.

hostname

Una cadena que contiene el dominio de la URL.

href

Un stringifier que devuelve una cadena que contiene la URL completa.

origin Read only

Devuelve una cadena que contiene el origen de la URL, es decir, su esquema, su dominio y su puerto.

password

Una cadena que contiene la contraseña especificada antes del nombre de dominio.

pathname

Una cadena que contiene un '/' inicial seguido de la ruta de la URL, sin incluir la cadena de consulta o el fragmento.

port

Una cadena que contiene el número de puerto de la URL.

protocol

Una cadena que contiene el esquema de protocolo de la URL, incluido el ':' final.

search

Una cadena que indica la cadena de parámetros de la URL; si se proporciona algún parámetro, esta cadena los incluye a todos, comenzando con el carácter ? inicial.

searchParams Read only

Un objeto URLSearchParams que se puede usar para acceder a los parámetros de consulta individuales que se encuentran en la búsqueda.

username

Una cadena que contiene el nombre de usuario especificado antes del nombre de dominio.

canParse()

Devuelve un valor booleano que indica si una URL definida a partir de una cadena de URL y una cadena de URL base opcional es analizable y válida.

createObjectURL()

Devuelve una cadena que contiene una URL de un blob única, es decir, una URL con blob: como esquema, seguida de una cadena opaca que identifica de forma única el objeto en el navegador.

revokeObjectURL()

Revoca una URL de objeto creada previamente usando URL.createObjectURL().

toString()

Devuelve una cadena que contiene la URL completa. Es un sinónimo de URL.href, aunque no se puede usar para modificar el valor.

toJSON()

Devuelve una cadena que contiene la URL completa. Devuelve la misma cadena que la propiedad href.

El constructor toma un parámetro url y un parámetro base opcional para usar como base si el parámetro url es una URL relativa:

const url = new URL("../cats", "http://www.example.com/dogs");
console.log(url.hostname); // "www.example.com"
console.log(url.pathname); // "/cats"

El constructor generará una excepción si la URL no se puede analizar como una URL válida. Puede llamar al código anterior en un bloque try...catch o usar el método estático canParse() para comprobar primero que la URL es válida:

if (URL.canParse("../cats", "http://www.example.com/dogs")) {
  const url = new URL("../cats", "http://www.example.com/dogs");
  console.log(url.hostname); // "www.example.com"
  console.log(url.pathname); // "/cats"
} else {
  console.log("URL invalida"); //URL invalida
}

Las propiedades de URL se pueden configurar para construir la URL:

url.hash = "tabby";
console.log(url.href); // "http://www.example.com/cats#tabby"

Las URL se codifican de acuerdo con las reglas que se encuentran en el RFC 3986. Por ejemplo:

url.pathname = "démonstration.html";
console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html"

La interfaz URLSearchParams se puede utilizar para crear y manipular la cadena de consulta de URL.

Para obtener los parámetros de búsqueda de la URL de la ventana actual, puede hacer esto:

// https://some.site/?id=123
const parsedUrl = new URL(window.location.href);
console.log(parsedUrl.searchParams.get("id")); // "123"

El método toString() de URL solo devuelve el valor de la propiedad href, por lo que El constructor se puede usar para normalizar y codificar una URL directamente.

const response = await fetch(
  new URL("http://www.example.com/démonstration.html"),
);

• Polyfill de URL en core-js
• API de URL
• ¿Qué es una URL?
• Propiedad para obtener un objeto URL: URL.
• URLSearchParams.