在前端开发中，网络通信是非常重要的一个环节。而在网络通信中，UDP 协议是一种高效而且实时性非常好的协议。@cgjs/dgram 是 npm 上一个比较好用的 UDP 封装库，可以帮助前端开发者轻松地实现 UDP 协议的通信。本文将为大家介绍 npm 包 @cgjs/dgram 的使用方法。
安装
首先，我们需要安装 @cgjs/dgram 这个 npm 包。在命令行中输入下面的指令即可完成安装。
npm install @cgjs/dgram --save
基本使用
在使用 @cgjs/dgram 进行 UDP 通信前，我们需要创建一个 udpsender 和一个 udpreceiver。其中，udpsender 用于向目标地址发送数据，udpreceiver 则用于接收数据。
-- -------------------- ---- ------- ----- ----- - ----------------------- ----- ------ - --------------------------- -- --------- ----- ---- - ------ -------- ----- ------- - ------------------ ----- ---- - ----- ----- ---- - ------------ -------------------- -- --------------- ----- ----- ----- ------ -- - -- ----- ----- ---- ---------------- ------- ---- -- --------------- ---- -------- -------- --- -- --------- ----- ------ - --------------------------- -------------------- --------- ------- -- - --------------------- ------- ---- --------------------------------- ------------- --- ----------------- ------ ---------------- ------ --------- -- ------------------
在这个例子里，我们首先创建了一个 udp4 类型的 socket。然后，我们用 send 方法向目标地址发送了一个字符串。接着，我们用 on 方法注册了一个 message 事件，同时使用 bind 方法开启了一个 UDP 服务器。当 UDP 服务器接收到消息时，就会触发 message 事件，我们在这里输出了对应的消息和发送方的地址和端口号。
详细说明
创建 socket
在使用 dgram 的时候，我们需要首先创建一个 socket。
const dgram = require('@cgjs/dgram');
const socket = dgram.createSocket(type[, callback])这里的 type 参数可以是 'udp4' 或者 'udp6'，分别表示 IPv4 和 IPv6 版本的 UDP 协议。
回调函数 callback 是一个可选参数，表示 socket 创建完成后的回调函数。
发送数据
通过 dgram 的 send 方法，我们可以将数据发送到指定的地址。
socket.send(buf[, offset[, length[, port[, address[, callback]]]]])
其中，buf 表示要发送的数据，必须是 Buffer 对象；offset 和 length 分别表示 buf 的起始位置和长度，默认是从 buf 的头部开始发送；port 和 address 分别表示目标地址的端口号和 IP 地址；callback 则是发送数据之后的回调函数。
监听数据
通过 dgram 的 on 方法，我们可以监听 socket 的各种事件，包括 message 事件（接收到消息）和 error 事件（错误处理）等。
socket.on(event, callback)
其中，event 表示要监听的事件名称，callback 则是事件触发之后的回调函数。
关闭 socket
一旦使用完 socket，我们需要通过 close 方法将其关闭。
socket.close([callback])
示例代码
下面是一个完整的示例代码，演示了如何使用 @cgjs/dgram 实现 UDP 通信。
-- -------------------- ---- -------
----- ----- - -----------------------
----- ---- - -----
----- ---- - ------------
-- -- ---------
----- ------ - ---------------------------
-- ---------
----- ---- - ------ --------
----- ------- - ------------------
-------------------- -- --------------- ----- ----- ----- ------ -- -
-- ----- ----- ----
---------------- ------- ---- -- --------------- ---- -------- --------
---
-- -- -----------
----- ------ - ---------------------------
-------------------- --------- ------- -- -
--------------------- ------- ---- --------------------------------- -------------
---
----------------- ------
---------------- ------ --------- -- ------------------
-- -- ------
-------------------- -- -- -
--------------- -- -
------------------- ---------
---------------
---
---总结
本文详细地介绍了 @cgjs/dgram 这个 npm 包的使用方法。通过这个封装库，我们可以方便地实现 UDP 通信。最后，还提供了示例代码，供读者参考。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005668181e8991b448e29ed