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

    要用于返回的网域的编码。默认值为“punycode”,但如果向用户显示域名,则传递“display”。通常,“显示”会使用 Unicode,但如果由于“Unicode 混淆字符”而导致不安全,则不会使用 Unicode。

方法

getDomain()

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

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

参数

返回

  • 字符串 | 未定义

getKnownSuffix()

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

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

参数

  • 主机名

    字符串

返回

  • 字符串 | 未定义

isKnownSuffix()

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

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

参数

  • 主机名

    字符串

返回

  • 布尔值