1
This commit is contained in:
1 parent
b5328277ab
commit
1ab5d52449
89 files changed
+14197
-65
No files matched your search
@@ -0,0 +1,110 @@
|
||||
// 守护测试:验证内置(vendored)xterm 的 IndexAwareCircularBuffer.trimStart() 补丁。
|
||||
//
|
||||
// 上游 4.0.0 的 trimStart() 只调整 _startIndex/_length,导致:
|
||||
// ① 存活行 index 偏移“被裁掉的行数” → CellAnchor.offset 错位、选区画不出、复制为空;
|
||||
// ② 被裁掉的行从不 _detach → 僵尸锚点(attached 仍为 true,静默指向别的行)。
|
||||
// 触发链:shell 的 clear / Ctrl+L → ESC[3J → Buffer.clearScrollback() → trimStart()。
|
||||
//
|
||||
// 若将来升级 xterm 后本文件失败,说明补丁丢失(或上游改动了实现),
|
||||
// 处理方式见 packages/xterm/PATCHES.md。
|
||||
import 'package:flutter_test/flutter_test.dart';
|
||||
import 'package:xterm/xterm.dart' as xterm;
|
||||
|
||||
/// 核心不变量:列表中第 i 行的 `index` 必须等于 i(`CellAnchor.y` 依赖它当行号用)。
|
||||
void expectIndexInvariant(xterm.Terminal terminal) {
|
||||
final buffer = terminal.buffer;
|
||||
for (var i = 0; i < buffer.height; i++) {
|
||||
expect(
|
||||
buffer.lines[i].index,
|
||||
i,
|
||||
reason: '第 $i 行的 index 与行号不一致 —— trimStart 补丁失效',
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 当前可见视口(不含回滚缓冲)的文本快照。
|
||||
String visibleText(xterm.Terminal terminal) {
|
||||
final buffer = terminal.buffer;
|
||||
final scrollBack = buffer.scrollBack;
|
||||
final builder = StringBuffer();
|
||||
for (var i = 0; i < buffer.viewHeight; i++) {
|
||||
builder.writeln(buffer.lines[scrollBack + i].getText().trimRight());
|
||||
}
|
||||
return builder.toString();
|
||||
}
|
||||
|
||||
xterm.Terminal buildFilledTerminal() {
|
||||
final terminal = xterm.Terminal(maxLines: 30);
|
||||
terminal.resize(80, 10);
|
||||
for (var i = 0; i < 40; i++) {
|
||||
terminal.write('L$i\r\n');
|
||||
}
|
||||
return terminal;
|
||||
}
|
||||
|
||||
void main() {
|
||||
group('vendored xterm trimStart 补丁守护测试', () {
|
||||
test('push 溢出裁剪(maxLines 上限)保持行索引不变式', () {
|
||||
final terminal = buildFilledTerminal();
|
||||
|
||||
// 溢出裁剪由 push 完成,本身维持不变式,作为对照组
|
||||
expect(terminal.buffer.height, 30);
|
||||
expect(terminal.buffer.scrollBack, greaterThan(0));
|
||||
expectIndexInvariant(terminal);
|
||||
});
|
||||
|
||||
test('ESC[3J 清空回滚缓冲后行索引归一、可见画面保留', () {
|
||||
final terminal = buildFilledTerminal();
|
||||
final heightBefore = terminal.buffer.height;
|
||||
final visibleBefore = visibleText(terminal);
|
||||
|
||||
terminal.write('\x1b[3J');
|
||||
|
||||
expect(terminal.buffer.height, lessThan(heightBefore));
|
||||
expect(terminal.buffer.height, terminal.buffer.viewHeight);
|
||||
expect(terminal.buffer.scrollBack, 0);
|
||||
// 补丁前:lines[0].index == 20(被裁掉的行数)
|
||||
expectIndexInvariant(terminal);
|
||||
expect(visibleText(terminal), visibleBefore, reason: '清除回滚不得改动可见画面');
|
||||
});
|
||||
|
||||
test('被裁掉行上的锚点被正确失效,存活行上的锚点重新对齐', () {
|
||||
final terminal = buildFilledTerminal();
|
||||
final buffer = terminal.buffer;
|
||||
|
||||
final droppedAnchor = buffer.createAnchorFromOffset(const xterm.CellOffset(0, 0));
|
||||
final survivingAnchor =
|
||||
buffer.createAnchorFromOffset(xterm.CellOffset(0, buffer.height - 1));
|
||||
expect(droppedAnchor.attached, isTrue);
|
||||
expect(survivingAnchor.attached, isTrue);
|
||||
|
||||
terminal.write('\x1b[3J');
|
||||
|
||||
// ① 被裁掉的行走 _dropChild -> detach,旧锚点不再“僵尸”存活
|
||||
expect(droppedAnchor.attached, isFalse, reason: '被裁掉的行必须被 detach');
|
||||
// ② 存活下来的行索引重新对齐到新行号
|
||||
expect(survivingAnchor.attached, isTrue);
|
||||
expect(survivingAnchor.offset.y, buffer.height - 1);
|
||||
expect(survivingAnchor.line, same(buffer.lines[buffer.height - 1]));
|
||||
});
|
||||
|
||||
test('清空回滚缓冲后新建选区落在可见行范围内且能读出文本', () {
|
||||
final terminal = buildFilledTerminal();
|
||||
|
||||
// 真实 clear 命令序列(xterm-256color 带 E3 能力)
|
||||
terminal.write('\x1b[H\x1b[2J\x1b[3J');
|
||||
terminal.write('\x1b[31mERROR\x1b[0m hello world\r\nsecond line\r\n');
|
||||
|
||||
expectIndexInvariant(terminal);
|
||||
|
||||
final begin = terminal.buffer.createAnchorFromOffset(const xterm.CellOffset(0, 0));
|
||||
final end = terminal.buffer.createAnchorFromOffset(const xterm.CellOffset(5, 0));
|
||||
expect(begin.offset.y, 0);
|
||||
expect(end.offset.y, 0);
|
||||
expect(begin.offset.y, lessThan(terminal.buffer.height));
|
||||
|
||||
final range = xterm.BufferRangeLine(begin.offset, end.offset).normalized;
|
||||
expect(terminal.buffer.getText(range), 'ERROR');
|
||||
});
|
||||
});
|
||||
}
|
||||
Reference in new issue
Block a user