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
});