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」。一般來說，「顯示」會使用 Unicode，但如果因 Unicode 混淆字元而導致不安全，則不在此限。

方法

getDomain()

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

取得 hostname 的可註冊網域 (如果有的話)。

參數

• 主機名稱

  字串

• 選項

  DomainOptions 選用

傳回

• string | undefined

getKnownSuffix()

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

取得 hostname 的已知公開後置字串 (如有)。

參數

• 主機名稱

  字串

傳回

• string | undefined

isKnownSuffix()

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

判斷 hostname 本身是否為已知的公開後置字串。

參數

• 主機名稱

  字串

傳回

• 布林值