chrome.publicSuffix

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

הרשאות

publicSuffix

זמינות

‫Chrome 153 ואילך

סוגים

DomainEncoding

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

ספירה

‫punycode

‫'display'

DomainOptions

מאפיינים

  • allowIPAddress

    ‫boolean אופציונלי

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

  • allowPlainSuffix

    ‫boolean אופציונלי

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

  • allowUnknownSuffix

    ‫boolean אופציונלי

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

  • קידוד

    ‫DomainEncoding optional

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

Methods

getDomain()

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

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

פרמטרים

החזרות

  • מחרוזת | לא מוגדר

getKnownSuffix()

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

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

פרמטרים

  • hostname

    מחרוזת

החזרות

  • מחרוזת | לא מוגדר

isKnownSuffix()

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

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

פרמטרים

  • hostname

    מחרוזת

החזרות

  • בוליאני