import assert from "node:assert/strict"; import { describe, it } from "node:test"; import { announcementPath, commentAnchor, entityPath, leaderboardPath, libraryDocPath, libraryDocReadPath, libraryPath, matchPrettyPath, matchStandardPath, normalizeUrlStyle, pagePath, parseEntityPath, postPath, userPath, } from "./urlStyle.ts"; describe("normalizeUrlStyle", () => { it("合法值与容错", () => { assert.equal(normalizeUrlStyle("default"), "default"); assert.equal(normalizeUrlStyle(" HTML "), "html"); assert.equal(normalizeUrlStyle("DISCUZ"), "discuz"); assert.equal(normalizeUrlStyle("pretty"), "default"); assert.equal(normalizeUrlStyle(undefined), "default"); assert.equal(normalizeUrlStyle(42), "default"); }); }); describe("路径构造器", () => { it("三风格帖子路径", () => { assert.equal(postPath("default", 123), "/post/123"); assert.equal(postPath("html", 123), "/post-123.html"); assert.equal(postPath("discuz", 123), "/thread-123.html"); }); it("三风格用户路径", () => { assert.equal(userPath("default", 5), "/u/5"); assert.equal(userPath("html", 5), "/user-5.html"); assert.equal(userPath("discuz", 5), "/space-uid-5.html"); }); it("三风格公告路径", () => { assert.equal(announcementPath("default", 1), "/announcement/1"); assert.equal(announcementPath("html", 1), "/announcement-1.html"); assert.equal(announcementPath("discuz", 1), "/notice-1.html"); }); it("非法 id 返回空串", () => { assert.equal(postPath("default", 0), ""); assert.equal(postPath("html", -1), ""); assert.equal(userPath("discuz", Number.NaN), ""); }); it("自建页三风格并编码 slug", () => { assert.equal(pagePath("default", "about"), "/p/about"); assert.equal(pagePath("html", "about"), "/p-about.html"); assert.equal(pagePath("discuz", "使用指南"), `/page-${encodeURIComponent("使用指南")}.html`); assert.equal(pagePath("html", "使用指南"), `/p-${encodeURIComponent("使用指南")}.html`); assert.equal(pagePath("default", " "), "/p/"); }); it("排行榜三风格", () => { assert.equal(leaderboardPath("default"), "/leaderboard"); assert.equal(leaderboardPath("html"), "/leaderboard.html"); assert.equal(leaderboardPath("discuz"), "/rank.html"); }); it("书库三风格(html/discuz 同模板;章节 = 详情路径 + ?sec=)", () => { assert.equal(libraryPath("default"), "/library"); assert.equal(libraryPath("html"), "/library.html"); assert.equal(libraryPath("discuz"), "/library.html"); assert.equal(libraryDocPath("default", "abc"), "/library/abc"); assert.equal(libraryDocPath("html", "abc"), "/library-abc.html"); assert.equal(libraryDocPath("discuz", "abc"), "/library-abc.html"); assert.equal( libraryDocPath("html", "使用指南"), `/library-${encodeURIComponent("使用指南")}.html` ); assert.equal(libraryDocPath("default", " "), "/library"); assert.equal(libraryDocPath("html", " "), "/library.html"); // 阅读页:chapterNo 为书内章序号(1 起),缺省表示第一章 assert.equal(libraryDocReadPath("default", "abc"), "/library/abc/read"); assert.equal(libraryDocReadPath("default", "abc", 5), "/library/abc/read?c=5"); assert.equal(libraryDocReadPath("html", "abc"), "/library-abc.html?sec=1"); assert.equal(libraryDocReadPath("discuz", "abc", 5), "/library-abc.html?sec=5"); assert.equal( libraryDocReadPath("html", "使用指南", 2), `/library-${encodeURIComponent("使用指南")}.html?sec=2` ); }); it("entityPath 与标准路径", () => { assert.equal(entityPath("discuz", "post", 9), "/thread-9.html"); assert.equal(entityPath("default", "user", 9), "/u/9"); assert.equal(entityPath("html", "announcement", 9), "/announcement-9.html"); }); it("评论锚点使用帖内相对楼层号", () => { assert.equal(commentAnchor(1, true, 147), "#comment-1"); assert.equal(commentAnchor(3, false, 147), "#comment-3-r147"); // 楼中楼缺评论 id 时退化为楼层锚点 assert.equal(commentAnchor(3, false), "#comment-3"); // 楼层无效(评论已不可见)返回空串,由调用方回落纯帖子路径 assert.equal(commentAnchor(0, true, 147), ""); assert.equal(commentAnchor(Number.NaN, false, 147), ""); }); }); describe("matchPrettyPath", () => { it("命中各风格模板", () => { assert.deepEqual(matchPrettyPath("/post-12.html"), { style: "html", kind: "post", id: 12 }); assert.deepEqual(matchPrettyPath("/user-3.html"), { style: "html", kind: "user", id: 3 }); assert.deepEqual(matchPrettyPath("/announcement-7.html"), { style: "html", kind: "announcement", id: 7 }); assert.deepEqual(matchPrettyPath("/thread-12.html"), { style: "discuz", kind: "post", id: 12 }); assert.deepEqual(matchPrettyPath("/space-uid-3.html"), { style: "discuz", kind: "user", id: 3 }); assert.deepEqual(matchPrettyPath("/notice-7.html"), { style: "discuz", kind: "announcement", id: 7 }); assert.deepEqual(matchPrettyPath("/p-about.html"), { style: "html", kind: "page", slug: "about" }); assert.deepEqual(matchPrettyPath("/leaderboard.html"), { style: "html", kind: "leaderboard" }); assert.deepEqual(matchPrettyPath("/rank.html"), { style: "discuz", kind: "leaderboard" }); }); it("书库两风格同模板:prefer 优先当前风格,缺省首条兜底", () => { assert.equal(matchPrettyPath("/library.html", "html")?.style, "html"); assert.equal(matchPrettyPath("/library.html", "discuz")?.style, "discuz"); assert.equal(matchPrettyPath("/library.html")?.style, "html"); assert.deepEqual(matchPrettyPath("/library-x.html", "discuz"), { style: "discuz", kind: "libraryDoc", slug: "x", }); assert.deepEqual(matchPrettyPath("/library-x.html"), { style: "html", kind: "libraryDoc", slug: "x" }); }); it("旧版章节伪静态 -read-{n} 仍可解析(不再生成)", () => { assert.deepEqual(matchPrettyPath("/library-x-read-2.html", "discuz"), { style: "discuz", kind: "libraryRead", slug: "x", id: 2, }); assert.deepEqual(matchPrettyPath("/library-x-read-2.html"), { style: "html", kind: "libraryRead", slug: "x", id: 2, }); // 详情模板不再吞掉 -read-{n};纯详情仍命中 libraryDoc assert.deepEqual(matchPrettyPath("/library-x.html"), { style: "html", kind: "libraryDoc", slug: "x" }); assert.equal(matchPrettyPath("/library-x-read-2.htmlx"), null); assert.equal(matchPrettyPath("/library-x-read-2.html/edit"), null); }); it("书库 pretty 排除子路径与伪造路径", () => { assert.equal(matchPrettyPath("/library-x.htmlx"), null); assert.equal(matchPrettyPath("/library-x.html/edit"), null); assert.equal(matchPrettyPath("/library-.html"), null); assert.equal(matchPrettyPath("/library.html/x"), null); }); it("page slug 保持 encoded 原样", () => { const enc = encodeURIComponent("使用指南"); assert.deepEqual(matchPrettyPath(`/page-${enc}.html`), { style: "discuz", kind: "page", slug: enc }); assert.deepEqual(matchPrettyPath(`/p-${enc}.html`), { style: "html", kind: "page", slug: enc }); }); it("排除子路径与伪造路径", () => { assert.equal(matchPrettyPath("/post/12"), null); assert.equal(matchPrettyPath("/post/12/edit"), null); assert.equal(matchPrettyPath("/post-abc.html"), null); assert.equal(matchPrettyPath("/thread-12.htmlx"), null); assert.equal(matchPrettyPath("/thread-12.html/edit"), null); assert.equal(matchPrettyPath("/thread--12.html"), null); assert.equal(matchPrettyPath("/post.html"), null); assert.equal(matchPrettyPath("/p-.html"), null); assert.equal(matchPrettyPath("/leaderboardx.html"), null); assert.equal(matchPrettyPath("/rank.htmlx"), null); assert.equal(matchPrettyPath("/rank"), null); }); }); describe("matchStandardPath / parseEntityPath", () => { it("标准路径精确匹配", () => { assert.deepEqual(matchStandardPath("/post/12"), { kind: "post", id: 12 }); assert.deepEqual(matchStandardPath("/u/5"), { kind: "user", id: 5 }); assert.deepEqual(matchStandardPath("/announcement/7"), { kind: "announcement", id: 7 }); assert.deepEqual(matchStandardPath("/p/about"), { kind: "page", slug: "about" }); assert.deepEqual(matchStandardPath("/leaderboard"), { kind: "leaderboard" }); assert.deepEqual(matchStandardPath("/leaderboard/"), { kind: "leaderboard" }); assert.deepEqual(matchStandardPath("/library"), { kind: "library" }); assert.deepEqual(matchStandardPath("/library/"), { kind: "library" }); assert.deepEqual(matchStandardPath("/library/abc"), { kind: "libraryDoc", slug: "abc" }); assert.equal(matchStandardPath("/post/12/edit"), null); assert.equal(matchStandardPath("/post/abc"), null); assert.equal(matchStandardPath("/u/5/followers"), null); assert.equal(matchStandardPath("/p/"), null); assert.equal(matchStandardPath("/p/a/b"), null); // 读页单独识别(?c= 走 query),不得被详情模式误伤 assert.deepEqual(matchStandardPath("/library/abc/read"), { kind: "libraryRead", slug: "abc" }); assert.equal(matchStandardPath("/library/a/b"), null); assert.equal(matchStandardPath("/libraryx"), null); }); it("parseEntityPath 兼容标准与全部模板", () => { assert.deepEqual(parseEntityPath("/post/12"), { kind: "post", id: 12 }); assert.deepEqual(parseEntityPath("/thread-12.html"), { kind: "post", id: 12 }); assert.deepEqual(parseEntityPath("/post-12.html"), { kind: "post", id: 12 }); assert.deepEqual(parseEntityPath("/space-uid-5.html"), { kind: "user", id: 5 }); assert.deepEqual(parseEntityPath("/p/about"), { kind: "page", slug: "about" }); assert.deepEqual(parseEntityPath("/p-about.html"), { kind: "page", slug: "about" }); assert.deepEqual(parseEntityPath(`/page-${encodeURIComponent("使用指南")}.html`), { kind: "page", slug: "使用指南", }); assert.deepEqual(parseEntityPath("/rank.html"), { kind: "leaderboard" }); assert.equal(parseEntityPath("/chat/5"), null); assert.equal(parseEntityPath("/"), null); }); it("parseEntityPath 兼容书库路径并解码 slug", () => { const enc = encodeURIComponent("三体"); assert.deepEqual(parseEntityPath(`/library/${enc}`), { kind: "libraryDoc", slug: "三体" }); assert.deepEqual(parseEntityPath(`/library-${enc}.html`), { kind: "libraryDoc", slug: "三体" }); assert.deepEqual(parseEntityPath("/library.html"), { kind: "library" }); assert.deepEqual(parseEntityPath("/library/abc/read"), { kind: "libraryRead", slug: "abc" }); assert.deepEqual(parseEntityPath("/library-abc-read-2.html"), { kind: "libraryRead", slug: "abc" }); }); });