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()

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 本身是否為已知的公開後置字串。

參數

  • 主機名稱

    字串

傳回

  • 布林值