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,
): Promise<void>

立即针对所有服务类型发出多播 DNS 查询。callback 会立即调用。稍后，系统会发送查询，并触发所有服务事件。

参数

  • callback

    函数可选

    callback 参数如下所示： 

    () => void

返回

  • 承诺<void>

    Chrome 96 及更高版本

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

事件

onServiceList

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

触发事件，以向客户端告知当前完整的已知可用服务集。客户端只需存储最近一次事件中的列表。扩展程序想要发现的服务类型应指定为事件过滤器，并使用“serviceType”键。如果不指定事件过滤条件，则不会启动任何发现监听器。

参数