说明
使用 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 本身是否为已知公共后缀。
参数
-
主机名
字符串
返回
-
布尔值