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 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.