chrome.mdns

說明

使用 chrome.mdns API 透過 mDNS 探索服務。這項功能包含 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,
): Promise<void>

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

參數

  • callback

    函式 選用

    callback 參數如下： 

    () => void

傳回

  • Promise<void>

    Chrome 96 以上版本

    只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。

事件

onServiceList

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

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

參數