URL

URL() (en-US)

Cria e retorna o objeto URL referenciando a URL especificada utilizando uma sring URL absolute, ou uma string URL relativa e uma string URL base.

hash

Uma USVString (en-US) contendo o '#' seguido pelo fragmento identificador da URL.

host

Uma USVString (en-US) contendo o domínio (that is the hostname) seguido por (se a porta foi especificada) um ':' e a port da URL.

hostname

Uma USVString (en-US) contendo o domínio da URL.

href

Uma função stringifier (en-US) que retorna uma USVString (en-US) com toda a URL.

origin Somente leitura

Retorna uma USVString (en-US) contendo a origem da URL, este é seu esquema, domínio e sua porta.

password

Uma USVString (en-US) com a senha especificada antes do nome do domínio.

pathname

Uma USVString (en-US) contendo a inicial '/' seguido pelo caminho da URL, não inclui a query string ou fragmento.

port

Uma USVString (en-US) contendo o número da porta da URL.

protocol

Uma USVString (en-US) contendo o esquema de protocolo da URL, incluindo o final ':'.

search

Uma USVString (en-US) indicando a string de parâmetros de URL's; Se algum parâmetro é disponibilizado, esta string inclui todos eles começando pelo caracter ?.

searchParams Somente leitura

Um objeto URLSearchParams que pode ser utilizado para acessar individualmente os parâmetros encontrados em search.

username

Uma USVString (en-US) contendo o nome de usuário especificado antes do nome do domínio.

toString()

Retorna uma USVString (en-US) com toda a URL. Isto é um sinônimo para URL.href, embora não pode ser usado para modificar o valor.

toJSON()

Retorna uma USVString (en-US) com toda a URL. Ela retorna a mesma string da propriedade href.

createObjectURL()

Retorna um DOMString contendo uma única blob URL, isto é a URL com blob: com seu esquema, seguido de uma string com identificador único do objeto no navegador.

revokeObjectURL()

Anula uma URL criada anteriormente utilizando o URL.createObjectURL().

O construtor recebe o parâmetro url, e o parâmetro opcional base para usar como base do parâmetro url é uma URL relativa:

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

Propriedades da URL podem ser definidas para construir a URL:

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

As Urls são codificadas de acordo com as regras encontradas em RFC 3986. Para instância:

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

A interface URLSearchParams é usada pra criar e manipular a query string da URL.

Para obter os parâmetros da URL atual, você pode utilizar isso:

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

O método toString() de URL apenas retorna o valor da propriedade href, para que o construtor possa ser usado pra normalizar e codificar diretamente a URL.

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

• Polyfill de URL em core-js
• URL API (en-US)
• O que é uma URL (en-US)
• A propriedade contem uma URL objeto: URL.
• URLSearchParams.