Files
summercms/admin/tests/shell/AppShell.test.ts
Jakub Zych 9f5e807af6 test(16.2-06): admin SPA coverage of plugin field types and View site
- fieldTypes: one load per script URL, failed and refused scripts
  reported, global styles enabled on every screen, empty list on failure
- registry, formState, FormField and ListView: plugin renderers, locale
  maps, notices as literal text, unknown column types as text
- AppShell: the View site link's href, target, rel and en/pl label
2026-10-10 16:03:07 +02:00

120 lines
4.7 KiB
TypeScript

import { readFileSync } from 'node:fs'
import { resolve } from 'node:path'
import { afterEach, beforeEach, describe, expect, it } from 'vitest'
import { enableAutoUnmount, flushPromises, mount } from '@vue/test-utils'
import AppShell from '../../src/components/shell/AppShell.vue'
import { setNavigation } from '../../src/state/useNavigation'
import { NARROW_QUERY, setCollapsed } from '../../src/state/useSidebar'
import { showToast } from '../../src/state/useToasts'
import { navigationFixture } from '../fixtures/typed'
import { setBundle } from '../../src/app/i18n'
import { fakeMedia, resetState, routerAt, signIn } from '../helpers'
import { langFixture } from '../fixtures/typed'
async function mountShell(path: string) {
await signIn()
setNavigation(navigationFixture.data)
const router = await routerAt(path)
const wrapper = mount(AppShell, {
slots: { default: '<p data-page>content</p>' },
global: { plugins: [router] },
attachTo: document.body,
})
await flushPromises()
return wrapper
}
beforeEach(() => {
resetState()
setCollapsed(false)
})
afterEach(() => {
setCollapsed(false)
document.body.innerHTML = ''
})
enableAutoUnmount(afterEach)
describe('app shell', () => {
it('renders rail, section panel, header landmarks and the page in main', async () => {
const wrapper = await mountShell('/acme/demo/widgets')
expect(wrapper.find('nav[aria-label="Wtyczki"]').exists()).toBe(true)
expect(wrapper.find('aside[aria-label="Sekcje"]').exists()).toBe(true)
expect(wrapper.find('header nav[aria-label="Ścieżka nawigacji"]').exists()).toBe(true)
expect(wrapper.find('header [data-user-menu]').exists()).toBe(true)
expect(wrapper.find('main [data-page]').text()).toBe('content')
})
it('has no section panel outside a permitted plugin', async () => {
const wrapper = await mountShell('/settings')
expect(wrapper.find('aside').exists()).toBe(false)
})
it('hides the section panel when collapsed by the admin or by the viewport', async () => {
const wrapper = await mountShell('/acme/demo/widgets')
setCollapsed(true)
await flushPromises()
expect(wrapper.find('aside').exists()).toBe(false)
setCollapsed(false)
await flushPromises()
expect(wrapper.find('aside').exists()).toBe(true)
})
it('follows the viewport while mounted and stops listening on unmount', async () => {
const media = fakeMedia({ [NARROW_QUERY]: false })
const wrapper = await mountShell('/acme/demo/widgets')
expect(media.listeners(NARROW_QUERY)).toBe(1)
media.change(NARROW_QUERY, true)
await flushPromises()
expect(wrapper.find('aside').exists()).toBe(false)
wrapper.unmount()
expect(media.listeners(NARROW_QUERY)).toBe(0)
})
it('mounts the toast queue with status and alert roles', async () => {
const wrapper = await mountShell('/acme/demo/widgets')
showToast('Saved')
showToast('Broken', 'danger')
await flushPromises()
expect(wrapper.find('[role="status"]').text()).toContain('Saved')
expect(wrapper.find('[role="alert"]').text()).toContain('Broken')
})
})
describe('View site link (Phase 16.2 quick follow-up)', () => {
it('opens the site root in a new tab without an opener or referrer', async () => {
const wrapper = await mountShell('/acme/demo/widgets')
const link = wrapper.find('header a[data-view-site]')
expect(link.exists()).toBe(true)
expect(link.attributes('href')).toBe(`${window.location.origin}/`)
expect(link.attributes('target')).toBe('_blank')
expect(link.attributes('rel')?.split(' ').sort()).toEqual(['noopener', 'noreferrer'])
// It sits next to the user menu, inside the header.
expect(link.element.nextElementSibling?.matches('[data-user-menu], :has([data-user-menu])')).toBe(true)
expect(link.find('svg').attributes('aria-hidden')).toBe('true')
})
it.each([
['pl', 'Zobacz stronę'],
['en', 'View site'],
])('labels the link from the phrasebook in %s', async (locale, label) => {
setBundle({ ...langFixture.data, 'backend::lang.nav.view_site': { other: label } }, locale)
const wrapper = await mountShell('/acme/demo/widgets')
const link = wrapper.find('a[data-view-site]')
expect(link.attributes('aria-label')).toBe(label)
expect(link.attributes('title')).toBe(label)
})
it('has the label key in the backend phrasebook for en and pl', () => {
for (const [locale, label] of [
['en', 'View site'],
['pl', 'Zobacz stronę'],
]) {
// vitest runs from the admin directory.
const yaml = readFileSync(resolve(process.cwd(), '../modules/phrasebook/backend/lang', locale!, 'lang.yaml'), 'utf8')
expect(yaml).toMatch(new RegExp(`^nav:[\\s\\S]*?^ view_site: ${label}$`, 'm'))
}
})
})