refresh date: 2026-09-25 robots: noindex
شرح
از میانای برنامه‌سازی کاربردی chrome.publicSuffix برای پُرسمان «فهرست پسوند عمومی» (PSL) مرورگر استفاده کنید.
اجازه‌ها
publicSuffixدردسترس بودن
انواع
DomainEncoding
کدگذاری‌ای که برای دامنه‌های برگردانده‌شده استفاده می‌شود.
شمارشی
«punycode»
«نمایش»
DomainOptions
مشخصات
-
allowIPAddress
بولی اختیاری
اینکه نشانی‌های IP ممکن است به‌عنوان دامنه برگردانده شوند یا نه. پیش‌فرض: نادرست. توجه: وقتی مجاز باشد، نشانی‌های IP بدون جستجو در «فهرست پسوند عمومی» برگردانده می‌شوند.
-
allowPlainSuffix
بولی اختیاری
اینکه آیا پسوندهای عمومی شناخته‌شده می‌توانند به‌عنوان دامنه برگردانده شوند یا نه. پیش‌فرض: نادرست.
-
allowUnknownSuffix
بولی اختیاری
آیا دامنه‌های سطح بالای ناشناخته باید به‌عنوان پسوند عمومی درنظر گرفته شوند. برای مثال، برای نام‌های میزبان غیرعمومی مثل
printer.internal-network. پیش‌فرض: نادرست. -
کدبندی
DomainEncoding اختیاری
کدگذاری‌ای که برای دامنه برگردانده‌شده استفاده می‌شود. به‌طور پیش‌فرض روی «punycode» تنظیم شده است، اما اگر دامنه به کاربر نمایش داده می‌شود، «display» را ارسال کنید. به‌طور کلی، «نمایش» از یونی‌کد استفاده می‌کند، به‌جز در مواردی که به‌دلیل «یونی‌کدهای گمراه‌کننده» ناامن باشد.
روش‌ها
getDomain()
chrome.publicSuffix.getDomain(
hostname: string,
options?: DomainOptions,
): string | undefined
دامنه قابل‌ثبت را برای hostname (درصورت وجود) دریافت می‌کند.
پارامترها
-
نام میزبان
رشته
-
گزینه‌ها
DomainOptions اختیاری
بازگشتی‌ها
-
رشته | تعریف‌نشده
getKnownSuffix()
chrome.publicSuffix.getKnownSuffix(
hostname: string,
): string | undefined
پسوند عمومی شناخته‌شده برای hostname را درصورت وجود دریافت می‌کند.
پارامترها
-
نام میزبان
رشته
بازگشتی‌ها
-
رشته | تعریف‌نشده
isKnownSuffix()
chrome.publicSuffix.isKnownSuffix(
hostname: string,
): boolean
تعیین می‌کند که آیا hostname خودش پسوند عمومی شناخته‌شده‌ای است یا نه.
پارامترها
-
نام میزبان
رشته
بازگشتی‌ها
-
بولی