chrome.dns

الوصف

استخدِم واجهة برمجة التطبيقات chrome.dns لحلّ عناوين نظام أسماء النطاقات.

الأذونات

dns

مدى التوفّر

قناة المطوّرين

لاستخدام واجهة برمجة التطبيقات هذه، يجب الإفصاح عن الإذن "dns" في manifest.

{
  "name": "My extension",
  ...
  "permissions": [
    "dns"
  ],
  ...
}

الاستخدام

تستدعي التعليمة البرمجية التالية resolve() لاسترداد عنوان IP الخاص بـ example.com.

service-worker.js:

const resolveDNS = async () => {
    let record = await chrome.dns.resolve('example.com');
    console.log(record.address); // "192.0.2.172"
};

resolveDNS();

الأنواع

ResolveCallbackResolveInfo

أماكن إقامة

  • معالجة

    سلسلة اختيارية

    سلسلة تمثّل عنوان IP المطلق لا يتمّ تقديمه إلّا إذا كان resultCode يشير إلى نجاح العملية.

  • resultCode

    الرقم

    رمز النتيجة. يشير الصفر إلى النجاح.

الطُرق

resolve()

الوعد 
chrome.dns.resolve(
  hostname: string,
  callback?: function,
)

تُحلّ اسم المضيف أو عنوان IP المحدد.

المعلمات

  • اسم المضيف

    سلسلة

    اسم المضيف المطلوب حلّه.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (resolveInfo: ResolveCallbackResolveInfo) => void

المرتجعات

  • تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير طلبات الاستدعاء لأجل التوافق مع الإصدارات القديمة. ولا يمكنك استخدام كليهما في طلب الدالة نفسه. يتم حلّ الوعد بالنوع نفسه الذي يتم تمريره إلى دالة الاستدعاء.