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

傳回

• 承諾<void>

  Chrome 96 以上版本

  Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

事件

onServiceList

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

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

參數

• callback

  函式

  callback 參數如下：

  (services: MDnsService[]) => void

  • 服務

    MDnsService[]