chrome.mdns

说明

使用 chrome.mdns API 通过 mDNS 发现服务。这包含 NSD 规范的部分功能：http://www.w3.org/TR/discovery-api/

权限

mdns

可用性

Chrome 43 及更高版本

类型

MDnsService

属性

  • ipAddress

    字符串

    mDNS 通告服务的 IP 地址。

  • serviceData

    字符串[]

    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

    函数（可选）

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    Chrome 96 及更高版本

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

事件

onServiceList

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

触发的事件，用于告知客户端当前一整套已知可用服务。客户端只需存储最近一次事件中的列表即可。扩展程序有兴趣发现的服务类型应使用“serviceType”键指定为事件过滤条件。如果未指定事件过滤条件，系统将不会启动任何发现监听器。

参数