ws を 7.x から 8.x へアップグレード

ws 7.5.13 と 8.23.0 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	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