Node.js dgram.Socket.bind(options[, callback])用法及代码示例

socket.bind(options[, callback])

参数

• options <Object>必需的。支持以下属性：
  • port <integer>
  • address <string>
  • exclusive <boolean>
  • fd <integer>
• callback <Function>

对于 UDP 套接字，导致 dgram.Socket 侦听命名 port 和可选 address 上的数据报消息，这些消息作为第一个参数传递的 options 对象的属性传递。如果 port 未指定或为 0 ，则操作系统将尝试绑定到随机端口。如果未指定address，操作系统将尝试侦听所有地址。绑定完成后，会发出 'listening' 事件并调用可选的 callback 函数。

options 对象可能包含 fd 属性。当设置了大于 0 的 fd 时，它将使用给定的文件说明符环绕现有套接字。在这种情况下，port 和address 的属性将被忽略。

指定 'listening' 事件侦听器并将 callback 传递给 socket.bind() 方法没有害处，但不是很有用。

options 对象可能包含一个附加的exclusive 属性，该属性在将dgram.Socket 对象与 cluster 模块一起使用时使用。当 exclusive 设置为 false(默认值)时，集群工作人员将使用相同的底层套接字句柄，从而允许共享连接处理职责。但是，当 exclusive 为 true 时，句柄未共享，并且尝试共享端口会导致错误。

绑定的数据报套接字保持 Node.js 进程运行以接收数据报消息。

如果绑定失败，则会生成 'error' 事件。在极少数情况下(例如，尝试与关闭的套接字绑定)，可能会抛出 Error 。

下面显示了一个在独占端口上侦听的示例套接字。

socket.bind({
  address: 'localhost',
  port: 8000,
  exclusive: true
});