browser.publicSuffix

תיאור

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

הרשאות

publicSuffix

זמינות

‫Chrome 153 ואילך

סוגים

DomainEncoding

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

ספירה

‫"punycode"

‫"display"

DomainOptions

מאפיינים

  • allowIPAddress

    ‫boolean אופציונלי

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

  • allowPlainSuffix

    ‫boolean אופציונלי

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

  • allowUnknownSuffix

    ‫boolean אופציונלי

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

  • קידוד

    ‫DomainEncoding אופציונלי

    הקידוד שבו יש להשתמש עבור הדומיין שמוחזר. ברירת המחדל היא 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

    מחרוזת

החזרות

  • בוליאני