browser.publicSuffix

الوصف

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

الأذونات

publicSuffix

مدى التوفّر

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

الأنواع

DomainEncoding

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

Enum

"punycode"

"display"

DomainOptions

الخصائص

  • allowIPAddress

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

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

  • allowPlainSuffix

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

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

  • allowUnknownSuffix

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

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

  • الترميز

    DomainEncoding اختيارية

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

الطُرق

getDomain()

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

يتم الحصول على النطاق القابل للتسجيل لـ "hostname"، إن توفّر.

المعلمات

  • اسم المضيف

    سلسلة

  • الخيارات

    DomainOptions اختياري

المرتجعات

  • string | undefined

getKnownSuffix()

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

يعرض اللاحقة العامة المعروفة لـ hostname، إن توفّرت.

المعلمات

  • اسم المضيف

    سلسلة

المرتجعات

  • string | undefined

isKnownSuffix()

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

يحدّد ما إذا كان hostname لاحقة عامة معروفة.

المعلمات

  • اسم المضيف

    سلسلة

المرتجعات

  • قيمة منطقية