将 chokidar 从 5.x 升级到 6.x

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

概要

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

已删除的导出

import	export	kind	之前
`chokidar`	`WatchHelper`	class	`class`

已修改的签名

export	之前	之后
`chokidar · watch`	`(paths: string \| string[], options?: Partial<BasicOpts & { ignored: Matcher \| Matcher[]; awaitWriteFinish: boolean \| Partial<AWF>; }> \| undefined): FSWatcher`	`(paths: string \| string[], options?: Partial<BasicOptions & { ignored: Matcher \| Matcher[]; awaitWriteFinish: boolean \| Partial<AWF>; }> \| undefined): FSWatcher`
`chokidar · default`	`{ watch: (paths: string \| string[], options?: Partial<BasicOpts & { ignored: Matcher \| Matcher[]; awaitWriteFinish: boolean \| Partial<AWF>; }> \| undefined) => FSWatcher; FSWatcher: typeof FSWatcher; }`	`{ watch: (paths: string \| string[], options?: Partial<BasicOptions & { ignored: Matcher \| Matcher[]; awaitWriteFinish: boolean \| Partial<AWF>; }> \| undefined) => FSWatcher; FSWatcher: typeof FSWatcher; }`
`chokidar · Throttler`	`{ timeoutObject: NodeJS.Timeout; clear: () => void; count: number; }`	`{ timeoutObject: SchedulerTimer; clear: (invokeRelease?: boolean \| undefined) => number; count: number; }`
`chokidar · ThrottleType`	`"readdir" \| "watch" \| "add" \| "remove" \| "change"`	`"add" \| "change" \| "readdir" \| "watch" \| "remove"`
`chokidar · MatcherObject`	`interface`	`{ path: string; recursive?: boolean \| undefined; }`
`chokidar · ChokidarOptions`	`{ persistent?: boolean \| undefined; ignoreInitial?: boolean \| undefined; followSymlinks?: boolean \| undefined; cwd?: string \| undefined; usePolling?: boolean \| undefined; interval?: number \| undefined; binaryInterval?: number \| undefined; alwaysStat?: boolean \| undefined; depth?: number \| undefined; ignorePermissionErrors?: boolean \| undefined; atomic?: number \| boolean \| undefined; ignored?: Matcher \| Matcher[] \| undefined; awaitWriteFinish?: boolean \| Partial<AWF> \| undefined; }`	{ persistent?: boolean \| undefined; ignoreInitial?: boolean \| undefined; followSymlinks?: boolean \| undefined; cwd?: string \| undefined; backend?: WatchBackend \| undefined; usePolling?: boolean \| undefined; pollingInterval?: number \| undefined; pollingBinaryInterval?: number \| undefined; interval?: number \| undefined; binaryInterval?: number \| undefined; alwaysStat?: boolean \| undefined; depth?: number \| undefined; ignorePermissionErrors?: boolean \| undefined; atomic?: number \| boolean \| undefined; ignored?: Matcher \| Matcher[] \| undefined; awaitWriteFinish?: boolean \| Partial<AWF> \| undefined…
`chokidar · FSWInstanceOptions`	`BasicOpts & { ignored: Matcher[]; awaitWriteFinish: false \| AWF; }`	`BasicOptions & { ignored: readonly Matcher[]; awaitWriteFinish: false \| AWF; backendStrategy: BackendStrategy; backendCapabilities: Readonly<{ kind: BackendStrategy; polling: boolean; recursive: boolean; perDirectory: boolean; }>; }`

已删除的类或接口成员

member	import	之前
`FSWatcher._emit`	`chokidar`	`(event: EventName, path: string, stats?: any): Promise<FSWatcher \| undefined>`
`FSWatcher._remove`	`chokidar`	`(directory: string, item: string, isDirectory?: boolean \| undefined): void`
`FSWatcher._closers`	`chokidar`	`Map<string, any[]>`
`FSWatcher._emitRaw`	`chokidar`	`(ev: WatchEventType, path: string, opts: unknown): void`
`FSWatcher._streams`	`chokidar`	`Set<ReaddirpStream>`
`FSWatcher._watched`	`chokidar`	`Map<string, DirEntry>`
`FSWatcher._readdirp`	`chokidar`	`(root: string, opts?: any): any`
`FSWatcher._throttle`	`chokidar`	`(actionType: ThrottleType, path: string, timeout: number): false \| Throttler`
`FSWatcher._closeFile`	`chokidar`	`(path: string): void`
`FSWatcher._closePath`	`chokidar`	`(path: string): void`
`FSWatcher._emitReady`	`chokidar`	`(): void`
`FSWatcher._isIgnored`	`chokidar`	`(path: string, stats?: any): boolean`
`FSWatcher._throttled`	`chokidar`	`Map<ThrottleType, Map<any, any>>`
`FSWatcher._readyCount`	`chokidar`	`number`
`FSWatcher._boundRemove`	`chokidar`	`(dir: string, item: string): void`
`FSWatcher._handleError`	`chokidar`	`(error: Error): boolean \| Error`
`FSWatcher._isntIgnored`	`chokidar`	`(path: string, stat?: any): boolean`
`FSWatcher._userIgnored`	`chokidar`	`MatchFunction \| undefined`
`FSWatcher._closePromise`	`chokidar`	`Promise<void> \| undefined`
`FSWatcher._ignoredPaths`	`chokidar`	`Set<Matcher>`
`FSWatcher._readyEmitted`	`chokidar`	`boolean`
`FSWatcher._symlinkPaths`	`chokidar`	`Map<string, string \| boolean>`
`FSWatcher._addPathCloser`	`chokidar`	`(path: string, closer: () => void): void`
`FSWatcher._getWatchedDir`	`chokidar`	`(directory: string): DirEntry`
`FSWatcher._nodeFsHandler`	`chokidar`	`NodeFsHandler`
`FSWatcher._pendingWrites`	`chokidar`	`Map<string, any>`
`FSWatcher._addIgnoredPath`	`chokidar`	`(matcher: Matcher): void`
`FSWatcher._incrReadyCount`	`chokidar`	`(): number`
`FSWatcher._pendingUnlinks`	`chokidar`	`Map<string, [event: EventName, path: string, stats?: any]>`
`FSWatcher._getWatchHelpers`	`chokidar`	`(path: string): WatchHelper`
`FSWatcher._awaitWriteFinish`	`chokidar`	`(path: string, threshold: number, event: EventName, awfEmit: (err?: Error \| undefined, stat?: any) => void): void`
`FSWatcher._removeIgnoredPath`	`chokidar`	`(matcher: Matcher): void`
`FSWatcher._hasReadPermissions`	`chokidar`	`(stats: Stats): boolean`

已修改的类或接口成员

member	之前	之后
`FSWatcher.add`	`(paths_: string \| string[], _origAdd?: string \| undefined, _internal?: boolean \| undefined): FSWatcher`	`(paths_: string \| string[]): FSWatcher`
`FSWatcher.constructor`	`(_opts?: Partial<BasicOpts & { ignored: Matcher \| Matcher[]; awaitWriteFinish: boolean \| Partial<AWF>; }> \| undefined): FSWatcher`	`(_opts?: Partial<BasicOptions & { ignored: Matcher \| Matcher[]; awaitWriteFinish: boolean \| Partial<AWF>; }> \| undefined, scheduler?: Scheduler \| undefined): FSWatcher`
`FSWatcher.emitWithAll`	`(event: EventName, args: EmitArgs): void`	`any`
`FSWatcherEventMap.raw`	`[ev: WatchEventType, path: string, opts: unknown]`	`[ev: WatchEventType, path: string \| null, opts: unknown]`

新增弃用

未发现。

要求变化（engines、peer 依赖）

	之前	之后
`engines.node`	`>= 20.19.0`	`—`

新增导出 (4)

import	export	kind
`chokidar`	`Scheduler`	interface
`chokidar`	`WatchBackend`	type
`chokidar`	`SchedulerTimer`	interface
`chokidar`	`BackendStrategy`	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

常见问题

将 chokidar 从 5 升级到 6 有哪些不兼容变更？

在 chokidar 5.0.0 与 6.0.0 之间，Vigia 发现 1 个已删除的导出、7 个已修改的签名，以及 37 个已删除或修改的类或接口成员。

chokidar 6 中弃用了哪些内容？

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

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/chokidar/upgrade?from=5.0.0&to=6.0.0