前言

在前端开发中，随着业务的不断扩展，数据传递也变得越来越复杂，需要处理的数据也越来越庞大。为此，我们需要使用各种工具来帮助我们更高效和便捷的进行开发。而其中，npm 作为 Node.js 的包管理工具，为开发者提供了便捷的依赖管理，让我们可以很轻易地使用各类开源资源。

@beaker/dat-ephemeral-ext-msg 就是一款非常优秀的 npm 包，在前端的数据传递方面，可以帮助我们更好地完成底层服务的构建。

一、@beaker/dat-ephemeral-ext-msg 简介

@beaker/dat-ephemeral-ext-msg 是基于信令技术的前端请求包，专门解决在 P2P 环境下，客户端之间直接传输分离的前端数据的问题。此 npm 包可以通过秘钥对承载的信息进行加密，保证数据的安全性。而且，该方式不需要中心化服务的接入和传递，而是通过 WebRTC 技术，使用户直接与对端建立连接，完成端到端的通信传输。

同时，该 npm 包还提供了一些按需的核心方法，在信令通道中，解决了客户端的数据交互、流量控制等问题，将操作权交给了开发人员，便于开发。以下是详细介绍。

@beaker/dat-ephemeral-ext-msg 使用方法

安装 @beaker/dat-ephemeral-ext-msg：

npm install @beaker/dat-ephemeral-ext-msg

引入模块:

import {EphemeralExtMsg} from '@beaker/dat-ephemeral-ext-msg'

实例化：

// 实例化信令秘钥，此处为例子，具体根据实际情况进行更换
const secretKey = 'my-secret-key'
const eem = new EphemeralExtMsg({
  secretKey,
  onRelayExtensionMessage: onExtensionMessage
})

通过信令方法发送和响应消息

// 主动发送消息
await eem.sendMessage(recevierPkb, messageData)

// 接收到消息后，通过“标准化”做出响应
async function onExtensionMessage (pkb, messageData) {
  console.log('Message from ' + pkb.peerId, messageData)
  await eem.sendResponse(pkb.peerId, pkhb, messageData)
}

内部事件

EphemeralExtMsg 支持以下两个内部事件。

onPeerOpen(pkb)：建立连接时触发的事件

onPeerClosed(pkb)：连接关闭时触发的事件

举例：

eem.on('peer-open', (pkb) => {
  console.log(`Peer ${pkb.peerId} connected`)
})

eem.on('peer-closed', (pkb) => {
  console.log(`Peer ${pkb.peerId} disconnected`)
})

控制流量（内部方法）

EphemeralExtMsg 内置了一种通过信令通道控制数据流量的方法，开发者可根据自身需求进行调整和配置。

以下是控制方法：

setSendingStreamWindowSize(windowSize): 设置发件人的流控窗口大小，即可以同时发送的数据包个数。

setReceivingStreamWindowSize(windowSize): 设置收件人的流控窗口大小，即可以同时接收的数据包个数。

setMaxChunkLength(maxChunkLength): 设置单个数据包发送的最大长度。

@beaker/dat-ephemeral-ext-msg 开发指南

本教程讲解了主要的 API 和事件。

开发者们可以通过以下资源学习更多：

官网

GitHub

示例代码

以下是根据实际情况，对 npm 包 @beaker/dat-ephemeral-ext-msg 的使用示例：

-- -------------------- ---- -------
------ ----------------- ---- -------------------------------

----- --------- - ---------------
----- ----------- - ----------------------------------
----- ------------- - ----------------------------------
----- ------------ - ----------------------------------
----- ---------- - -------------------------------
----- ------ - ------------------------------

--- ------------

-------- ------- ---- -------- ------ ----- -- ----------

----- -------- ------- -- -
  ----- ------ - ------------------------
  ----- --- - ----- -----------------------

  -- ------------------------------------- --------------- --
  ----- --- - --- -----------------
    ----------
    ------------------------ ------------------
  --

  ----------------------- ---- -------
  ----- --- - ----- ----------------
  -------------- -- ------- -----------

  -- -- ------------ ---------- -- ------
  ------------------- ---- -- -
    -- ----------- --- ------------ -
      ------------ - ---
    -
  --
-

----- -------- ------------------ ----- ------------ -
  ------------- ------- ---- -------------- ----------------
-

----- -------- ---- -- -
  ----- ------- - -------------------------
  ------------ ------- ---------- -- ------------------------
  ----- ----------------------------- --------
-

-------- --- --------- -
  ----- - - ----------------------------------- ---
  ----- - - ---------------------------
  ----------------
  ---------------------
-

总结

@beaker/dat-ephemeral-ext-msg 是一款非常实用的 npm 包，在前端的数据传递方面，可以帮助我们更好地完成底层服务的构建。同时，本教程详细地介绍了其使用方法和注意事项，对开发者们完成前端数据传输有深度和学习意义。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/87983

npm 包 @beaker/dat-ephemeral-ext-msg 使用教程

前言