chrome.mdns

說明

使用 chrome.mdns API 透過 mDNS 探索服務。這項 API 包含 NSD 規格中的部分功能：http://www.w3.org/TR/discovery-api/

權限

mdns

可用性

Chrome 43 以上版本

類型

MDnsService

屬性

  • ipAddress

    字串

    mDNS 廣告服務的 IP 位址。

  • serviceData

    string[]

    mDNS 廣告服務的中繼資料。

  • serviceHostPort

    字串

    mDNS 廣告服務的主機：通訊埠組合。

  • serviceName

    字串

    mDNS 宣傳服務的服務名稱。

屬性

MAX_SERVICE_INSTANCES_PER_EVENT

Chrome 44 以上版本

在 onServiceList 事件中納入的服務例項數量上限。如果有更多例項可用，則可能會從 onServiceList 事件中截斷。

值

2048

方法

forceDiscovery()

Promise Chrome 45 以上版本 
chrome.mdns.forceDiscovery(
  callback?: function,
)

立即針對所有服務類型發出多播 DNS 查詢。callback 會立即叫用。稍後，系統會傳送查詢，並觸發任何服務事件。

參數

  • 回呼

    函式 選填

    callback 參數如下所示： 

    () => void

傳回

  • Promise<void>

    Chrome 96 以上版本

    承諾僅支援資訊清單 V3 以上版本，其他平台則需要使用回呼。

活動

onServiceList

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

觸發事件，用於通知用戶端目前已知的完整可用服務。用戶端只需儲存最近事件的清單。擴充功能要探索的服務類型應指定為事件篩選器，並使用「serviceType」鍵。如果未指定事件篩選器，系統就不會啟動任何探索事件監聽器。

參數