browser.publicSuffix

الوصف

استخدِم واجهة برمجة التطبيقات chrome.publicSuffix للاستعلام عن "قائمة اللاحقات العلنية" (PSL) في المتصفّح.

الأذونات

publicSuffix

مدى التوفّر

الإصدار 153 من Chrome والإصدارات الأحدث

الأنواع

DomainEncoding

الترميز الذي سيتم استخدامه للنطاقات التي يتم عرضها.

تعداد

"punycode"

"display"

DomainOptions

الخصائص

  • allowIPAddress

    قيمة منطقية اختيارية

    ما إذا كان يمكن عرض عناوين IP كأسماء نطاقات القيمة التلقائية هي "خطأ". ملاحظة: عند السماح بذلك، يتم عرض عناوين IP بدون البحث عنها في "قائمة اللاحقات العلنية".

  • allowPlainSuffix

    قيمة منطقية اختيارية

    ما إذا كان يمكن عرض اللاحقات العلنية المعروفة كأسماء نطاقات القيمة التلقائية هي "خطأ".

  • allowUnknownSuffix

    قيمة منطقية اختيارية

    ما إذا كان يجب اعتبار نطاقات المستوى الأعلى غير المعروفة لاحقة علنية على سبيل المثال، بالنسبة إلى أسماء المضيفين غير العلنية، مثل printer.internal-network القيمة التلقائية هي "خطأ".

  • encoding

    DomainEncoding اختيارية

    الترميز الذي سيتم استخدامه لاسم النطاق الذي يتم عرضه القيمة التلقائية هي "punycode"، ولكن عليك تمرير "display" إذا كنت تعرض اسم النطاق للمستخدم. بشكل عام، سيتم استخدام Unicode في "display"، باستثناء الحالات التي يكون فيها ذلك غير آمن بسبب "أحرف Unicode المتشابهة".

الطُرق

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

    سلسلة

المرتجعات

  • قيمة منطقية