chrome.mdns

תיאור

משתמשים ב-API‏ chrome.mdns כדי לגלות שירותים באמצעות mDNS. היא כוללת קבוצת משנה של התכונות של מפרט NSD: http://www.w3.org/TR/discovery-api/

הרשאות

mdns

זמינות

‫Chrome 43 ואילך

סוגים

MDnsService

מאפיינים

  • ipAddress

    מחרוזת

    כתובת ה-IP של שירות שפורסם ב-mDNS.

  • serviceData

    string[]

    מטא-נתונים של שירות שפורסם ב-mDNS.

  • serviceHostPort

    מחרוזת

    הצמד host:port של שירות שפורסם ב-mDNS.

  • serviceName

    מחרוזת

    שם השירות שמתפרסם ב-mDNS, ..

מאפיינים

MAX_SERVICE_INSTANCES_PER_EVENT

‫Chrome 44 ואילך

מספר מופעי השירות המקסימלי שייכללו באירועים מסוג onServiceList. אם יש מופעים נוספים, יכול להיות שהם יקוצרו מהאירוע onServiceList.

ערך

‫2048

Methods

forceDiscovery()

Promise Chrome 45+ 
chrome.mdns.forceDiscovery(
  callback?: function,
): Promise<void>

מבצע באופן מיידי שאילתת DNS מרובת שידור לכל סוגי השירותים. הפונקציה callback מופעלת באופן מיידי. בשלב מאוחר יותר, יישלחו שאילתות ויופעלו אירועים של שירותים.

פרמטרים

  • callback

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

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

אירועים

onServiceList

chrome.mdns.onServiceList.addListener(
  callback: function,
)

האירוע מופעל כדי לעדכן את הלקוחות לגבי כל השירותים הזמינים הידועים. הלקוחות צריכים לאחסן רק את הרשימה מהאירוע האחרון. סוג השירות שהתוסף מעוניין לגלות צריך להיות מוגדר כמסנן האירועים עם המפתח serviceType. אם לא מציינים מסנן אירועים, לא יופעלו פונקציות event listener לגילוי.

פרמטרים

  • callback

    פונקציה

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

    (services: MDnsService[]) => void