183 lines
8.8 KiB
JavaScript
183 lines
8.8 KiB
JavaScript
// main/fs-watcher.js 单测（Case-M1 audit fix + Round 13 fix 回归）
|
||
//
|
||
// 不在仓库里的测试 —— fs-watcher 600+ 行（数据目录监听 + 事件防抖 + 自写过滤 +
|
||
// 错误闩锁 + 退避重连 + generation token）一直没单元测试。这次先补 case-insensitive
|
||
// self-write filter 这一条（核心 bug 修复的回归锚点），其他路径（轮询 / 重连 / 错误
|
||
// 抑制）需要 jsdom + 真实 fs.watch 集成，留给后续 Story。
|
||
//
|
||
// 覆盖：
|
||
// - markExpectedWrite / isSelfWrite：登记大小写 X 的路径，命中查询大小写 Y 也能识别
|
||
// - 与 case-sensitive 的 Linux 行为对照（platform-based 切换）
|
||
// - 过期条目被惰性 GC
|
||
// - updateSnapshot 轮询路径 push 回归（Round 13 fix fce2d83 修复的 bug）：
|
||
// 旧实现 baseline 在 updateSnapshot 先写、emitFilesChanged 又读，看到同一
|
||
// snapshot 时 if 块不进、safeSend 跳过 —— 2s 轮询（fs.watch 不可靠环境的
|
||
// 唯一兜底）检测到的改动永远不通知 renderer。
|
||
|
||
import { describe, it, expect, vi } from 'vitest';
|
||
const { createFsWatcher } = require('../../main/fs-watcher.js');
|
||
|
||
/**
|
||
* 构造一个最小化的 fsWatcher 实例用于单元测试。
|
||
* 不实际订阅 fs.watch、轮询或 IPC —— 我们只关心 self-write filter 的 Map 行为。
|
||
*/
|
||
function makeWatcher() {
|
||
return createFsWatcher({
|
||
// 不用 —— 只用 mark/isSelfWrite
|
||
getMainWindow: () => null,
|
||
resolveDataDir: () => null,
|
||
scanDir: async () => ({ ok: true, entries: [] }),
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 构造带 ipc spy 的 fsWatcher，用于验证 updateSnapshot regular path 是否
|
||
* 真的把列表变化 push 到 renderer。getMainWindow 返回一个虚拟 BrowserWindow，
|
||
* webContents.send 被替换为 vi.fn()，方便断言调用次数 + payload。
|
||
*/
|
||
function makeWatcherWithIpc(scanResults) {
|
||
const sends = [];
|
||
const fakeWin = {
|
||
isDestroyed: () => false,
|
||
webContents: { send: (channel, payload) => sends.push({ channel, payload }) },
|
||
};
|
||
let scanIdx = 0;
|
||
const w = createFsWatcher({
|
||
getMainWindow: () => fakeWin,
|
||
resolveDataDir: () => '/data',
|
||
scanDir: async () => scanResults[scanIdx++] || { ok: true, entries: [] },
|
||
});
|
||
return { watcher: w, sends, fakeWin };
|
||
}
|
||
|
||
describe('fs-watcher markExpectedWrite / isSelfWrite (Case-M1)', () => {
|
||
it('同 case 命中（sanity）', () => {
|
||
const w = makeWatcher();
|
||
w.markExpectedWrite('C:\\Notes\\foo.md', 1000);
|
||
expect(w.isSelfWrite('C:\\Notes\\foo.md')).toBe(true);
|
||
});
|
||
|
||
it('Windows / darwin：跨 case 命中（Case-M1 修复）', () => {
|
||
// audit fix (Case-M1)：fs.watch 在 Windows 上报的 filename 与 caller 写入的
|
||
// case 可能不一致（取决于 ReadDirectoryChangesW / NTFS 短名 8.3 / 同步盘
|
||
// 大小写敏感层）。strict Map.get 会漏命中 → renderer 把自写当成外部修改
|
||
// 误报，用户选「用磁盘版」会覆盖刚保存的内容。
|
||
const w = makeWatcher();
|
||
const mixed = process.platform;
|
||
// 在 Windows / darwin 上模拟「登记 Foo.md，watcher 上报 foo.md」
|
||
w.markExpectedWrite(`C:\\Notes\\Foo.md`, 1000);
|
||
const lookups = (process.platform === 'win32' || process.platform === 'darwin')
|
||
? [`C:\\Notes\\foo.md`, `C:\\Notes\\FOO.md`, `c:\\notes\\Foo.md`, `C:/Notes/Foo.md`]
|
||
: [`C:\\Notes\\Foo.md`];
|
||
for (const alt of lookups) {
|
||
expect(w.isSelfWrite(alt)).toBe(true);
|
||
}
|
||
expect(mixed).toBeTruthy(); // sanity guard
|
||
});
|
||
|
||
it('Linux（case-sensitive 平台）：跨 case 不命中（旧行为保留）', () => {
|
||
// 仅当跑在 Linux 上才相关：默认模拟 darwin 风格的 expect 命中安全，
|
||
// 但 Linux 上 case-different 路径不应被误当作自写。
|
||
if (process.platform === 'linux') {
|
||
const w = makeWatcher();
|
||
w.markExpectedWrite('/tmp/Foo.md', 1000);
|
||
expect(w.isSelfWrite('/tmp/Foo.md')).toBe(true);
|
||
expect(w.isSelfWrite('/tmp/foo.md')).toBe(false);
|
||
} else {
|
||
// 在非 Linux 上跳过，但保持测试存在以便 CI 多平台矩阵触达。
|
||
expect(true).toBe(true);
|
||
}
|
||
});
|
||
|
||
it('未登记的路径：isSelfWrite 返回 false', () => {
|
||
const w = makeWatcher();
|
||
expect(w.isSelfWrite('C:\\Notes\\unknown.md')).toBe(false);
|
||
w.markExpectedWrite('C:\\Notes\\expected.md', 1000);
|
||
expect(w.isSelfWrite('C:\\Notes\\other.md')).toBe(false);
|
||
});
|
||
|
||
it('clearExpectedWrites 后所有命中失效', () => {
|
||
const w = makeWatcher();
|
||
w.markExpectedWrite('C:\\Notes\\foo.md', 1000);
|
||
expect(w.isSelfWrite('C:\\Notes\\foo.md')).toBe(true);
|
||
// markExpectedWrite 的 expiresAt = Date.now() + 500ms —— 不 clear 也得过 500ms
|
||
// 才失效。clear 是立即清理入口（切目录 / stop 监听时调用）。
|
||
w.clearExpectedWrites();
|
||
expect(w.isSelfWrite('C:\\Notes\\foo.md')).toBe(false);
|
||
});
|
||
});
|
||
|
||
describe('fs-watcher updateSnapshot —— push 决策回归 (Round 13 fix fce2d83)', () => {
|
||
// 关键回归锚点：2s 轮询（OneDrive / SMB fs.watch 不可靠环境唯一兜底）检测
|
||
// 到列表变化，必须把新列表推到 renderer 侧栏刷新。历史 bug 把 skipInitialEmit
|
||
// 透传给 emitFilesChanged + baseline 重复写，导致 safeSend 永远跳过。
|
||
//
|
||
// 测试通过 internal _test_updateSnapshot 触发该路径，避免引入 jsdom + 真 fs.watch。
|
||
|
||
it('startup 路径（skipInitialEmit=true）：同步 baseline 但不 push', async () => {
|
||
// audit fix：startWatchingDir 内部 updateSnapshot(dir, true) 拿到的「真实状态」
|
||
// 只用来同步 baseline，不能误当成「新增变化」推给 renderer —— renderer 会通过
|
||
// 'file:list' 自己拉取启动文件列表，避免「刚加载就 emitFilesChanged 又被 renderer
|
||
// 当 fs:changed 事件 → 触发 scanDir 重复请求」的循环。
|
||
const { watcher: w, sends } = makeWatcherWithIpc([
|
||
{ ok: true, entries: [{ name: 'a.md', size: 10, mtimeMs: 1 }] },
|
||
]);
|
||
await w._test_updateSnapshot('/data', /* skipInitialEmit */ true);
|
||
// startup 只写 baseline 不 push
|
||
const filesChanged = sends.filter((s) => s.channel === 'files:changed');
|
||
expect(filesChanged.length).toBe(0);
|
||
});
|
||
|
||
it('常规路径（skipInitialEmit=false）：检测到变化必须 push', async () => {
|
||
// 关键回归：第一次 startup（不 push）后，第二次常规 updateSnapshot 看到列表变化
|
||
// → 必须 safeSend 通知 renderer。Round 13 fix 之前的实现 silent 失败。
|
||
const { watcher: w, sends } = makeWatcherWithIpc([
|
||
// 1st call: startup snapshot, list = [a.md]
|
||
{ ok: true, entries: [{ name: 'a.md', size: 10, mtimeMs: 1 }] },
|
||
// 2nd call: polling tick, list grew to [a.md, b.md]
|
||
{ ok: true, entries: [
|
||
{ name: 'a.md', size: 10, mtimeMs: 1 },
|
||
{ name: 'b.md', size: 20, mtimeMs: 2 },
|
||
] },
|
||
]);
|
||
await w._test_updateSnapshot('/data', true); // startup
|
||
await w._test_updateSnapshot('/data', false); // polling tick detects new file
|
||
const pushes = sends
|
||
.filter((s) => s.channel === 'files:changed')
|
||
.map((s) => s.payload);
|
||
expect(pushes.length).toBeGreaterThanOrEqual(1);
|
||
const last = pushes[pushes.length - 1];
|
||
expect(last.entries.map((e) => e.name).sort()).toEqual(['a.md', 'b.md']);
|
||
// relOf 没有 toRelDir 注入时返回 null（fs-watcher 契约：可选字段，
|
||
// payload 缺 relDir 仍合法；renderer 走 fallback 不依赖此字段）
|
||
expect(last.relDir == null).toBe(true);
|
||
});
|
||
|
||
it('常规路径但列表未变：不 push（baseline 一致）', async () => {
|
||
// 同一列表连扫两次 → baseline 不变 → emitFilesChanged 内部 if 块不进 → 不 push。
|
||
// 避免 fs.watch + polling 双通道把同一次变化报两遍。
|
||
const { watcher: w, sends } = makeWatcherWithIpc([
|
||
{ ok: true, entries: [{ name: 'a.md', size: 10, mtimeMs: 1 }] },
|
||
{ ok: true, entries: [{ name: 'a.md', size: 10, mtimeMs: 1 }] },
|
||
]);
|
||
await w._test_updateSnapshot('/data', true);
|
||
await w._test_updateSnapshot('/data', false);
|
||
const pushes = sends.filter((s) => s.channel === 'files:changed');
|
||
expect(pushes.length).toBe(0);
|
||
});
|
||
|
||
it('扫描失败（result.ok=false）→ 通过错误通道 push，不走 entries 通道', async () => {
|
||
// 与 change 分支独立 —— 错误走 'files:changed' 但 payload 不带 entries，
|
||
// renderer 用 error 字段弹 toast 并保留旧列表（Round 7 FS-F12 行为）。
|
||
const { watcher: w, sends } = makeWatcherWithIpc([
|
||
{ ok: false, error: 'DATA_DIR_NOT_FOUND', code: 'ENOENT' },
|
||
]);
|
||
await w._test_updateSnapshot('/data', false);
|
||
const pushes = sends.filter((s) => s.channel === 'files:changed');
|
||
expect(pushes.length).toBe(1);
|
||
expect(pushes[0].payload.error).toBe('DATA_DIR_NOT_FOUND');
|
||
expect(pushes[0].payload.entries).toBeUndefined();
|
||
});
|
||
});
|
||
|