chrome.publicSuffix

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

publicSuffix

مدى التوفّر

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

الأنواع

DomainEncoding

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

تعداد

"punycode"

"display"

DomainOptions

الخصائص

  • allowIPAddress

    boolean اختياري

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

  • allowPlainSuffix

    boolean اختياري

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

  • allowUnknownSuffix

    boolean اختياري

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

  • الترميز

    DomainEncoding اختياري

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

الطُرق

getDomain()

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

تعرض هذه الدالة النطاق القابل للتسجيل الخاص بـ hostname، إن وُجد.

المعلمات

  • اسم المضيف

    سلسلة

  • الخيارات

    DomainOptions اختياري

المرتجعات

  • string | undefined

getKnownSuffix()

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

تعرض هذه السمة اللاحقة العامة المعروفة لـ hostname، إن وجدت.

المعلمات

  • اسم المضيف

    سلسلة

المرتجعات

  • string | undefined

isKnownSuffix()

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

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

المعلمات

  • اسم المضيف

    سلسلة

المرتجعات

  • قيمة منطقية