chrome.dns

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات 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,
): Promise<ResolveCallbackResolveInfo>

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

المعلمات

  • اسم المضيف

    سلسلة

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

  • callback

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

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

    (resolveInfo: ResolveCallbackResolveInfo) => void

المرتجعات

  • وعد يتم تنفيذه عند اكتمال عملية تحديد الدقة.

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