# @discordjs/uws 中文文档

规范地址：https://npmcn.com/package/%40discordjs/uws/

版本：11\.149\.1
npm 元数据更新时间：2022-07-17T22:06:11.873Z
中文译文更新时间：2026-11-12T12:26:01.891Z
软件包许可：Zlib

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40discordjs/uws
原文对照：https://npmcn.com/package/%40discordjs/uws/?lang=original
项目主页：https://github.com/discordjs/uws#readme
源码仓库：https://github.com/discordjs/uws

弃用说明：Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：15.8 MB，51 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=6\.0\.0
- 运行依赖：0 个
- 首次发布：2018-08-22T16:15:46.234Z
- 最新版本发布：2018-10-25T00:58:20.364Z
- 近 30 天下载量：3185（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

微小的 WebSockets

## 安装

```sh
npm install @discordjs/uws
```

也可以使用：`pnpm add @discordjs/uws`、`yarn add @discordjs/uws`、`bun add @discordjs/uws`

## README

# 以相冲突为条件的 uws 叉

### 此分叉仅供内部使用 .

### 我们将不支持任何在我们主要项目之外依赖或使用它的人.

* * *

* * *

* * *

* * *

* * *

* * *

* * *

* * *

* * *

* * *

* * *

* * *

* * *

# 原读

# UWS 系统 _没有_ 电子法治

`uws` 是替换模块 `ws` 允许,但不能保证(当与Socket配对时,肯定不会). IO),显著性能和内存使用改进. 这个模块是特别的 _仅限_ 与 Node.js 兼容并安装 _仅限_ 像这样:

-   用户 _能够_ 使用节点-吉普并 _能够_ 安装时重新编译, 但确实 _没有_ 要求这样做.
-   npm 安装从未失败, 但是 `require('uws')` 如果以下所有点都成立, 则会投出 :
    -   在安装时没有可用的 C++11 编译器 .
    -   你的系统不是官方的 **第1级** 节点.js站台.

## 记住

你不能只解决问题的一部分 来修复一个堵塞的系统 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}可以这样 _戏剧性_ 如果整个输油管运转良好,效果会很好 袜子。 iO, SocketCluster 和其他这种质量的bloat 意志 **没有** 给您带来预期的结果 因为这些项目已经,从一开始, **为:** 瓶颈.

[更多关于其他可怕的节点项目的信息](https://github.com/alexhultman/The-Node.js-performance-palette)

## 使用量

`uws` 尝试模仿 `ws` 尽可能的紧密,同时不牺牲太多的表演。 大多数情况下你只是交换 `require('ws')` 与 `require('uws')`数字 :

```javascript
var WebSocketServer = require('uws').Server;
var wss = new WebSocketServer({ port: 3000 });

function onMessage(message) {
    console.log('received: ' + message);
}

wss.on('connection', function(ws) {
    ws.on('message', onMessage);
    ws.send('something');
});
```

##### 偏离ws

有点不相容 `ws` 我们的目标是达到90%的兼容性

-   二进制数据作为零副本通过 `ArrayBuffer`。这意味着你需要复制它 以保持它通过召回。 这也意味着你需要转换它与 `Buffer.from(message)` 如果你期望一个 `Node.js Buffer`。 。 。 .
-   `webSocket._socket` 不是一个 `net.Socket`,它只是一个具有非常基本功能的更得到功能.
-   `webSocket._socket.remote...` 可能会失败 你需要在连接处缓存它.
-   `webSocket` 像一个 `EventEmitter` 每个事件最多有一个听众.
-   `webSocket.upgradeReq` 只在连接处理器执行期间有效。 如果您想要在 WebSocket 的整个生命周期中保留升级Req 的属性, 您最好在 webSocket 连接时将该属性附加到 .

## 常见问题

### @discordjs/uws 是什么？

微小的 WebSockets注意：该包已被作者标记为弃用——Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

### 如何安装 @discordjs/uws？

在项目目录运行 npm install @discordjs/uws，或使用 pnpm add / yarn add / bun add。

### @discordjs/uws 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/discordjs\_\_uws 是否存在。

### @discordjs/uws 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @discordjs/uws 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=6\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @discordjs/uws 可以商用吗？

@discordjs/uws 使用 Zlib 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。修改后的版本需明确标注，不得冒充原版。以上为概括，不构成法律意见，请以许可原文为准。

### @discordjs/uws 的下载量有多少？

根据 npm 官方下载统计，@discordjs/uws 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,185 次，日均约 106 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @discordjs/uws 还在维护吗？

最新版本 11\.149\.1 发布于 2018/10/25（8 年前）；至今共发布 5 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/08/23。作者已将其标记为弃用，新项目建议寻找替代方案。