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

    字符串

返回

  • 布尔值