A interfaceURL é usada para analisar, construir, normalizar e codificarURLs. Ela trabalha com a disponibilização de propriedades para facilitar a leitura e modificar componentes da URL.

Normalmente você cria um novo objetoURL especificando a URL como string quando seu construtor é chamado, ou provendo uma URL relativa e URL base. Você pode facilmente ler e analisar os compoentes de uma URL ou fazer alterações na URL.

Se o seu navegador não tem suporte ao construtorURL(), você pode acessar o objeto URL utilizando a interfaceWindow propriedadeURL. Certifique-se de verificar se algum de seus navegadores precisa deste prefixo.

Construtor

URL()

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

Propriedades

hash

UmaUSVString contendo o'#' seguido pelo fragmento identificador da URL.

host

UmaUSVString contendo o domínio (that is thehostname) seguido por (se a porta foi especificada) um':' e aport da URL.

hostname

UmaUSVString contendo o domínio da URL.

href

Uma funçãostringifier que retorna umaUSVString com toda a URL.

originSomente leitura

Retorna umaUSVString contendo a origem da URL, este é seu esquema, domínio e sua porta.

password

UmaUSVString com a senha especificada antes do nome do domínio.

pathname

UmaUSVString contendo a inicial'/' seguido pelo caminho da URL, não inclui a query string ou fragmento.

port

UmaUSVString contendo o número da porta da URL.

protocol

UmaUSVString contendo o esquema de protocolo da URL, incluindo o final':'.

search

UmaUSVString indicando a string de parâmetros de URL's; Se algum parâmetro é disponibilizado, esta string inclui todos eles começando pelo caracter?.

searchParamsSomente leitura

Um objetoURLSearchParams que pode ser utilizado para acessar individualmente os parâmetros encontrados emsearch.

username

UmaUSVString contendo o nome de usuário especificado antes do nome do domínio.

Métodos

toString()

Retorna umaUSVString com toda a URL. Isto é um sinônimo paraURL.href, embora não pode ser usado para modificar o valor.

toJSON()

Retorna umaUSVString com toda a URL. Ela retorna a mesma string da propriedadehref.

Métodos estáticos

createObjectURL()

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

revokeObjectURL()

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

Notas de uso

O construtor recebe o parâmetrourl, e o parâmetro opcionalbase para usar como base do parâmetrourl é 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 emRFC 3986. Para instância:

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

A interfaceURLSearchParams é 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=123const parsedUrl = new URL(window.location.href);console.log(parsedUrl.searchParams.get("id")); // "123"

O métodotoString() deURL apenas retorna o valor da propriedadehref, 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"),);

Especificações

Compatibilidade de browser

Veja também

• Polyfill deURL emcore-js
• URL API
• O que é uma URL
• A propriedade contem umaURL objeto:URL.
• URLSearchParams.