chrome.publicSuffix

refresh date: 2026-09-25 robots: noindex

说明

使用 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”。一般来说，“显示”会使用 Unicode，但如果因 “Unicode 混淆字符”而导致不安全，则不会使用 Unicode。

方法

getDomain()

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

获取 hostname 的可注册网域（如果有）。

参数

返回

  • 字符串 | 未定义

getKnownSuffix()

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

获取 hostname 的已知公共后缀（如果有）。

参数

  • 主机名

    字符串

返回

  • 字符串 | 未定义

isKnownSuffix()

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

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

参数

  • 主机名

    字符串

返回

  • 布尔值