chrome.publicSuffix

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.publicSuffix para consultar a lista de sufixos públicos (PSL, na sigla em inglês) do navegador.

Permissões

publicSuffix

Disponibilidade

Chrome 153 ou mais recente

Tipos

DomainEncoding

A codificação a ser usada para os domínios retornados.

Enumeração

"punycode"

"display"

DomainOptions

Propriedades

  • allowIPAddress

    booleano opcional

    Se os endereços IP podem ser retornados como domínios. O padrão é "falso". Observação: quando permitido, os endereços IP são retornados sem serem pesquisados na lista de sufixos públicos.

  • allowPlainSuffix

    booleano opcional

    Se os sufixos públicos conhecidos podem ser retornados como domínios. O padrão é "falso".

  • allowUnknownSuffix

    booleano opcional

    Se os TLDs desconhecidos devem ser considerados um sufixo público. Por exemplo, para nomes de host não públicos, como printer.internal-network. O padrão é "falso".

  • encoding

    DomainEncoding opcional

    A codificação a ser usada para o domínio retornado. O padrão é "punycode", mas transmita "display" se estiver mostrando o domínio ao usuário. Em geral, "exibir" usa Unicode, exceto em casos em que isso seria inseguro devido a "Unicode confusables".

Métodos

getDomain()

chrome.publicSuffix.getDomain(
  hostname: string,
  options?: DomainOptions,
)
: string | undefined

Recebe o domínio registrável para hostname, se houver.

Parâmetros

Retorna

  • string | undefined

getKnownSuffix()

chrome.publicSuffix.getKnownSuffix(
  hostname: string,
)
: string | undefined

Recebe o sufixo público conhecido para hostname, se houver.

Parâmetros

  • nome do host

    string

Retorna

  • string | undefined

isKnownSuffix()

chrome.publicSuffix.isKnownSuffix(
  hostname: string,
)
: boolean

Determina se hostname é um sufixo público conhecido.

Parâmetros

  • nome do host

    string

Retorna

  • booleano