将 ws 从 7.x 升级到 8.x

根据 TypeScript 类型自动比较 ws 7.5.13 与 8.23.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	1
已修改的签名	2
已删除的类或接口成员	0
已修改的类或接口成员	13
新增弃用	0
要求变化（engines、peer 依赖）	3
新增导出	6

已删除的导出

import	export	kind	之前
`ws`	`OpenEvent`	interface	`interface`

已修改的签名

export	之前	之后
`ws · VerifyClientCallbackSync`	`(info: { origin: string; secure: boolean; req: IncomingMessage; }) => boolean`	`(info: { origin: string; secure: boolean; req: Request; }) => boolean`
`ws · VerifyClientCallbackAsync`	`(info: { origin: string; secure: boolean; req: IncomingMessage; }, callback: (res: boolean, code?: number \| undefined, message?: string \| undefined, headers?: any) => void) => void`	`(info: { origin: string; secure: boolean; req: Request; }, callback: (res: boolean, code?: number \| undefined, message?: string \| undefined, headers?: any) => void) => void`

已删除的类或接口成员

未发现。

已修改的类或接口成员

member	之前	之后
`Server.on`	`(event: "connection", cb: (this: Server, socket: WebSocket, request: IncomingMessage) => void): Server \| (event: "error", cb: (this: Server, error: Error) => void): Server \| (event: "headers", cb: (this: Server, headers: string[], request: IncomingMessage) => void): Server \| (event: "close" \| "liste…`	`(event: "connection", cb: (this: Server<T, any>, websocket: InstanceType<T>, request: InstanceType<U>) => void): Server<T, U> \| (event: "error", cb: (this: Server<T, any>, error: Error) => void): Server<T, U> \| (event: "headers", cb: (this: Server<T, any>, headers: string[], request: InstanceType<U>…`
`Server.off`	`(event: "connection", cb: (this: Server, socket: WebSocket, request: IncomingMessage) => void): Server \| (event: "error", cb: (this: Server, error: Error) => void): Server \| (event: "headers", cb: (this: Server, headers: string[], request: IncomingMessage) => void): Server \| (event: "close" \| "liste…`	`(event: "connection", cb: (this: Server<T, any>, socket: InstanceType<T>, request: InstanceType<U>) => void): Server<T, U> \| (event: "error", cb: (this: Server<T, any>, error: Error) => void): Server<T, U> \| (event: "headers", cb: (this: Server<T, any>, headers: string[], request: InstanceType<U>) =…`
`Server.once`	`(event: "connection", cb: (this: Server, socket: WebSocket, request: IncomingMessage) => void): Server \| (event: "error", cb: (this: Server, error: Error) => void): Server \| (event: "headers", cb: (this: Server, headers: string[], request: IncomingMessage) => void): Server \| (event: "close" \| "liste…`	`(event: "connection", cb: (this: Server<T, any>, websocket: InstanceType<T>, request: InstanceType<U>) => void): Server<T, U> \| (event: "error", cb: (this: Server<T, any>, error: Error) => void): Server<T, U> \| (event: "headers", cb: (this: Server<T, any>, headers: string[], request: InstanceType<U>…`
`Server.address`	`(): string \| AddressInfo`	`(): string \| AddressInfo \| null`
`Server.clients`	`Set<WebSocket>`	`Set<InstanceType<T>>`
`Server.options`	`ServerOptions`	`ServerOptions<T, U>`
`Server.addListener`	`(event: "connection", cb: (client: WebSocket, request: IncomingMessage) => void): Server \| (event: "error", cb: (err: Error) => void): Server \| (event: "headers", cb: (headers: string[], request: IncomingMessage) => void): Server \| (event: "close" \| "listening", cb: () => void): Server \| (event: str…`	`(event: "connection", cb: (websocket: InstanceType<T>, request: InstanceType<U>) => void): Server<T, U> \| (event: "error", cb: (error: Error) => void): Server<T, U> \| (event: "headers", cb: (headers: string[], request: InstanceType<U>) => void): Server<T, U> \| (event: "close" \| "listening", cb: () =…`
`Server.constructor`	`(options?: ServerOptions \| undefined, callback?: (() => void) \| undefined): Server`	`<T extends typeof WebSocket.WebSocket = typeof WebSocket, U extends typeof IncomingMessage = any>(options?: ServerOptions<T, U> \| undefined, callback?: (() => void) \| undefined): Server<T, U>`
`Server.shouldHandle`	`(request: IncomingMessage): boolean \| Promise<boolean>`	`(request: InstanceType<U>): boolean \| Promise<boolean>`
`Server.handleUpgrade`	`(request: IncomingMessage, socket: Socket, upgradeHead: Buffer, callback: (client: WebSocket, request: IncomingMessage) => void): void`	`(request: InstanceType<U>, socket: Duplex, upgradeHead: Buffer, callback: (client: InstanceType<T>, request: InstanceType<U>) => void): void`
`Server.removeListener`	`(event: "connection", cb: (client: WebSocket) => void): Server \| (event: "error", cb: (err: Error) => void): Server \| (event: "headers", cb: (headers: string[], request: IncomingMessage) => void): Server \| (event: "close" \| "listening", cb: () => void): Server \| (event: string \| symbol, listener: (.…`	`(event: "connection", cb: (websocket: InstanceType<T>, request: InstanceType<U>) => void): Server<T, U> \| (event: "error", cb: (error: Error) => void): Server<T, U> \| (event: "headers", cb: (headers: string[], request: InstanceType<U>) => void): Server<T, U> \| (event: "close" \| "listening", cb: () =…`
`ServerOptions.verifyClient`	`VerifyClientCallbackSync \| VerifyClientCallbackAsync \| undefined`	`VerifyClientCallbackAsync<InstanceType<V>> \| VerifyClientCallbackSync<InstanceType<V>> \| undefined`
`ServerOptions.handleProtocols`	`any`	`((protocols: Set<string>, request: InstanceType<V>) => string \| false) \| undefined`

新增弃用

未发现。

要求变化（engines、peer 依赖）

	之前	之后
`engines.node`	`>=8.3.0`	`—`
`peerDependencies.bufferutil`	`^4.0.1`	`—`
`peerDependencies.utf-8-validate`	`^5.0.2`	`—`

新增导出 (6)

import	export	kind
`ws`	`Event`	interface
`ws`	`RawData`	type
`ws`	`WebSocket`	interface
`ws`	`WebSocketServer`	interface
`ws`	`WebSocketEventMap`	interface
`ws`	`FinishRequestCallback`	type

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 ws 从 7 升级到 8 有哪些不兼容变更？

在 ws 7.5.13 与 8.23.0 之间，Vigia 发现 1 个已删除的导出、2 个已修改的签名，以及 13 个已删除或修改的类或接口成员。

ws 8 中弃用了哪些内容？

ws 8.23.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/ws/upgrade?from=7.5.13&to=8.23.0