Files
frontend-miniapp/tests/unit/ThirdPartyMapSearchService.spec.ts
lyf f9fefa11ef
Some checks failed
CI / verify (push) Has been cancelled
修复小程序内来馆地图导航
2026-07-11 17:24:45 +08:00

232 lines
7.4 KiB
TypeScript

import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
vi.mock('@/utils/hostEnvironment', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/utils/hostEnvironment')>()
return {
...actual,
isNativeWechatMiniProgram: () => false
}
})
import {
buildThirdPartyMapSearchUri,
openWechatMiniProgramLocation
} from '@/services/ThirdPartyMapSearchService'
const target = {
latitude: 22.604321,
longitude: 114.058765,
name: '深圳自然博物馆',
address: '深圳市龙华区民治街道'
}
const createWindow = (overrides: Record<string, unknown> = {}) => ({
location: { search: '', hash: '' },
navigator: { userAgent: 'Mozilla/5.0 MicroMessenger/8.0.50' },
...overrides
})
beforeEach(() => {
vi.useFakeTimers()
vi.stubGlobal('document', undefined)
})
afterEach(() => {
vi.useRealTimers()
vi.unstubAllGlobals()
})
describe('微信小程序 web-view 地图桥接', () => {
it('桥接延迟注入时快速调用两次也只跳转一次', async () => {
const navigateTo = vi.fn((options: { success?: () => void }) => options.success?.())
const testWindow = createWindow()
vi.stubGlobal('window', testWindow)
vi.stubGlobal('uni', { showToast: vi.fn() })
setTimeout(() => {
Object.assign(testWindow, {
__wxjs_environment: 'miniprogram',
wx: { miniProgram: { navigateTo } }
})
}, 100)
const first = openWechatMiniProgramLocation(target)
const second = openWechatMiniProgramLocation(target)
await vi.advanceTimersByTimeAsync(150)
await expect(first).resolves.toEqual({ status: 'opened' })
await expect(second).resolves.toEqual({ status: 'opened' })
expect(navigateTo).toHaveBeenCalledTimes(1)
const url = navigateTo.mock.calls[0]?.[0].url
const params = new URLSearchParams(url.split('?')[1])
expect(Object.fromEntries(params)).toEqual({
latitude: String(target.latitude),
longitude: String(target.longitude),
name: target.name,
address: target.address
})
})
it('普通浏览器返回 H5 分支并保留第三方地图 URI', async () => {
const showToast = vi.fn()
vi.stubGlobal('window', createWindow({
navigator: { userAgent: 'Mozilla/5.0 Chrome/126.0' }
}))
vi.stubGlobal('uni', { showToast })
await expect(openWechatMiniProgramLocation(target)).resolves.toEqual({ status: 'not-embedded' })
expect(showToast).not.toHaveBeenCalled()
expect(buildThirdPartyMapSearchUri('amap', {
keyword: '深圳自然博物馆',
region: '深圳市'
})).toContain('https://uri.amap.com/search?')
})
it('显式宿主环境缺少桥接时显示错误提示', async () => {
const showToast = vi.fn()
vi.stubGlobal('window', createWindow({
location: { search: '?embedded=weapp', hash: '' }
}))
vi.stubGlobal('uni', { showToast })
const result = openWechatMiniProgramLocation(target)
await vi.advanceTimersByTimeAsync(2600)
await expect(result).resolves.toEqual({ status: 'failed', reason: 'bridge-unavailable' })
expect(showToast).toHaveBeenCalledWith({
title: '小程序地图桥接加载失败',
icon: 'none'
})
})
it('微信 SDK 首次加载失败后再次点击会重新创建脚本', async () => {
const showToast = vi.fn()
let currentScript: Record<string, unknown> | null = null
const appendChild = vi.fn((script: Record<string, unknown>) => {
currentScript = script
setTimeout(() => (script.onerror as (() => void) | undefined)?.(), 0)
})
vi.stubGlobal('window', createWindow({
location: { search: '?embedded=weapp', hash: '' }
}))
vi.stubGlobal('document', {
querySelector: () => currentScript,
createElement: () => {
const script: Record<string, unknown> = { dataset: {} }
script.remove = () => {
if (currentScript === script) currentScript = null
}
return script
},
head: { appendChild }
})
vi.stubGlobal('uni', { showToast })
const first = openWechatMiniProgramLocation(target)
await vi.advanceTimersByTimeAsync(2600)
await expect(first).resolves.toEqual({ status: 'failed', reason: 'bridge-unavailable' })
const second = openWechatMiniProgramLocation(target)
await vi.advanceTimersByTimeAsync(2600)
await expect(second).resolves.toEqual({ status: 'failed', reason: 'bridge-unavailable' })
expect(appendChild).toHaveBeenCalledTimes(2)
})
it('宿主页跳转失败时给出缺页提示', async () => {
const showToast = vi.fn()
const navigateTo = vi.fn((options: { fail?: (error: unknown) => void }) => {
options.fail?.({ errMsg: 'navigateTo:fail page not found' })
})
vi.stubGlobal('window', createWindow({
location: { search: '?embedded=weapp', hash: '' },
wx: { miniProgram: { navigateTo } }
}))
vi.stubGlobal('uni', { showToast })
await expect(openWechatMiniProgramLocation(target)).resolves.toEqual({
status: 'failed',
reason: 'navigation-failed'
})
expect(showToast).toHaveBeenCalledWith({
title: '宿主小程序未配置地图页',
icon: 'none'
})
})
it('宿主页没有回调时超时返回并显示提示', async () => {
const showToast = vi.fn()
let navigateOptions: { fail?: (error: unknown) => void } | undefined
vi.stubGlobal('window', createWindow({
location: { search: '?embedded=weapp', hash: '' },
wx: {
miniProgram: {
navigateTo: vi.fn((options: { fail?: (error: unknown) => void }) => {
navigateOptions = options
})
}
}
}))
vi.stubGlobal('uni', { showToast })
const result = openWechatMiniProgramLocation(target)
await vi.advanceTimersByTimeAsync(3100)
await expect(result).resolves.toEqual({ status: 'failed', reason: 'navigation-failed' })
expect(showToast).toHaveBeenCalledWith({
title: '宿主地图页响应超时',
icon: 'none'
})
navigateOptions?.fail?.({ errMsg: 'navigateTo:fail page not found' })
expect(showToast).toHaveBeenCalledTimes(1)
})
it('非缺页类宿主跳转失败使用通用提示', async () => {
const showToast = vi.fn()
vi.stubGlobal('window', createWindow({
location: { search: '?embedded=weapp', hash: '' },
wx: {
miniProgram: {
navigateTo: vi.fn((options: { fail?: (error: unknown) => void }) => {
options.fail?.({ errMsg: 'navigateTo:fail page stack full' })
})
}
}
}))
vi.stubGlobal('uni', { showToast })
await expect(openWechatMiniProgramLocation(target)).resolves.toEqual({
status: 'failed',
reason: 'navigation-failed'
})
expect(showToast).toHaveBeenCalledWith({
title: '宿主地图页跳转失败',
icon: 'none'
})
})
it('宿主桥接同步抛错时显示调用失败提示', async () => {
const showToast = vi.fn()
vi.stubGlobal('window', createWindow({
location: { search: '?embedded=weapp', hash: '' },
wx: {
miniProgram: {
navigateTo: vi.fn(() => {
throw new Error('bridge unavailable')
})
}
}
}))
vi.stubGlobal('uni', { showToast })
await expect(openWechatMiniProgramLocation(target)).resolves.toEqual({
status: 'failed',
reason: 'navigation-failed'
})
expect(showToast).toHaveBeenCalledWith({
title: '宿主地图桥接调用失败',
icon: 'none'
})
})
})