browser.publicSuffix

说明

使用 chrome.publicSuffix API 查询浏览器的公共后缀列表 (PSL)。

权限

publicSuffix

可用性

Chrome 153 及更高版本

类型

DomainEncoding

用于返回的网域的编码。

枚举

“punycode”

“display”

DomainOptions

属性

  • allowIPAddress

    布尔值 (可选)

    是否可以将 IP 地址作为网域返回。默认值为 false。注意:如果允许,系统会返回 IP 地址,而不会在公共后缀列表中查找这些地址。

  • allowPlainSuffix

    布尔值 (可选)

    是否可以将已知的公共后缀作为网域返回。默认值为 false。

  • allowUnknownSuffix

    布尔值 (可选)

    是否应将未知 TLD 视为公共后缀。例如,对于非公共主机名(如 printer.internal-network)。默认值为 false。

  • encoding

    DomainEncoding (可选)

    用于返回的网域的编码。默认值为“punycode”,但如果向用户显示网域,则传递“display”。一般来说,“display”将使用 Unicode,但如果因“Unicode 混淆字符”而导致不安全,则除外。

方法

getDomain()

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

获取 hostname 的可注册网域(如果有)。

参数

返回

  • 字符串 | undefined

getKnownSuffix()

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

获取 hostname 的已知公共后缀(如果有)。

参数

  • hostname

    字符串

返回

  • 字符串 | undefined

isKnownSuffix()

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

确定 hostname 本身是否为已知的公共后缀。

参数

  • hostname

    字符串

返回

  • 布尔值