chrome.dns

الوصف

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

الأذونات

dns

مدى توفّر الخدمة

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

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

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

الاستخدام

يستدعي الرمز التالي resolve() لاسترداد عنوان IP لـ example.com.

service-work.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 المحدّد.

المَعلمات

  • hostname

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (resolveInfo: ResolveCallbackResolveInfo)=>void

المرتجعات

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