browser.publicSuffix

شرح

از میانای برنامه‌سازی کاربردی chrome.publicSuffix برای پُرسمان «فهرست پسوند عمومی» (PSL) مرورگر استفاده کنید.

اجازه‌ها

publicSuffix

دردسترس بودن

Chrome نسخه ۱۵۳ و بالاتر

انواع

DomainEncoding

کدگذاری‌ای که برای دامنه‌های برگردانده‌شده استفاده می‌شود.

شمارشی

«punycode»

«نمایش»

DomainOptions

مشخصات

  • allowIPAddress

    بولی اختیاری

    اینکه نشانی‌های IP ممکن است به‌عنوان دامنه برگردانده شوند یا نه. پیش‌فرض: نادرست. توجه: وقتی مجاز باشد، نشانی‌های IP بدون جستجو در «فهرست پسوند عمومی» برگردانده می‌شوند.

  • allowPlainSuffix

    بولی اختیاری

    اینکه آیا پسوندهای عمومی شناخته‌شده می‌توانند به‌عنوان دامنه برگردانده شوند یا نه. پیش‌فرض: نادرست.

  • allowUnknownSuffix

    بولی اختیاری

    آیا دامنه‌های سطح بالای ناشناخته باید به‌عنوان پسوند عمومی درنظر گرفته شوند. برای مثال، برای نام‌های میزبان غیرعمومی مثل printer.internal-network. پیش‌فرض: نادرست.

  • کدبندی

    DomainEncoding اختیاری

    کدگذاری‌ای که برای دامنه برگردانده‌شده استفاده می‌شود. به‌طور پیش‌فرض روی «punycode» تنظیم شده است، اما اگر دامنه به کاربر نمایش داده می‌شود، «display» را ارسال کنید. به‌طور کلی، «نمایش» از یونی‌کد استفاده می‌کند، به‌جز در مواردی که به‌دلیل «یونی‌کدهای گمراه‌کننده» ناامن باشد.

روش‌ها

getDomain()

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

دامنه قابل‌ثبت را برای hostname (درصورت وجود) دریافت می‌کند.

پارامترها

  • نام میزبان

    رشته

  • گزینه‌ها

    DomainOptions اختیاری

بازگشتی‌ها

  • رشته | تعریف‌نشده

getKnownSuffix()

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

پسوند عمومی شناخته‌شده برای hostname را درصورت وجود دریافت می‌کند.

پارامترها

  • نام میزبان

    رشته

بازگشتی‌ها

  • رشته | تعریف‌نشده

isKnownSuffix()

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

تعیین می‌کند که آیا hostname خودش پسوند عمومی شناخته‌شده‌ای است یا نه.

پارامترها

  • نام میزبان

    رشته

بازگشتی‌ها

  • بولی