Files
cms-website/themes/pilot-minimal/test/load-data.test.ts
T
浅念 1cd309d56d feat(theme): pilot-minimal 骨架与布局组件
Plan 4 Task 3:
- themes/pilot-minimal 入 workspace(astro ^5.18 纯静态;依赖仅 astro)
- theme.manifest:contracts isThemeManifest 守卫通过——key=pilot-minimal/
  七模板条目(home/page/product-list/product-detail/news-list/news-detail/
  not-found);brand 刻意不入 requiredSiteConfig(恒可能 {},Task 1 移交契约)
- load-render-data:全主题唯一取数入口(五禁纪律结构保证,JSDoc 钉死)——
  SF_BUILD_INPUT 六文件、缺文件/形状破裂明确错误不静默空、同目录缓存单例、
  name 空→'Untitled Site'/brand 缺席→{}、编码 slug 原样贯穿(源码令牌扫描
  禁 percent-decode)
- 布局/组件:BaseLayout/SeoHead(title/desc/canonical/og)/SiteHeader(导航
  路由缺席容忍隐藏)/SiteFooter/RichText(信任链:清洗+重写后直出)/
  ResponsiveMedia/Breadcrumbs/ProductCard/NewsCard/Pagination(V1 禁用态)/
  NotFound + tokens.css(75rem/系统字体/4-8-16-24-48/中性色+单 accent)
- 根 test 链并入主题(vitest 3 + astro getViteConfig,Container API 组件
  渲染测试);typecheck 四段变五段;.astro/ 入 gitignore

354 根测试 + 16 主题测试全绿。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-22 08:38:00 +08:00

138 lines
5.5 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Task 3 用例 2/4:load-render-data 对六文件夹具的加载形状、缺文件明错、name 兜底、
// 缓存单例、编码 slug 原样贯穿(前置事实 7——不得 decodeURIComponent)。
import { cpSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { fileURLToPath } from 'node:url'
import { afterEach, describe, expect, it } from 'vitest'
import { loadRenderData, resetRenderDataCache } from '../src/lib/load-render-data.js'
const FIXTURE = fileURLToPath(new URL('./fixtures/render-input', import.meta.url))
const LOADER_SRC = fileURLToPath(new URL('../src/lib/load-render-data.ts', import.meta.url))
const PREV_ENV = process.env.SF_BUILD_INPUT
afterEach(() => {
resetRenderDataCache()
if (PREV_ENV === undefined) delete process.env.SF_BUILD_INPUT
else process.env.SF_BUILD_INPUT = PREV_ENV
})
/** 具夹目录的临时副本(变体测试可随意改写,用后即删) */
function tempCopy(name: string): string {
const dir = mkdtempSync(join(tmpdir(), `sf-theme-${name}-`))
cpSync(FIXTURE, dir, { recursive: true })
return dir
}
describe('load-render-data(渲染数据唯一入口)', () => {
it('六文件具夹 → 返回形状:site/contents/taxonomies/routes/assets Map/renderManifest', () => {
const data = loadRenderData(FIXTURE)
// 占位 name(siteKey 派生)原样贯穿——兜底只对空值生效
expect(data.site.name).toBe('demo-site')
expect(data.site.origin).toBe('https://demo.example')
expect(data.site.locale).toBe('zh-CN')
expect(data.site.brand).toStrictEqual({})
expect(data.contents).toHaveLength(3)
const news = data.contents.find((c) => c.slug === 'fixture-news-a')
expect(news?.typeKey).toBe('news_article')
expect(news?.data.bodyHtml).toContain('src="/wp-content/uploads/2026/10/fixture-a.png"')
expect(news?.media?.featured).toBe('/wp-content/uploads/2026/10/fixture-a.png')
expect(data.taxonomies[0]).toMatchObject({ key: 'product-category', objectType: 'product' })
expect(data.taxonomies[0]?.terms[0]?.contentEntryIds).toHaveLength(1)
const redirect = data.routes.find((r) => r.routeKind === 'redirect')
expect(redirect).toMatchObject({
routePath: '/old-path/',
redirectStatus: 301,
redirectLocation: '/',
indexable: false,
})
expect(data.assets.size).toBe(1)
expect(data.assets.get('/wp-content/uploads/2026/10/fixture-a.png')).toMatchObject({
detectedMimeType: 'image/png',
byteSize: 1234,
width: 100,
height: 80,
altText: null,
})
expect(data.renderManifest.counts).toStrictEqual({ contents: 3, taxonomies: 1, routes: 7, assets: 1 })
expect(data.renderManifest.renderSnapshotVersion).toBe(1)
})
it("site.name 空 → 'Untitled Site';brand 键缺席 → {}(Task 1 审查移交:缺省容忍)", () => {
const dir = tempCopy('name')
try {
writeFileSync(
join(dir, 'site.json'),
JSON.stringify({ name: '', origin: 'https://demo.example', locale: 'zh-CN' }),
)
const data = loadRenderData(dir)
expect(data.site.name).toBe('Untitled Site')
expect(data.site.brand).toStrictEqual({})
} finally {
rmSync(dir, { recursive: true, force: true })
}
})
it('缺文件 → 明确错误(不静默空)', () => {
const dir = tempCopy('missing')
try {
rmSync(join(dir, 'routes.json'))
expect(() => loadRenderData(dir)).toThrow(/routes\.json/)
expect(() => loadRenderData(dir)).toThrow(/缺失|不完整/)
} finally {
rmSync(dir, { recursive: true, force: true })
}
})
it('SF_BUILD_INPUT 未设置且未传目录 → 明确错误', () => {
delete process.env.SF_BUILD_INPUT
expect(() => loadRenderData()).toThrow(/SF_BUILD_INPUT/)
})
it('缺省读 SF_BUILD_INPUT 环境变量目录', () => {
process.env.SF_BUILD_INPUT = FIXTURE
expect(loadRenderData().site.name).toBe('demo-site')
})
it('缓存单例:同目录多次调用只读一次盘(引用同一 + 落盘变化不可见)', () => {
const dir = tempCopy('cache')
try {
const first = loadRenderData(dir)
writeFileSync(
join(dir, 'site.json'),
JSON.stringify({ name: 'changed-after-load', origin: 'https://demo.example', locale: 'zh-CN', brand: {} }),
)
const second = loadRenderData(dir)
expect(second).toBe(first)
expect(second.site.name).toBe('demo-site') // 未重读盘
} finally {
rmSync(dir, { recursive: true, force: true })
}
})
it('编码 slug 原样贯穿:字节不变、路由编码路径原样(前置事实 7)', () => {
const data = loadRenderData(FIXTURE)
const page = data.contents.find((c) => c.typeKey === 'basic_page')
expect(page?.slug).toBe('%e5%85%b3%e4%ba%8e%e6%88%91%e4%bb%ac')
expect(decodeURIComponent(page!.slug)).not.toBe(page!.slug) // 夹具确为编码形态
expect(data.routes.some((r) => r.routePath === '/%e5%85%b3%e4%ba%8e%e6%88%91%e4%bb%ac/')).toBe(true)
// 结构保证:loader 源码不得引入 decodeURIComponent
expect(readFileSync(LOADER_SRC, 'utf8')).not.toContain('decodeURIComponent')
})
it('content.json 顶层非数组 → 明确错误(不静默空)', () => {
const dir = tempCopy('shape')
try {
writeFileSync(join(dir, 'content.json'), JSON.stringify({ oops: true }))
expect(() => loadRenderData(dir)).toThrow(/content\.json/)
} finally {
rmSync(dir, { recursive: true, force: true })
}
})
})