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 يشير إلى النجاح.

  • resultCode

    الرقم

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

الطُرق

resolve()

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

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

المعلمات

  • اسم المضيف

    سلسلة

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

  • callback

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

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

    (resolveInfo: ResolveCallbackResolveInfo) => void

المرتجعات

  • لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.