browser.publicSuffix

תיאור

משתמשים ב-API של chrome.publicSuffix כדי לשלוח שאילתה לרשימת הסיומות הציבוריות (PSL) של הדפדפן.

הרשאות

publicSuffix

זמינות

‫Chrome מגרסה 153 ואילך

סוגים

DomainEncoding

הקידוד שבו צריך להשתמש בדומיינים שמוחזרים.

טיפוסים בני מנייה (enum)

"punycode"

"display"

DomainOptions

מאפיינים

  • allowIPAddress

    בוליאני אופציונלי

    אם כתובות IP יכולות להיות מוחזרות כדומיינים. ברירת המחדל היא False. הערה: כשהאפשרות מופעלת, כתובות IP מוחזרות בלי חיפוש ברשימת הסיומות הציבוריות.

  • allowPlainSuffix

    בוליאני אופציונלי

    אם סיומות ציבוריות ידועות יכולות להיות מוחזרות כדומיינים. ברירת המחדל היא False.

  • allowUnknownSuffix

    בוליאני אופציונלי

    האם להתייחס לדומיינים לא מוכרים ברמה העליונה (TLD) כסיומת ציבורית. לדוגמה, לשמות מארחים לא ציבוריים כמו printer.internal-network. ברירת המחדל היא False.

  • קידוד

    ‫DomainEncoding אופציונלי

    הקידוד שבו צריך להשתמש בדומיין שמוחזר. ברירת המחדל היא "punycode", אבל צריך להעביר את הערך "display" אם הדומיין מוצג למשתמש. באופן כללי, "תצוגה" תשתמש ב-Unicode, למעט במקרים שבהם זה לא יהיה בטוח בגלל "תווים מבלבלים ב-Unicode".

Methods

getDomain()

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

הפונקציה מחזירה את הדומיין שניתן לרשום עבור hostname, אם יש כזה.

פרמטרים

החזרות

  • string | undefined

getKnownSuffix()

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

הפונקציה מחזירה את הסיומת הציבורית הידועה של hostname, אם יש כזו.

פרמטרים

  • hostname

    מחרוזת

החזרות

  • string | undefined

isKnownSuffix()

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

הפונקציה בודקת אם hostname הוא בעצמו סיומת ציבורית מוכרת.

פרמטרים

  • hostname

    מחרוזת

החזרות

  • בוליאני