浅念
357 lines
13 KiB
Dart
357 lines
13 KiB
Dart
/// 照片大图查看器 widget 测试（UI-01 §4.3）。
|
||
///
|
||
/// 覆盖：信息栏（上传者/相册时区时间/尺寸大小 + ID 诊断区）、左右切换、
|
||
/// 权限（管理者隐藏/恢复/删除；协作者自己上传可隐藏删除、不可恢复）、
|
||
/// 删除确认（云端照片将被删除）、关闭返回网格原位置、签名 URL 失败一次
|
||
/// 受控刷新、临近末尾加载更多。
|
||
library;
|
||
|
||
import 'package:dio/dio.dart';
|
||
import 'package:flutter/material.dart';
|
||
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
||
import 'package:flutter_test/flutter_test.dart';
|
||
import 'package:photo_live/core/api_client.dart';
|
||
import 'package:photo_live/core/error_codes.dart';
|
||
import 'package:photo_live/core/session_store.dart';
|
||
import 'package:photo_live/features/albums/models.dart';
|
||
import 'package:photo_live/l10n/app_localizations.dart';
|
||
import 'package:photo_live/pages/album_photos_page.dart';
|
||
import 'package:photo_live/pages/album_photo_viewer_page.dart';
|
||
import 'package:photo_live/ui/components/photo_thumbnail.dart';
|
||
|
||
import '../helpers/fakes.dart';
|
||
|
||
void main() {
|
||
late FakeSessionStore store;
|
||
|
||
setUp(() {
|
||
store = FakeSessionStore();
|
||
});
|
||
|
||
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
|
||
sessionStore: store,
|
||
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
|
||
..httpClientAdapter = adapter,
|
||
);
|
||
|
||
/// 网格 + 可选打开查看器；返回打开前的网格 Scrollable 像素偏移。
|
||
Future<double> pumpGridAndOpen(
|
||
WidgetTester tester,
|
||
ApiClient client, {
|
||
int tile = 0,
|
||
}) async {
|
||
await tester.pumpWidget(
|
||
ProviderScope(
|
||
overrides: [...pageTestOverrides(session: store, client: client)],
|
||
child: MaterialApp(
|
||
localizationsDelegates: AppLocalizations.localizationsDelegates,
|
||
supportedLocales: AppLocalizations.supportedLocales,
|
||
home: AlbumPhotosPage(album: Album.fromJson(albumJson())),
|
||
),
|
||
),
|
||
);
|
||
await tester.pumpAndSettle();
|
||
final gridScrollable = find.descendant(
|
||
of: find.byType(GridView),
|
||
matching: find.byType(Scrollable),
|
||
);
|
||
final before = tester
|
||
.state<ScrollableState>(gridScrollable)
|
||
.position
|
||
.pixels;
|
||
await tester.tap(find.byType(PhotoThumbnail).at(tile));
|
||
await tester.pumpAndSettle();
|
||
return before;
|
||
}
|
||
|
||
testWidgets('信息栏：上传者 / 相册时区时间 / 尺寸大小 + ID 诊断区', (tester) async {
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path != '/v1/albums/alb-1/photos') {
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
}
|
||
return (
|
||
200,
|
||
cursorPageBody(<Map<String, dynamic>>[
|
||
adminPhotoJson(photoId: 'ph-info-1', preview: photoPreviewJson()),
|
||
]),
|
||
);
|
||
});
|
||
await pumpGridAndOpen(tester, clientOf(adapter));
|
||
|
||
expect(find.byType(AlbumPhotoViewerPage), findsOneWidget);
|
||
expect(find.text('Staff Two'), findsOneWidget);
|
||
// uploadedAt 07:00Z → 相册时区上海 15:00；尺寸 + 大小。
|
||
expect(find.text('2026/9/18 15:00 · 4000×3000 · 121 KB'), findsOneWidget);
|
||
// ID 放诊断区域（弱化呈现）。
|
||
expect(find.text('ph-info-1'), findsOneWidget);
|
||
});
|
||
|
||
testWidgets('左右切换已加载照片 + 临近末尾加载更多', (tester) async {
|
||
final page1 = List<Map<String, dynamic>>.generate(
|
||
20,
|
||
(i) => adminPhotoJson(
|
||
photoId: 'ph-v${(i + 1).toString().padLeft(2, '0')}',
|
||
uploaderName: 'Uploader ${i + 1}',
|
||
preview: photoPreviewJson(),
|
||
),
|
||
);
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path != '/v1/albums/alb-1/photos') {
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
}
|
||
final cursor = o.uri.queryParameters['cursor'];
|
||
if (cursor == null) {
|
||
return (200, cursorPageBody(page1, nextCursor: 'vc1'));
|
||
}
|
||
if (cursor == 'vc1') {
|
||
return (
|
||
200,
|
||
cursorPageBody(<Map<String, dynamic>>[
|
||
adminPhotoJson(photoId: 'ph-vpage2', preview: photoPreviewJson()),
|
||
]),
|
||
);
|
||
}
|
||
throw StateError('unexpected cursor $cursor');
|
||
});
|
||
await pumpGridAndOpen(tester, clientOf(adapter));
|
||
|
||
// 初始第一张。
|
||
expect(find.text('Uploader 1'), findsOneWidget);
|
||
// 左右切换：到第二张。
|
||
await tester.drag(find.byType(PageView), const Offset(-700, 0));
|
||
await tester.pumpAndSettle();
|
||
expect(find.text('Uploader 2'), findsOneWidget);
|
||
|
||
// 连续滑到接近已加载末尾（page >= length-3 触发加载更多）。
|
||
for (var i = 0; i < 20; i++) {
|
||
await tester.drag(find.byType(PageView), const Offset(-700, 0));
|
||
await tester.pumpAndSettle();
|
||
}
|
||
expect(
|
||
adapter.requests.any((r) => r.uri.queryParameters['cursor'] == 'vc1'),
|
||
isTrue,
|
||
reason: '临近末尾按游标加载第二页',
|
||
);
|
||
});
|
||
|
||
testWidgets('管理者：已发布照片可隐藏/删除；隐藏照片可恢复', (tester) async {
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path == '/v1/albums/alb-1/photos') {
|
||
return (
|
||
200,
|
||
cursorPageBody(<Map<String, dynamic>>[
|
||
adminPhotoJson(photoId: 'ph-pub', preview: photoPreviewJson()),
|
||
adminPhotoJson(
|
||
photoId: 'ph-hid',
|
||
visibility: 'hidden',
|
||
preview: photoPreviewJson(),
|
||
),
|
||
]),
|
||
);
|
||
}
|
||
if (o.method == 'PATCH' && o.path == '/v1/photos/ph-pub') {
|
||
return (
|
||
200,
|
||
adminPhotoJson(photoId: 'ph-pub', visibility: 'hidden'),
|
||
);
|
||
}
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
});
|
||
final client = clientOf(adapter);
|
||
await pumpGridAndOpen(tester, client);
|
||
|
||
// 已发布：隐藏 + 删除（管理者，scope=all 成功）。
|
||
expect(find.text('Hide'), findsOneWidget);
|
||
expect(find.text('Delete'), findsOneWidget);
|
||
expect(find.text('Unhide'), findsNothing);
|
||
|
||
// 切到第二张（隐藏照片）：恢复显示（仅管理者）+ 删除。
|
||
await tester.drag(find.byType(PageView), const Offset(-700, 0));
|
||
await tester.pumpAndSettle();
|
||
expect(find.text('Unhide'), findsOneWidget);
|
||
expect(find.text('Hide'), findsNothing);
|
||
|
||
// 隐藏操作：PATCH visibility=hidden → 按钮翻转为恢复显示。
|
||
await tester.drag(find.byType(PageView), const Offset(700, 0));
|
||
await tester.pumpAndSettle();
|
||
await tester.tap(find.text('Hide'));
|
||
await tester.pumpAndSettle();
|
||
final patch = adapter.requests.singleWhere(
|
||
(r) => r.method == 'PATCH' && r.path == '/v1/photos/ph-pub',
|
||
);
|
||
expect(patch.body, <String, dynamic>{'visibility': 'hidden'});
|
||
expect(find.text('Unhide'), findsOneWidget, reason: '隐藏后可恢复');
|
||
expect(find.text('Hide'), findsNothing, reason: '已隐藏态不再显示隐藏入口');
|
||
});
|
||
|
||
testWidgets('协作者（scope=own）：自己上传可隐藏/删除，不可恢复', (tester) async {
|
||
store.session = Session(
|
||
token: 'tok-1',
|
||
expiresAt: DateTime.utc(2099, 1, 1),
|
||
account: 'staff02',
|
||
);
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path != '/v1/albums/alb-1/photos') {
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
}
|
||
final scope = o.uri.queryParameters['scope'];
|
||
if (scope == 'all') return (403, errorBody(ErrorCodes.authForbidden));
|
||
if (scope == 'own') {
|
||
return (
|
||
200,
|
||
cursorPageBody(<Map<String, dynamic>>[
|
||
adminPhotoJson(
|
||
photoId: 'ph-own-hidden',
|
||
visibility: 'hidden',
|
||
uploaderAccount: 'staff02',
|
||
preview: null,
|
||
),
|
||
]),
|
||
);
|
||
}
|
||
throw StateError('unexpected scope $scope');
|
||
});
|
||
await pumpGridAndOpen(tester, clientOf(adapter));
|
||
|
||
// 自己上传的隐藏照片：恢复发布仅创建者/管理员 → 不显示恢复入口。
|
||
expect(find.text('Unhide'), findsNothing);
|
||
expect(find.text('Delete'), findsOneWidget, reason: '自己上传可删除');
|
||
// 无预览（隐藏对协作者不签发）→ 状态说明 + 图片暂不可用。
|
||
expect(find.text('Image unavailable'), findsOneWidget);
|
||
expect(find.text('ph-own-hidden'), findsOneWidget);
|
||
});
|
||
|
||
testWidgets('删除：确认「云端照片」→ DELETE → 条目移除', (tester) async {
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path == '/v1/albums/alb-1/photos') {
|
||
return (
|
||
200,
|
||
cursorPageBody(<Map<String, dynamic>>[
|
||
adminPhotoJson(photoId: 'ph-del', preview: photoPreviewJson()),
|
||
]),
|
||
);
|
||
}
|
||
if (o.method == 'DELETE' && o.path == '/v1/photos/ph-del') {
|
||
return (204, null);
|
||
}
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
});
|
||
await pumpGridAndOpen(tester, clientOf(adapter));
|
||
|
||
await tester.tap(find.text('Delete'));
|
||
await tester.pumpAndSettle();
|
||
// 确认弹窗：明确影响云端照片。
|
||
expect(find.text('Delete this photo?'), findsOneWidget);
|
||
expect(
|
||
find.text('The cloud photo will be deleted. This cannot be undone.'),
|
||
findsOneWidget,
|
||
);
|
||
// 取消不删。
|
||
await tester.tap(find.text('Cancel'));
|
||
await tester.pumpAndSettle();
|
||
expect(
|
||
adapter.requests.any((r) => r.method == 'DELETE'),
|
||
isFalse,
|
||
reason: '取消不触发删除',
|
||
);
|
||
|
||
await tester.tap(find.text('Delete'));
|
||
await tester.pumpAndSettle();
|
||
await tester.tap(find.widgetWithText(FilledButton, 'Delete'));
|
||
await tester.pumpAndSettle();
|
||
|
||
expect(
|
||
adapter.requests.any(
|
||
(r) => r.method == 'DELETE' && r.path == '/v1/photos/ph-del',
|
||
),
|
||
isTrue,
|
||
);
|
||
// 唯一照片删除后 → 查看器退回网格（空态）。
|
||
expect(find.byType(AlbumPhotoViewerPage), findsNothing);
|
||
expect(find.text('No photos yet'), findsOneWidget);
|
||
});
|
||
|
||
testWidgets('关闭返回网格原滚动位置', (tester) async {
|
||
// 默认测试画布 800 宽 → 5 列；24 条 ≈ 5 行，超出视口可滚动。
|
||
final items = List<Map<String, dynamic>>.generate(
|
||
24,
|
||
(i) => adminPhotoJson(
|
||
photoId: 'ph-s${(i + 1).toString().padLeft(2, '0')}',
|
||
preview: photoPreviewJson(),
|
||
),
|
||
);
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path != '/v1/albums/alb-1/photos') {
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
}
|
||
return (200, cursorPageBody(items));
|
||
});
|
||
await tester.pumpWidget(
|
||
ProviderScope(
|
||
overrides: [...pageTestOverrides(session: store, client: clientOf(adapter))],
|
||
child: MaterialApp(
|
||
localizationsDelegates: AppLocalizations.localizationsDelegates,
|
||
supportedLocales: AppLocalizations.supportedLocales,
|
||
home: AlbumPhotosPage(album: Album.fromJson(albumJson())),
|
||
),
|
||
),
|
||
);
|
||
await tester.pumpAndSettle();
|
||
|
||
// 先滚动网格（离开顶部）。
|
||
final gridScrollable = find.descendant(
|
||
of: find.byType(GridView),
|
||
matching: find.byType(Scrollable),
|
||
);
|
||
await tester.drag(gridScrollable, const Offset(0, -600));
|
||
await tester.pumpAndSettle();
|
||
final scrolled = tester
|
||
.state<ScrollableState>(gridScrollable)
|
||
.position
|
||
.pixels;
|
||
expect(scrolled, greaterThan(0));
|
||
|
||
// 打开当前视口内可见的一张（滚动后树序首项可能在缓存区/被遮挡）→
|
||
// 关闭 → 偏移保持。
|
||
await tester.tap(find.byType(PhotoThumbnail).hitTestable().first);
|
||
await tester.pumpAndSettle();
|
||
expect(find.byType(AlbumPhotoViewerPage), findsOneWidget);
|
||
await tester.tap(find.byIcon(Icons.close));
|
||
await tester.pumpAndSettle();
|
||
|
||
expect(
|
||
tester.state<ScrollableState>(gridScrollable).position.pixels,
|
||
scrolled,
|
||
reason: '关闭大图后网格回到原滚动位置',
|
||
);
|
||
});
|
||
|
||
testWidgets('签名 URL 失败 → 一次受控刷新（不无限重试）', (tester) async {
|
||
var listCalls = 0;
|
||
final adapter = FakeAdapter((o) {
|
||
if (o.path != '/v1/albums/alb-1/photos') {
|
||
throw StateError('unexpected ${o.method} ${o.path}');
|
||
}
|
||
listCalls++;
|
||
// 刷新后返回新签名 URL（测试环境网络仍失败 → 验证不再重试）。
|
||
return (
|
||
200,
|
||
cursorPageBody(<Map<String, dynamic>>[
|
||
adminPhotoJson(
|
||
photoId: 'ph-url',
|
||
preview: photoPreviewJson(
|
||
browseUrl: 'http://test.local/browse-v$listCalls.jpg',
|
||
),
|
||
),
|
||
]),
|
||
);
|
||
});
|
||
await pumpGridAndOpen(tester, clientOf(adapter));
|
||
|
||
// 初次列表 + 失败后自动刷新一次 = 2 次；再等待后不再增加。
|
||
await tester.pumpAndSettle(const Duration(seconds: 1));
|
||
expect(listCalls, 2, reason: '签名 URL 失败仅重取一次');
|
||
expect(find.text('Image unavailable'), findsOneWidget);
|
||
});
|
||
}
|