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 通告服務的 host:port 組合。

  • 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

傳回

  • 承諾<void>

    Chrome 96 以上版本

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

活動

onServiceList

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

會觸發事件，以便通知客戶目前完整的已知可用服務集。客戶只需儲存最近事件的清單。擴充功能有興趣探索的服務類型應指定為事件篩選器，並加上「serviceType」鍵。如未指定事件篩選器，則不會啟動任何探索事件監聽器。

參數