chrome.mdns

תיאור

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

הרשאות

mdns

זמינות

Chrome מגרסה 43 ואילך

סוגים

MDnsService

מאפיינים

  • ipAddress

    מחרוזת

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

  • serviceData

    string[]

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

  • serviceHostPort

    מחרוזת

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

  • serviceName

    מחרוזת

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

מאפיינים

MAX_SERVICE_INSTANCES_PER_EVENT

גרסה 44 ואילך של Chrome

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

ערך

2048

Methods

forceDiscovery()

Promise Chrome מגרסה 45 ואילך 
chrome.mdns.forceDiscovery(
  callback?: function,
)

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

פרמטרים

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

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

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

    () => void

החזרות

  • Promise<void>

    גרסה 96 ואילך של Chrome

    יש תמיכה ב-Promises רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

onServiceList

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

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

פרמטרים

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

    פונקציה

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

    (services: MDnsService[]) => void