修复小程序讲解页面返回回退

tests/unit/ExhibitDetailAudioFirst.spec.ts

@@ -6,6 +6,7 @@ import { flushPromises, mount } from '@vue/test-utils'
 
 const mocks = vi.hoisted(() => ({
   onLoadHandler: null as null | ((options?: Record<string, unknown>) => Promise<void>),
+  onBackPressHandler: null as null | (() => boolean),
   onHideHandler: null as null | (() => void),
   onUnloadHandler: null as null | (() => void),
   enterExplainDetail: vi.fn(),
@@ -17,7 +18,9 @@ const mocks = vi.hoisted(() => ({
   close: vi.fn(),
   seekToPercent: vi.fn(),
   setPlaybackRate: vi.fn(),
-  toggleMute: vi.fn()
+  toggleMute: vi.fn(),
+  embeddedInWechatMiniProgram: false,
+  returnToWechatMiniProgram: vi.fn(() => Promise.resolve({ status: 'failed' as const, reason: 'bridge-unavailable' as const }))
 }))
 
 const audioState = vi.hoisted(() => ({
@@ -36,6 +39,9 @@ vi.mock('@dcloudio/uni-app', () => ({
   onLoad: (handler: (options?: Record<string, unknown>) => Promise<void>) => {
     mocks.onLoadHandler = handler
   },
+  onBackPress: (handler: () => boolean) => {
+    mocks.onBackPressHandler = handler
+  },
   onHide: (handler: () => void) => {
     mocks.onHideHandler = handler
   },
@@ -74,7 +80,11 @@ vi.mock('@/composables/useGlobalAudioPlayer', () => ({
 }))
 
 vi.mock('@/utils/hostEnvironment', () => ({
-  isEmbeddedInWechatMiniProgram: () => false
+  isEmbeddedInWechatMiniProgram: () => mocks.embeddedInWechatMiniProgram
+}))
+
+vi.mock('@/services/WechatMiniProgramBridgeService', () => ({
+  returnToWechatMiniProgram: () => mocks.returnToWechatMiniProgram()
 }))
 
 import ExhibitDetail from '@/pages/exhibit/detail.vue'
@@ -106,6 +116,7 @@ const exhibit = {
 describe('讲解详情音频优先布局', () => {
   beforeEach(() => {
     mocks.onLoadHandler = null
+    mocks.onBackPressHandler = null
     mocks.onHideHandler = null
     mocks.onUnloadHandler = null
     audioState.currentAudio.value = null
@@ -131,6 +142,9 @@ describe('讲解详情音频优先布局', () => {
       playInfo: { title: exhibit.name }
     })
     mocks.play.mockResolvedValue(undefined)
+    mocks.embeddedInWechatMiniProgram = false
+    mocks.returnToWechatMiniProgram.mockReset()
+    mocks.returnToWechatMiniProgram.mockResolvedValue({ status: 'failed', reason: 'bridge-unavailable' })
     vi.stubGlobal('uni', {
       showToast: vi.fn(),
       navigateBack: vi.fn(),
@@ -375,6 +389,28 @@ describe('讲解详情音频优先布局', () => {
     expect(uni.redirectTo).not.toHaveBeenCalled()
   })
 
+  it('小程序直达讲解详情时返回宿主，不进入 H5 讲解对象列表', async () => {
+    mocks.embeddedInWechatMiniProgram = true
+    mocks.returnToWechatMiniProgram.mockResolvedValue({ status: 'returned' })
+    const wrapper = mount(ExhibitDetail, {
+      global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
+    })
+
+    await mocks.onLoadHandler?.({
+      id: exhibit.id,
+      targetType: 'STOP',
+      targetId: 'stop-1',
+      hallId: 'hall-1',
+      hallName: '恐龙厅'
+    })
+    wrapper.getComponent(GuidePageFrameStub).vm.$emit('back')
+    await flushPromises()
+
+    expect(mocks.returnToWechatMiniProgram).toHaveBeenCalledTimes(1)
+    expect(uni.navigateBack).not.toHaveBeenCalled()
+    expect(uni.redirectTo).not.toHaveBeenCalled()
+  })
+
   it('离开详情页时立即关闭当前讲解播放器', async () => {
     audioState.currentAudio.value = { id: 'audio-1', audioUrl: exhibit.audioUrl }
     audioState.currentSource.value = { targetType: 'STOP', targetId: 'stop-1', lang: 'en-US' }
@@ -407,9 +443,6 @@ describe('讲解详情音频优先布局', () => {
     })
     await flushPromises()
 
-    vi.mocked(uni.navigateBack).mockImplementationOnce((options: any) => {
-      options.fail?.()
-    })
     wrapper.getComponent(GuidePageFrameStub).vm.$emit('back')
     await flushPromises()
 
@@ -418,6 +451,6 @@ describe('讲解详情音频优先布局', () => {
     expect(url.split('?')[0]).toBe('/pages/explain/guide-stop-list')
     expect(params.get('hallId')).toBe('hall-1')
     expect(params.get('hallName')).toBe('恐龙厅')
-    expect(uni.navigateBack).toHaveBeenCalledWith(expect.objectContaining({ delta: 1 }))
+    expect(uni.navigateBack).not.toHaveBeenCalled()
   })
 })