chrome.dns

תיאור

יש להשתמש ב-API של chrome.dns לרזולוציית DNS.

הרשאות

dns

זמינות

ערוץ הפיתוח

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

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

הערה: ה-API הזה זמין רק בגרסת Chrome Dev. אין תוכניות צפויות להעביר את ה-API הזה מערוץ הפיתוח ליציב של Chrome.

Usage

הקוד הבא מבצע קריאה ל-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

  מספר

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

שיטות

resolve()

הבטחה

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

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

פרמטרים

• hostname

  מחרוזת

  שם המארח שיש לפענח.

• קריאה חוזרת (callback)

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

  הפרמטר callback נראה כך:

  (resolveInfo: ResolveCallbackResolveInfo)=>void

  • resolveInfo

    ResolveCallbackResolveInfo

החזרות

• Promise<ResolveCallbackResolveInfo>

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