דף זה תורגם על ידי Cloud Translation API.

chrome.dns

תיאור

משתמשים ב-API chrome.dns לצורך פתרון DNS.

הרשאות

dns

זמינות

ערוץ פיתוח

כדי להשתמש ב-API הזה, צריך להצהיר על ההרשאה "dns" בmanifest.

{
  "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();

נקודת מפתח: אין לכלול את הסכימה או את הלוכסן הסוגר בשמו של המארח. לדוגמה, הערך https://example.com/ לא חוקי.

סוגים

ResolveCallbackResolveInfo

מאפיינים

כתובת

מחרוזת אופציונלי

מחרוזת שמייצגת את כתובת ה-IP המילולית. הפרמטר הזה מסופק רק אם resultCode מציין הצלחה.
resultCode

number

קוד התוצאה. אפס מציין הצלחה.

Methods

resolve()

Promise

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

פותר את שם המארח או כתובת ה-IP הנתונים.

פרמטרים

hostname

string

שם המארח שרוצים לפתור.
קריאה חוזרת (callback)

פונקציה אופציונלי

הפרמטר callback נראה כך:
```
(resolveInfo: ResolveCallbackResolveInfo) => void
```
- resolveInfo
  
  ResolveCallbackResolveInfo

החזרות

Promise<ResolveCallbackResolveInfo>

יש תמיכה ב-Promises ב-Manifest V3 ואילך, אבל פונקציות קריאה חוזרת (callbacks) ניתנות לצורך תאימות לאחור. אי אפשר להשתמש בשניהם באותה קריאה לפונקציה. הפתרון של ההבטחה יהיה באותו סוג שהוענק ל-callback.