test: 增强 UI 测试基础设施与阅读器自动化测试

- 新增 BookmarkTests/PageNavigationTests/TableOfContentsTests 等阅读器功能测试 - 扩展 AccessibilityIdentifiers 支持更多 UI 元素定位 - XCUIApplication+Launch: 增加启动参数支持（reset state、自定义书籍） - ReaderAnnotationTests: 完善标注测试覆盖 - ViewController: 支持 --demo-reset-state 参数清理持久化状态 - 新增凡人修仙传测试样本 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-02 21:17:04 +08:00
parent c76beed03c
commit 9801af05d3
11 changed files with 907 additions and 14 deletions
@@ -0,0 +1,82 @@
+import XCTest
+
+final class BookmarkTests: XCTestCase {
+    private let app = XCUIApplication()
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+    }
+
+    func testBookmarkButtonExistsInToolbar() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let bookmarkButton = app.buttons[IDs.readerBookmark]
+        XCTAssertTrue(bookmarkButton.waitForExistence(timeout: 5), "书签按钮未出现")
+    }
+
+    func testToggleBookmark() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let bookmarkButton = app.buttons[IDs.readerBookmark]
+        XCTAssertTrue(bookmarkButton.waitForExistence(timeout: 5), "书签按钮未出现")
+        bookmarkButton.tap()
+        Thread.sleep(forTimeInterval: 1)
+
+        app.showReaderChromeIfNeeded()
+        XCTAssertTrue(bookmarkButton.waitForExistence(timeout: 5), "书签按钮再次点击后未出现")
+        bookmarkButton.tap()
+    }
+
+    func testBookmarksButtonVisibleAfterBookmarkAdded() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let bookmarkButton = app.buttons[IDs.readerBookmark]
+        XCTAssertTrue(bookmarkButton.waitForExistence(timeout: 5), "书签按钮未出现")
+        bookmarkButton.tap()
+        Thread.sleep(forTimeInterval: 1)
+
+        app.showReaderChromeIfNeeded()
+        let bookmarksListButton = app.buttons[IDs.readerBookmarks]
+        XCTAssertTrue(bookmarksListButton.waitForExistence(timeout: 5), "书签列表按钮未出现")
+    }
+
+    func testBookmarksListButtonExists() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let bookmarksListButton = app.buttons[IDs.readerBookmarks]
+        XCTAssertTrue(bookmarksListButton.waitForExistence(timeout: 5), "书签列表按钮未出现")
+    }
+
+    func testBookmarksPanelIsAccessible() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let bookmarkButton = app.buttons[IDs.readerBookmark]
+        XCTAssertTrue(bookmarkButton.waitForExistence(timeout: 5), "书签按钮未出现")
+        bookmarkButton.tap()
+
+        app.showReaderChromeIfNeeded()
+        let bookmarksListButton = app.buttons[IDs.readerBookmarks]
+        XCTAssertTrue(bookmarksListButton.waitForExistence(timeout: 5), "书签列表按钮未出现")
+
+        let enabledPredicate = NSPredicate(format: "isEnabled == true")
+        expectation(for: enabledPredicate, evaluatedWith: bookmarksListButton)
+        waitForExpectations(timeout: 10)
+
+        XCTAssertTrue(bookmarksListButton.isEnabled, "书签列表按钮未启用")
+        bookmarksListButton.tap()
+
+        let bookmarksPanel = app.tables[IDs.readerBookmarksTable]
+        XCTAssertTrue(bookmarksPanel.waitForExistence(timeout: 5), "书签面板未出现")
+        XCTAssertTrue(app.navigationBars[IDs.readerBookmarksNavBar].waitForExistence(timeout: 2), "书签导航栏未暴露")
+    }
+}