chrome.dns

الوصف

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

الأذونات

dns

مدى التوفّر

قناة مطوري البرامج

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

{
  "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

    الرقم

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

الطُرق

resolve()

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

يحلل اسم المضيف أو عنوان IP المعين.

المعلمات

  • اسم المضيف

    سلسلة

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

  • رد الاتصال

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

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

    (resolveInfo: ResolveCallbackResolveInfo) => void

المرتجعات

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