mirror of
https://github.com/cloudflare/vinext.git
synced 2026-09-14 19:04:59 +08:00
0d8d3e3c60
* refactor(router): quarantine navigation runtime topology * fix(router): restore manifest-backed interception runtime App Router browser navigations lost first-hop intercepted route context after snapshot topology stopped acting as fallback proof. That made /feed to /photos/:id request the direct page payload instead of the declared modal payload. The violated invariant was that route topology must come from the manifest, while snapshots only carry runtime proof. Resolve first-hop interception from the manifest, move RSC bootstrap streams onto the symbol-backed runtime, teach prerender extraction that script shape, and harden the runtime contract around route manifest and RSC data. Coverage includes runtime seam tests, prerender extraction tests, planner/browser navigation tests, package rebuild, and the app-router intercepted routes E2E slice. * fix(router): narrow prerender RSC script parsing The prerender extractor accepted any script starting with the symbol-runtime bootstrap expression, then parsed it as though it had the exact RSC chunk-push prefix. That was harmless at the current head, but it made future runtime scripts a foot-gun. Only the exact runtime chunk prefix and exact done marker are now accepted. A focused extractor test covers non-chunk runtime scripts that share the bootstrap expression prefix. * fix(router): address navigation runtime review * fix(router): resolve navigation runtime review threads
1370 lines
52 KiB
TypeScript
1370 lines
52 KiB
TypeScript
/**
|
|
* Prerender phase tests.
|
|
*
|
|
* Tests assert the **structural output** of prerendering — which routes were
|
|
* rendered, which were skipped, which errored, and what files were produced.
|
|
* Tests do NOT assert on raw HTML content (that belongs to E2E/Playwright).
|
|
*
|
|
* Both `prerenderPages()` and `prerenderApp()` are tested against the
|
|
* `pages-basic` and `app-basic` fixtures respectively.
|
|
*/
|
|
import { describe, it, expect, beforeAll, afterAll } from "vite-plus/test";
|
|
import fs from "node:fs";
|
|
import { createServer, type Server } from "node:http";
|
|
import os from "node:os";
|
|
import path from "node:path";
|
|
import { buildPagesFixture, buildAppFixture, buildCloudflareAppFixture } from "./helpers.js";
|
|
import {
|
|
extractRscPayloadFromPrerenderedHtml,
|
|
resolveParentParams,
|
|
type PrerenderRouteResult,
|
|
type StaticParamsMap,
|
|
} from "../packages/vinext/src/build/prerender.js";
|
|
import { safeJsonStringify } from "../packages/vinext/src/server/html.js";
|
|
import type { AppRoute } from "../packages/vinext/src/routing/app-router.js";
|
|
|
|
const PAGES_FIXTURE = path.resolve(import.meta.dirname, "./fixtures/pages-basic");
|
|
const APP_FIXTURE = path.resolve(import.meta.dirname, "./fixtures/app-basic");
|
|
const CF_FIXTURE = path.resolve(import.meta.dirname, "./fixtures/cf-app-basic");
|
|
|
|
// ─── Helper ──────────────────────────────────────────────────────────────────
|
|
|
|
function tmpDir(prefix: string): string {
|
|
return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
|
|
}
|
|
|
|
function findRoute(
|
|
results: PrerenderRouteResult[],
|
|
route: string,
|
|
): PrerenderRouteResult | undefined {
|
|
return results.find((r) => r.route === route || ("path" in r && r.path === route));
|
|
}
|
|
|
|
function listen(server: Server): Promise<number> {
|
|
return new Promise((resolve, reject) => {
|
|
server.on("error", reject);
|
|
server.listen(0, "127.0.0.1", () => {
|
|
const address = server.address();
|
|
if (typeof address === "object" && address !== null) {
|
|
resolve(address.port);
|
|
} else {
|
|
reject(new Error("test server did not expose a TCP port"));
|
|
}
|
|
});
|
|
});
|
|
}
|
|
|
|
function closeServer(server: Server): Promise<void> {
|
|
return new Promise((resolve, reject) => {
|
|
server.close((error) => {
|
|
if (error) reject(error);
|
|
else resolve();
|
|
});
|
|
});
|
|
}
|
|
|
|
const RSC_RUNTIME_BOOTSTRAP_EXPRESSION =
|
|
'((self[Symbol.for("vinext.navigationRuntime")]??={bootstrap:{routeManifest:null},functions:{}}).bootstrap.rsc??={rsc:[]})';
|
|
|
|
function runtimeRscChunkScript(chunk: string | [3, string]): string {
|
|
return `<script>${RSC_RUNTIME_BOOTSTRAP_EXPRESSION}.rsc.push(${safeJsonStringify(chunk)})</script>`;
|
|
}
|
|
|
|
function runtimeRscDoneScript(): string {
|
|
return `<script>${RSC_RUNTIME_BOOTSTRAP_EXPRESSION}.done=true</script>`;
|
|
}
|
|
|
|
function legacyRscChunkScript(chunk: string | [3, string]): string {
|
|
return (
|
|
"<script>self.__VINEXT_RSC_CHUNKS__=self.__VINEXT_RSC_CHUNKS__||[];" +
|
|
`self.__VINEXT_RSC_CHUNKS__.push(${safeJsonStringify(chunk)})</script>`
|
|
);
|
|
}
|
|
|
|
function legacyRscDoneScript(): string {
|
|
return "<script>self.__VINEXT_RSC_DONE__=true</script>";
|
|
}
|
|
|
|
// ─── App Router RSC payload extraction ───────────────────────────────────────
|
|
|
|
describe("extractRscPayloadFromPrerenderedHtml", () => {
|
|
function decodeExtractedPayload(html: string): string | null {
|
|
const payload = extractRscPayloadFromPrerenderedHtml(html);
|
|
return payload === null ? null : new TextDecoder().decode(payload);
|
|
}
|
|
|
|
it("reconstructs streamed RSC chunks from inline bootstrap scripts", () => {
|
|
const chunks = [
|
|
'0:D{"name":"layout"}\n',
|
|
'1:["$","div",null,{"children":"hello ) world"}]\n',
|
|
'2:["$","span",null,{"children":"</script><script>alert(1)</script>"}]\n',
|
|
];
|
|
const html =
|
|
"<html><body>" +
|
|
chunks.map((chunk) => runtimeRscChunkScript(chunk)).join("") +
|
|
runtimeRscDoneScript() +
|
|
"</body></html>";
|
|
|
|
expect(decodeExtractedPayload(html)).toBe(chunks.join(""));
|
|
});
|
|
|
|
it("keeps parsing legacy streamed RSC chunk scripts", () => {
|
|
const chunks = ['0:D{"name":"layout"}\n', '1:["$","div",null,{"children":"legacy"}]\n'];
|
|
const html =
|
|
"<html><body>" +
|
|
chunks.map((chunk) => legacyRscChunkScript(chunk)).join("") +
|
|
legacyRscDoneScript() +
|
|
"</body></html>";
|
|
|
|
expect(decodeExtractedPayload(html)).toBe(chunks.join(""));
|
|
});
|
|
|
|
it("reconstructs binary RSC chunks from inline bootstrap scripts", () => {
|
|
// Ported from Next.js: test/e2e/app-dir/binary/rsc-binary.test.ts
|
|
// https://github.com/vercel/next.js/blob/canary/test/e2e/app-dir/binary/rsc-binary.test.ts
|
|
const html =
|
|
"<html><body>" +
|
|
runtimeRscChunkScript("0:text\n") +
|
|
runtimeRscChunkScript([3, "/wABAgM="]) +
|
|
runtimeRscDoneScript() +
|
|
"</body></html>";
|
|
|
|
const payload = extractRscPayloadFromPrerenderedHtml(html);
|
|
|
|
expect(payload).toEqual(
|
|
new Uint8Array([...new TextEncoder().encode("0:text\n"), 255, 0, 1, 2, 3]),
|
|
);
|
|
});
|
|
|
|
it("throws when the done marker is missing", () => {
|
|
const html = "<html><body>" + runtimeRscChunkScript("0:[]\n") + "</body></html>";
|
|
|
|
expect(() => extractRscPayloadFromPrerenderedHtml(html)).toThrow(/missing RSC done marker/);
|
|
});
|
|
|
|
it("does not treat marker-looking RSC payload text as the done control script", () => {
|
|
const html =
|
|
"<html><body>" + runtimeRscChunkScript('0:["__VINEXT_RSC_DONE__=true"]\n') + "</body></html>";
|
|
|
|
expect(() => extractRscPayloadFromPrerenderedHtml(html)).toThrow(/missing RSC done marker/);
|
|
});
|
|
|
|
it("ignores non-chunk runtime scripts that start with the bootstrap expression", () => {
|
|
const html =
|
|
"<html><body>" +
|
|
`<script>${RSC_RUNTIME_BOOTSTRAP_EXPRESSION}.metadata={}</script>` +
|
|
runtimeRscChunkScript("0:[]\n") +
|
|
runtimeRscDoneScript() +
|
|
"</body></html>";
|
|
|
|
expect(decodeExtractedPayload(html)).toBe("0:[]\n");
|
|
});
|
|
|
|
it("rejects chunk scripts with trailing code after the payload push", () => {
|
|
const html =
|
|
"<html><body>" +
|
|
`<script>${RSC_RUNTIME_BOOTSTRAP_EXPRESSION}.rsc.push(${safeJsonStringify("0:[]\n")})alert(1)</script>` +
|
|
runtimeRscDoneScript() +
|
|
"</body></html>";
|
|
|
|
// JSON.parse rejects the slice (which includes the `)` and `alert(1` after
|
|
// the JSON-encoded string), so this is reported as malformed JSON rather
|
|
// than a separate "trailing code" diagnostic.
|
|
expect(() => extractRscPayloadFromPrerenderedHtml(html)).toThrow(
|
|
"[vinext] Malformed prerender RSC embed: invalid chunk JSON",
|
|
);
|
|
});
|
|
|
|
it("rejects chunk scripts with invalid JSON", () => {
|
|
const html =
|
|
"<html><body>" +
|
|
`<script>${RSC_RUNTIME_BOOTSTRAP_EXPRESSION}.rsc.push("\\uZZZZ")</script>` +
|
|
runtimeRscDoneScript() +
|
|
"</body></html>";
|
|
|
|
expect(() => extractRscPayloadFromPrerenderedHtml(html)).toThrow(
|
|
"[vinext] Malformed prerender RSC embed: invalid chunk JSON",
|
|
);
|
|
});
|
|
|
|
it("returns null when no chunk scripts and no done marker are present (middleware short-circuit)", () => {
|
|
// Middleware that returns a custom 200 HTML body bypasses the App Router
|
|
// pipeline entirely — no chunks, no done marker. The driver detects this
|
|
// null and falls back to a second invocation with `RSC: 1`.
|
|
expect(extractRscPayloadFromPrerenderedHtml("<html><body>legacy</body></html>")).toBeNull();
|
|
});
|
|
|
|
it("throws when only the done marker is present without any chunks", () => {
|
|
// Half-emitted embed (done marker but no chunks) is a real bug — partial
|
|
// emission shouldn't fall back silently.
|
|
const html = `<html><body>${runtimeRscDoneScript()}</body></html>`;
|
|
|
|
expect(() => extractRscPayloadFromPrerenderedHtml(html)).toThrow(
|
|
"[vinext] Malformed prerender RSC embed: done marker present without chunk scripts",
|
|
);
|
|
});
|
|
});
|
|
|
|
describe("prerenderApp — RSC extraction", () => {
|
|
it("writes the .rsc file from rendered HTML without a second RSC request", async () => {
|
|
const root = tmpDir("vinext-prerender-rsc-dedupe-");
|
|
const outDir = path.join(root, "out");
|
|
const appDir = path.join(root, "app");
|
|
const pagePath = path.join(appDir, "page.tsx");
|
|
fs.mkdirSync(appDir, { recursive: true });
|
|
fs.writeFileSync(
|
|
pagePath,
|
|
"export const dynamic = 'force-static';\nexport default function Page() { return null; }\n",
|
|
);
|
|
|
|
const rscPayload = '0:["$","div",null,{"children":"from html"}]\n';
|
|
let rscRequestCount = 0;
|
|
const server = createServer((req, res) => {
|
|
if (req.headers.rsc === "1" || req.headers.accept === "text/x-component") {
|
|
rscRequestCount++;
|
|
res.statusCode = 500;
|
|
res.end("unexpected RSC request");
|
|
return;
|
|
}
|
|
|
|
if (req.url === "/__vinext_nonexistent_for_404__") {
|
|
res.statusCode = 404;
|
|
res.end("<html><body>not found</body></html>");
|
|
return;
|
|
}
|
|
|
|
res.setHeader("content-type", "text/html");
|
|
res.end(
|
|
"<html><body>" +
|
|
runtimeRscChunkScript(rscPayload) +
|
|
runtimeRscDoneScript() +
|
|
"</body></html>",
|
|
);
|
|
});
|
|
|
|
const port = await listen(server);
|
|
try {
|
|
const { prerenderApp } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { appRouter } = await import("../packages/vinext/src/routing/app-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
const routes = await appRouter(appDir);
|
|
const config = await resolveNextConfig({});
|
|
|
|
const prerenderResult = await prerenderApp({
|
|
mode: "default",
|
|
rscBundlePath: path.join(root, "dist", "server", "index.js"),
|
|
routes,
|
|
outDir,
|
|
config,
|
|
_prodServer: { server, port },
|
|
});
|
|
|
|
expect(findRoute(prerenderResult.routes, "/")).toMatchObject({
|
|
route: "/",
|
|
status: "rendered",
|
|
});
|
|
expect(fs.readFileSync(path.join(outDir, "index.rsc"), "utf-8")).toBe(rscPayload);
|
|
expect(rscRequestCount).toBe(0);
|
|
} finally {
|
|
await closeServer(server);
|
|
fs.rmSync(root, { recursive: true, force: true });
|
|
}
|
|
});
|
|
|
|
it("falls back to a second RSC: 1 invocation when middleware short-circuits with custom HTML", async () => {
|
|
// Middleware that returns a 200 HTML body bypasses the App Router
|
|
// pipeline — the response contains no embed chunks. The driver must
|
|
// recover by issuing a second invocation with `RSC: 1` and use whatever
|
|
// that returns as the .rsc file.
|
|
const root = tmpDir("vinext-prerender-rsc-fallback-");
|
|
const outDir = path.join(root, "out");
|
|
const appDir = path.join(root, "app");
|
|
const pagePath = path.join(appDir, "page.tsx");
|
|
fs.mkdirSync(appDir, { recursive: true });
|
|
fs.writeFileSync(
|
|
pagePath,
|
|
"export const dynamic = 'force-static';\nexport default function Page() { return null; }\n",
|
|
);
|
|
|
|
const middlewareHtml = "<html><body>middleware short-circuit</body></html>";
|
|
const fallbackRscPayload = '0:["$","div",null,{"children":"from fallback"}]\n';
|
|
let pageRequestCount = 0;
|
|
let rscRequestCount = 0;
|
|
const server = createServer((req, res) => {
|
|
const isRsc = req.headers.rsc === "1" || req.headers.accept === "text/x-component";
|
|
|
|
if (req.url === "/__vinext_nonexistent_for_404__") {
|
|
res.statusCode = 404;
|
|
res.end("<html><body>not found</body></html>");
|
|
return;
|
|
}
|
|
|
|
if (isRsc) {
|
|
rscRequestCount++;
|
|
res.setHeader("content-type", "text/x-component");
|
|
res.end(fallbackRscPayload);
|
|
return;
|
|
}
|
|
|
|
// Page request: middleware short-circuits with plain HTML and no
|
|
// RSC embed chunks — exercising the fallback path.
|
|
pageRequestCount++;
|
|
res.setHeader("content-type", "text/html");
|
|
res.end(middlewareHtml);
|
|
});
|
|
|
|
const port = await listen(server);
|
|
try {
|
|
const { prerenderApp } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { appRouter } = await import("../packages/vinext/src/routing/app-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
const routes = await appRouter(appDir);
|
|
const config = await resolveNextConfig({});
|
|
|
|
const prerenderResult = await prerenderApp({
|
|
mode: "default",
|
|
rscBundlePath: path.join(root, "dist", "server", "index.js"),
|
|
routes,
|
|
outDir,
|
|
config,
|
|
_prodServer: { server, port },
|
|
});
|
|
|
|
expect(findRoute(prerenderResult.routes, "/")).toMatchObject({
|
|
route: "/",
|
|
status: "rendered",
|
|
});
|
|
|
|
// HTML on disk is the middleware response.
|
|
expect(fs.readFileSync(path.join(outDir, "index.html"), "utf-8")).toBe(middlewareHtml);
|
|
// .rsc on disk is the fallback RSC: 1 response.
|
|
expect(fs.readFileSync(path.join(outDir, "index.rsc"), "utf-8")).toBe(fallbackRscPayload);
|
|
|
|
// Exactly one page request and one RSC fallback request per route.
|
|
expect(pageRequestCount).toBe(1);
|
|
expect(rscRequestCount).toBe(1);
|
|
} finally {
|
|
await closeServer(server);
|
|
fs.rmSync(root, { recursive: true, force: true });
|
|
}
|
|
});
|
|
|
|
it("errors without writing .rsc when the middleware short-circuit fallback RSC request fails", async () => {
|
|
const root = tmpDir("vinext-prerender-rsc-fallback-failure-");
|
|
const outDir = path.join(root, "out");
|
|
const appDir = path.join(root, "app");
|
|
const pagePath = path.join(appDir, "page.tsx");
|
|
fs.mkdirSync(appDir, { recursive: true });
|
|
fs.writeFileSync(
|
|
pagePath,
|
|
"export const dynamic = 'force-static';\nexport default function Page() { return null; }\n",
|
|
);
|
|
|
|
const middlewareHtml = "<html><body>middleware short-circuit</body></html>";
|
|
let pageRequestCount = 0;
|
|
let rscRequestCount = 0;
|
|
const server = createServer((req, res) => {
|
|
const isRsc = req.headers.rsc === "1" || req.headers.accept === "text/x-component";
|
|
|
|
if (req.url === "/__vinext_nonexistent_for_404__") {
|
|
res.statusCode = 404;
|
|
res.end("<html><body>not found</body></html>");
|
|
return;
|
|
}
|
|
|
|
if (isRsc) {
|
|
rscRequestCount++;
|
|
res.statusCode = 500;
|
|
res.end("fallback failed");
|
|
return;
|
|
}
|
|
|
|
pageRequestCount++;
|
|
res.setHeader("content-type", "text/html");
|
|
res.end(middlewareHtml);
|
|
});
|
|
|
|
const port = await listen(server);
|
|
try {
|
|
const { prerenderApp } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { appRouter } = await import("../packages/vinext/src/routing/app-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
const routes = await appRouter(appDir);
|
|
const config = await resolveNextConfig({});
|
|
|
|
const prerenderResult = await prerenderApp({
|
|
mode: "default",
|
|
rscBundlePath: path.join(root, "dist", "server", "index.js"),
|
|
routes,
|
|
outDir,
|
|
config,
|
|
_prodServer: { server, port },
|
|
});
|
|
|
|
const route = findRoute(prerenderResult.routes, "/");
|
|
expect(route).toMatchObject({
|
|
route: "/",
|
|
status: "error",
|
|
});
|
|
if (route?.status !== "error") throw new Error("expected route to fail prerender");
|
|
expect(route.error).toContain("[vinext] prerenderApp: RSC fallback returned 500 for /");
|
|
expect(fs.existsSync(path.join(outDir, "index.rsc"))).toBe(false);
|
|
expect(pageRequestCount).toBe(1);
|
|
expect(rscRequestCount).toBe(1);
|
|
} finally {
|
|
await closeServer(server);
|
|
fs.rmSync(root, { recursive: true, force: true });
|
|
}
|
|
});
|
|
});
|
|
|
|
// ─── Pages Router ─────────────────────────────────────────────────────────────
|
|
|
|
describe("prerenderPages — default mode (pages-basic)", () => {
|
|
let outDir: string;
|
|
let results: PrerenderRouteResult[];
|
|
|
|
beforeAll(async () => {
|
|
const pagesBundlePath = await buildPagesFixture(PAGES_FIXTURE);
|
|
outDir = tmpDir("vinext-prerender-pages-");
|
|
|
|
const { prerenderPages } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { pagesRouter, apiRouter } =
|
|
await import("../packages/vinext/src/routing/pages-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
|
|
const pagesDir = path.resolve(PAGES_FIXTURE, "pages");
|
|
const pageRoutes = await pagesRouter(pagesDir);
|
|
const apiRoutes = await apiRouter(pagesDir);
|
|
const config = await resolveNextConfig({});
|
|
|
|
const prerenderResult = await prerenderPages({
|
|
mode: "default",
|
|
pagesBundlePath,
|
|
routes: pageRoutes,
|
|
apiRoutes,
|
|
pagesDir,
|
|
outDir,
|
|
config,
|
|
});
|
|
results = prerenderResult.routes;
|
|
}, 60_000);
|
|
|
|
afterAll(() => {
|
|
fs.rmSync(outDir, { recursive: true, force: true });
|
|
});
|
|
|
|
// ── Static pages ───────────────────────────────────────────────────────────
|
|
|
|
it("renders static index page", () => {
|
|
const r = findRoute(results, "/");
|
|
expect(r).toMatchObject({
|
|
route: "/",
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("index.html");
|
|
}
|
|
});
|
|
|
|
it("renders static about page", () => {
|
|
const r = findRoute(results, "/about");
|
|
expect(r).toMatchObject({ route: "/about", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("about.html");
|
|
}
|
|
});
|
|
|
|
it("renders 404 page", () => {
|
|
const r = findRoute(results, "/404");
|
|
expect(r).toMatchObject({ route: "/404", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("404.html");
|
|
}
|
|
});
|
|
|
|
// ── Dynamic routes with getStaticPaths ────────────────────────────────────
|
|
|
|
it("renders static dynamic routes from getStaticPaths (fallback: false)", () => {
|
|
const slugs = ["hello-world", "getting-started"];
|
|
for (const slug of slugs) {
|
|
const r = findRoute(results, `/blog/${slug}`);
|
|
expect(r).toMatchObject({
|
|
route: "/blog/:slug",
|
|
path: `/blog/${slug}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain(`blog/${slug}.html`);
|
|
}
|
|
}
|
|
});
|
|
|
|
it("renders dynamic routes from getStaticPaths (fallback: 'blocking')", () => {
|
|
const ids = ["1", "2"];
|
|
for (const id of ids) {
|
|
const r = findRoute(results, `/articles/${id}`);
|
|
expect(r).toMatchObject({
|
|
route: "/articles/:id",
|
|
path: `/articles/${id}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
}
|
|
});
|
|
|
|
// Next.js accepts both `paths: Array<{ params }>` and `paths: Array<string>`
|
|
// from getStaticPaths. The string-path variant is documented at
|
|
// https://nextjs.org/docs/pages/api-reference/functions/get-static-paths and
|
|
// implemented in .nextjs-ref/packages/next/src/build/static-paths/pages.ts
|
|
// (the `typeof entry === 'string'` branch around line 89).
|
|
it("renders dynamic routes from getStaticPaths with string paths", () => {
|
|
const slugs = ["hello-world", "another-one"];
|
|
for (const slug of slugs) {
|
|
const r = findRoute(results, `/string-paths/${slug}`);
|
|
expect(r).toMatchObject({
|
|
route: "/string-paths/:slug",
|
|
path: `/string-paths/${slug}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain(`string-paths/${slug}.html`);
|
|
}
|
|
}
|
|
});
|
|
|
|
// Next.js rejects entries with a missing `params` key — see
|
|
// .nextjs-ref/packages/next/src/build/static-paths/pages.ts (around line 169)
|
|
// "A required parameter (X) was not provided as a string received undefined"
|
|
// We must NOT crash the whole prerender phase on this; surface it as a
|
|
// per-route error result, the same shape we use elsewhere.
|
|
it("surfaces missing-params entries as a per-route error (does not crash)", () => {
|
|
const errored = results.find(
|
|
(r) => r.route === "/missing-params/:slug" && r.status === "error",
|
|
);
|
|
expect(errored).toBeDefined();
|
|
if (errored && errored.status === "error") {
|
|
expect(errored.error).toMatch(/missing the `params` key|params is undefined/);
|
|
}
|
|
});
|
|
|
|
// ── ISR page ───────────────────────────────────────────────────────────────
|
|
|
|
it("renders ISR page with correct revalidate interval", () => {
|
|
const r = findRoute(results, "/isr-test");
|
|
expect(r).toMatchObject({ route: "/isr-test", status: "rendered", revalidate: 1 });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("isr-test.html");
|
|
}
|
|
});
|
|
|
|
// ── SSR pages — skipped ────────────────────────────────────────────────────
|
|
|
|
it("skips SSR pages (getServerSideProps) in default mode", () => {
|
|
const ssrRoutes = ["/ssr", "/ssr-headers"];
|
|
for (const route of ssrRoutes) {
|
|
const r = findRoute(results, route);
|
|
expect(r).toMatchObject({ route, status: "skipped", reason: "ssr" });
|
|
}
|
|
});
|
|
|
|
it("skips getServerSideProps dynamic route in default mode", () => {
|
|
// posts/[id] has getServerSideProps — pattern is /posts/:id
|
|
const ssrRoute = results.find(
|
|
(r) =>
|
|
r.status === "skipped" &&
|
|
"reason" in r &&
|
|
r.reason === "ssr" &&
|
|
r.route.startsWith("/posts"),
|
|
);
|
|
expect(ssrRoute).toBeDefined();
|
|
});
|
|
|
|
// ── API routes — always skipped ────────────────────────────────────────────
|
|
|
|
it("skips all API routes", () => {
|
|
const apiResults = results.filter(
|
|
(r) => r.status === "skipped" && "reason" in r && r.reason === "api",
|
|
);
|
|
expect(apiResults.length).toBeGreaterThan(0);
|
|
// hello API is a known API route
|
|
const hello = findRoute(results, "/api/hello");
|
|
expect(hello).toMatchObject({ route: "/api/hello", status: "skipped", reason: "api" });
|
|
});
|
|
|
|
// ── Written files ──────────────────────────────────────────────────────────
|
|
|
|
it("writes HTML files to outDir", () => {
|
|
expect(fs.existsSync(path.join(outDir, "index.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "about.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "isr-test.html"))).toBe(true);
|
|
});
|
|
|
|
// ── vinext-prerender.json ─────────────────────────────────────────────────
|
|
|
|
it("writes vinext-prerender.json with correct structure", () => {
|
|
const indexPath = path.join(outDir, "vinext-prerender.json");
|
|
expect(fs.existsSync(indexPath)).toBe(true);
|
|
|
|
const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
|
|
expect(Array.isArray(index.routes)).toBe(true);
|
|
|
|
// Check a rendered entry
|
|
const home = index.routes.find((r: any) => r.route === "/");
|
|
expect(home).toMatchObject({ route: "/", status: "rendered", revalidate: false });
|
|
// outputFiles not in index (stripped)
|
|
expect(home.outputFiles).toBeUndefined();
|
|
|
|
// Check ISR entry
|
|
const isr = index.routes.find((r: any) => r.route === "/isr-test");
|
|
expect(isr).toMatchObject({ route: "/isr-test", status: "rendered", revalidate: 1 });
|
|
|
|
// Check a skipped entry
|
|
const ssr = index.routes.find((r: any) => r.route === "/ssr");
|
|
expect(ssr).toMatchObject({ route: "/ssr", status: "skipped", reason: "ssr" });
|
|
});
|
|
});
|
|
|
|
describe("prerenderPages — export mode (pages-basic)", () => {
|
|
let outDir: string;
|
|
let results: PrerenderRouteResult[];
|
|
|
|
beforeAll(async () => {
|
|
const pagesBundlePath = await buildPagesFixture(PAGES_FIXTURE);
|
|
outDir = tmpDir("vinext-prerender-pages-export-");
|
|
|
|
const { prerenderPages } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { pagesRouter, apiRouter } =
|
|
await import("../packages/vinext/src/routing/pages-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
|
|
const pagesDir = path.resolve(PAGES_FIXTURE, "pages");
|
|
const pageRoutes = await pagesRouter(pagesDir);
|
|
const apiRoutes = await apiRouter(pagesDir);
|
|
const config = await resolveNextConfig({ output: "export" });
|
|
|
|
const prerenderResult = await prerenderPages({
|
|
mode: "export",
|
|
pagesBundlePath,
|
|
routes: pageRoutes,
|
|
apiRoutes,
|
|
pagesDir,
|
|
outDir,
|
|
config,
|
|
});
|
|
results = prerenderResult.routes;
|
|
}, 60_000);
|
|
|
|
afterAll(() => {
|
|
fs.rmSync(outDir, { recursive: true, force: true });
|
|
});
|
|
|
|
it("renders static and ISR routes (ISR treated as static)", () => {
|
|
expect(findRoute(results, "/")).toMatchObject({ status: "rendered", revalidate: false });
|
|
expect(findRoute(results, "/about")).toMatchObject({ status: "rendered", revalidate: false });
|
|
// ISR route in export mode: revalidate ignored → false
|
|
expect(findRoute(results, "/isr-test")).toMatchObject({
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
});
|
|
|
|
it("errors on SSR pages in export mode", () => {
|
|
const ssr = findRoute(results, "/ssr");
|
|
expect(ssr).toMatchObject({ status: "error" });
|
|
if (ssr?.status === "error") {
|
|
expect(ssr.error).toMatch(/getServerSideProps/);
|
|
}
|
|
});
|
|
|
|
it("includes stack trace in error when enablePrerenderSourceMaps is true", () => {
|
|
// enablePrerenderSourceMaps defaults to true in resolveNextConfig (line 230)
|
|
const errorRoute = findRoute(results, "/error-throw");
|
|
expect(errorRoute).toMatchObject({ status: "error" });
|
|
if (errorRoute?.status === "error") {
|
|
// Verify the error includes a stack trace (multiple lines with "at " frames)
|
|
expect(errorRoute.error).toMatch(/\n\s+at /);
|
|
}
|
|
});
|
|
});
|
|
|
|
// ─── App Router ───────────────────────────────────────────────────────────────
|
|
|
|
describe("prerenderApp — default mode (app-basic)", () => {
|
|
let outDir: string;
|
|
let results: PrerenderRouteResult[];
|
|
|
|
beforeAll(async () => {
|
|
const rscBundlePath = await buildAppFixture(APP_FIXTURE);
|
|
outDir = tmpDir("vinext-prerender-app-");
|
|
|
|
const { prerenderApp } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { appRouter } = await import("../packages/vinext/src/routing/app-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
|
|
const appDir = path.resolve(APP_FIXTURE, "app");
|
|
const routes = await appRouter(appDir);
|
|
const config = await resolveNextConfig({});
|
|
|
|
const prerenderResult = await prerenderApp({
|
|
mode: "default",
|
|
rscBundlePath,
|
|
routes,
|
|
outDir,
|
|
config,
|
|
});
|
|
results = prerenderResult.routes;
|
|
}, 120_000);
|
|
|
|
afterAll(() => {
|
|
fs.rmSync(outDir, { recursive: true, force: true });
|
|
});
|
|
|
|
// ── Static routes with explicit config ────────────────────────────────────
|
|
|
|
it("renders force-static page", () => {
|
|
const r = findRoute(results, "/static-test");
|
|
expect(r).toMatchObject({ route: "/static-test", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("static-test.html");
|
|
expect(r.outputFiles).toContain("static-test.rsc");
|
|
}
|
|
});
|
|
|
|
it("renders revalidate=Infinity page as static", () => {
|
|
const r = findRoute(results, "/revalidate-infinity-test");
|
|
expect(r).toMatchObject({ status: "rendered", revalidate: false });
|
|
});
|
|
|
|
// ── ISR routes ─────────────────────────────────────────────────────────────
|
|
|
|
it("renders ISR page with revalidate=1", () => {
|
|
const r = findRoute(results, "/isr-test");
|
|
expect(r).toMatchObject({ route: "/isr-test", status: "rendered", revalidate: 1 });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("isr-test.html");
|
|
expect(r.outputFiles).toContain("isr-test.rsc");
|
|
}
|
|
});
|
|
|
|
it("renders ISR page with revalidate=60", () => {
|
|
const r = findRoute(results, "/revalidate-test");
|
|
expect(r).toMatchObject({ route: "/revalidate-test", status: "rendered", revalidate: 60 });
|
|
});
|
|
|
|
it("uses the rendered cacheLife expire value for App Router ISR prerender entries", () => {
|
|
const r = findRoute(results, "/prerender-cache-life");
|
|
expect(r).toMatchObject({
|
|
route: "/prerender-cache-life",
|
|
status: "rendered",
|
|
revalidate: 1,
|
|
expire: 3,
|
|
});
|
|
|
|
const indexPath = path.join(outDir, "vinext-prerender.json");
|
|
const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
|
|
const manifestRoute = index.routes.find(
|
|
(route: { route: string }) => route.route === "/prerender-cache-life",
|
|
);
|
|
expect(manifestRoute).toMatchObject({ revalidate: 1, expire: 3 });
|
|
});
|
|
|
|
it("infers App Router ISR prerender metadata from cacheLife without route revalidate", () => {
|
|
const r = findRoute(results, "/prerender-cache-life-only");
|
|
expect(r).toMatchObject({
|
|
route: "/prerender-cache-life-only",
|
|
status: "rendered",
|
|
revalidate: 1,
|
|
expire: 3,
|
|
});
|
|
|
|
const indexPath = path.join(outDir, "vinext-prerender.json");
|
|
const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
|
|
const manifestRoute = index.routes.find(
|
|
(route: { route: string }) => route.route === "/prerender-cache-life-only",
|
|
);
|
|
expect(manifestRoute).toMatchObject({ revalidate: 1, expire: 3 });
|
|
});
|
|
|
|
// ── Dynamic routes — skipped ───────────────────────────────────────────────
|
|
|
|
it("skips force-dynamic page", () => {
|
|
const r = findRoute(results, "/dynamic-test");
|
|
expect(r).toMatchObject({ route: "/dynamic-test", status: "skipped", reason: "dynamic" });
|
|
});
|
|
|
|
it("skips revalidate=0 page", () => {
|
|
const r = findRoute(results, "/revalidate-zero-test");
|
|
expect(r).toMatchObject({ status: "skipped", reason: "dynamic" });
|
|
});
|
|
|
|
// ── Dynamic routes with generateStaticParams ───────────────────────────────
|
|
|
|
it("renders /blog/[slug] expanded paths", () => {
|
|
const slugs = ["hello-world", "getting-started", "advanced-guide"];
|
|
for (const slug of slugs) {
|
|
const r = findRoute(results, `/blog/${slug}`);
|
|
expect(r).toMatchObject({
|
|
route: "/blog/:slug",
|
|
path: `/blog/${slug}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain(`blog/${slug}.html`);
|
|
expect(r.outputFiles).toContain(`blog/${slug}.rsc`);
|
|
}
|
|
}
|
|
});
|
|
|
|
it("renders /products/[id] expanded paths", () => {
|
|
for (const id of ["1", "2", "3"]) {
|
|
const r = findRoute(results, `/products/${id}`);
|
|
expect(r).toMatchObject({
|
|
route: "/products/:id",
|
|
path: `/products/${id}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
}
|
|
});
|
|
|
|
it("renders /shop/[category] expanded paths", () => {
|
|
for (const category of ["electronics", "clothing"]) {
|
|
const r = findRoute(results, `/shop/${category}`);
|
|
expect(r).toMatchObject({
|
|
route: "/shop/:category",
|
|
path: `/shop/${category}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
}
|
|
});
|
|
|
|
it("renders /shop/[category]/[item] top-down params (nested generateStaticParams)", () => {
|
|
const paths = [
|
|
"/shop/electronics/phone",
|
|
"/shop/electronics/laptop",
|
|
"/shop/clothing/shirt",
|
|
"/shop/clothing/pants",
|
|
];
|
|
for (const urlPath of paths) {
|
|
const r = findRoute(results, urlPath);
|
|
expect(r).toMatchObject({
|
|
route: "/shop/:category/:item",
|
|
path: urlPath,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
}
|
|
});
|
|
|
|
it("skips dynamic routes without generateStaticParams", () => {
|
|
// /photos/[id] has no generateStaticParams
|
|
const r = results.find(
|
|
(r) =>
|
|
r.status === "skipped" &&
|
|
"reason" in r &&
|
|
r.reason === "no-static-params" &&
|
|
r.route.startsWith("/photos"),
|
|
);
|
|
expect(r).toBeDefined();
|
|
});
|
|
|
|
// ── Speculative rendering: unknown routes ──────────────────────────────────
|
|
|
|
it("renders / speculatively (unknown route with no dynamic APIs)", () => {
|
|
const r = findRoute(results, "/");
|
|
expect(r).toMatchObject({ route: "/", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("index.html");
|
|
expect(r.outputFiles).toContain("index.rsc");
|
|
}
|
|
});
|
|
|
|
it("renders /about speculatively", () => {
|
|
const r = findRoute(results, "/about");
|
|
expect(r).toMatchObject({ route: "/about", status: "rendered", revalidate: false });
|
|
});
|
|
|
|
it("renders /dashboard speculatively", () => {
|
|
const r = findRoute(results, "/dashboard");
|
|
expect(r).toMatchObject({ route: "/dashboard", status: "rendered", revalidate: false });
|
|
});
|
|
|
|
it("renders layout-only routes whose content comes from parallel slots", () => {
|
|
// Ported from Next.js: test/e2e/app-dir/parallel-routes-and-interception/parallel-routes-and-interception.test.ts
|
|
// https://github.com/vercel/next.js/blob/canary/test/e2e/app-dir/parallel-routes-and-interception/parallel-routes-and-interception.test.ts
|
|
const parent = findRoute(results, "/parallel-nested/home");
|
|
expect(parent).toMatchObject({
|
|
route: "/parallel-nested/home",
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
|
|
const nested = findRoute(results, "/parallel-nested/home/nested");
|
|
expect(nested).toMatchObject({
|
|
route: "/parallel-nested/home/nested",
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
|
|
const defaultOnly = findRoute(results, "/slot-collision");
|
|
expect(defaultOnly).toMatchObject({
|
|
route: "/slot-collision",
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
});
|
|
|
|
it("skips /headers-test (unknown route that calls headers())", () => {
|
|
const r = findRoute(results, "/headers-test");
|
|
// headers-test calls headers() — should be skipped as dynamic
|
|
expect(r).toBeDefined();
|
|
expect(r?.status).toBe("skipped");
|
|
});
|
|
|
|
// ── API routes — always skipped ────────────────────────────────────────────
|
|
|
|
it("skips all API route handlers", () => {
|
|
const apiSkipped = results.filter(
|
|
(r) => r.status === "skipped" && "reason" in r && r.reason === "api",
|
|
);
|
|
expect(apiSkipped.length).toBeGreaterThan(0);
|
|
|
|
// Known API routes
|
|
const hello = findRoute(results, "/api/hello");
|
|
expect(hello).toMatchObject({ status: "skipped", reason: "api" });
|
|
});
|
|
|
|
// ── Written files ──────────────────────────────────────────────────────────
|
|
|
|
it("writes HTML and RSC files to outDir", () => {
|
|
expect(fs.existsSync(path.join(outDir, "index.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "index.rsc"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "static-test.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "static-test.rsc"))).toBe(true);
|
|
});
|
|
|
|
it("writes blog expanded pages to correct paths", () => {
|
|
expect(fs.existsSync(path.join(outDir, "blog/hello-world.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "blog/hello-world.rsc"))).toBe(true);
|
|
});
|
|
|
|
// ── vinext-prerender.json ─────────────────────────────────────────────────
|
|
|
|
it("writes vinext-prerender.json with correct structure", () => {
|
|
const indexPath = path.join(outDir, "vinext-prerender.json");
|
|
expect(fs.existsSync(indexPath)).toBe(true);
|
|
|
|
const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
|
|
expect(Array.isArray(index.routes)).toBe(true);
|
|
|
|
// Rendered routes present — for dynamic routes the manifest has both route (pattern) and path (concrete URL)
|
|
const rendered = index.routes
|
|
.filter((r: any) => r.status === "rendered")
|
|
.map((r: any) => r.path ?? r.route);
|
|
expect(rendered).toContain("/");
|
|
expect(rendered).toContain("/blog/hello-world");
|
|
expect(rendered).toContain("/blog/getting-started");
|
|
expect(rendered).toContain("/blog/advanced-guide");
|
|
expect(rendered).toContain("/products/1");
|
|
expect(rendered).toContain("/products/2");
|
|
expect(rendered).toContain("/products/3");
|
|
expect(rendered).toContain("/shop/electronics");
|
|
expect(rendered).toContain("/shop/clothing");
|
|
expect(rendered).toContain("/shop/electronics/phone");
|
|
|
|
// ISR route has correct revalidate
|
|
const isrTest = index.routes.find((r: any) => r.route === "/isr-test");
|
|
expect(isrTest).toMatchObject({ route: "/isr-test", status: "rendered", revalidate: 1 });
|
|
|
|
// outputFiles not in index
|
|
expect(isrTest?.outputFiles).toBeUndefined();
|
|
|
|
// Skipped route present
|
|
const dynamic = index.routes.find((r: any) => r.route === "/dynamic-test");
|
|
expect(dynamic).toMatchObject({ route: "/dynamic-test", status: "skipped", reason: "dynamic" });
|
|
});
|
|
});
|
|
|
|
// ─── Hybrid: runPrerender with app/ + pages/ ──────────────────────────────────
|
|
|
|
describe("runPrerender — hybrid app+pages (app-basic)", () => {
|
|
let manifestDir: string;
|
|
let results: PrerenderRouteResult[];
|
|
|
|
beforeAll(async () => {
|
|
const pagesBundlePath = await buildPagesFixture(APP_FIXTURE);
|
|
manifestDir = tmpDir("vinext-prerender-hybrid-");
|
|
|
|
// runPrerender writes files to real paths derived from root, but we
|
|
// override by calling prerenderPages/prerenderApp directly with a tmp
|
|
// manifestDir. Instead, call runPrerender which needs a real-looking root.
|
|
// We test it indirectly: call prerenderPages on app-basic's pages/ dir
|
|
// with a manifestDir so we can check hybrid manifest merging.
|
|
const { prerenderPages } = await import("../packages/vinext/src/build/prerender.js");
|
|
const { pagesRouter, apiRouter } =
|
|
await import("../packages/vinext/src/routing/pages-router.js");
|
|
const { resolveNextConfig } = await import("../packages/vinext/src/config/next-config.js");
|
|
|
|
const pagesDir = path.resolve(APP_FIXTURE, "pages");
|
|
const pageRoutes = await pagesRouter(pagesDir);
|
|
const apiRoutes = await apiRouter(pagesDir);
|
|
const config = await resolveNextConfig({});
|
|
|
|
const prerenderResult = await prerenderPages({
|
|
mode: "default",
|
|
pagesBundlePath,
|
|
routes: pageRoutes,
|
|
apiRoutes,
|
|
pagesDir,
|
|
outDir: manifestDir,
|
|
config,
|
|
});
|
|
results = prerenderResult.routes;
|
|
}, 60_000);
|
|
|
|
afterAll(() => {
|
|
fs.rmSync(manifestDir, { recursive: true, force: true });
|
|
});
|
|
|
|
it("renders old-school static page from pages/ in app-basic fixture", () => {
|
|
const r = findRoute(results, "/old-school");
|
|
expect(r).toMatchObject({ route: "/old-school", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("old-school.html");
|
|
}
|
|
});
|
|
|
|
it("skips pages-header-override-delete (getServerSideProps) in default mode", () => {
|
|
const r = findRoute(results, "/pages-header-override-delete");
|
|
expect(r).toMatchObject({
|
|
route: "/pages-header-override-delete",
|
|
status: "skipped",
|
|
reason: "ssr",
|
|
});
|
|
});
|
|
});
|
|
|
|
// ─── runPrerender — output: 'export' wiring ───────────────────────────────────
|
|
|
|
describe("runPrerender — output: 'export' wiring", () => {
|
|
let pagesBundlePath: string;
|
|
|
|
beforeAll(async () => {
|
|
// Build pages-basic to a fresh tmpdir — no fixture copying needed.
|
|
// Pass the bundle path and a nextConfigOverride to runPrerender so it
|
|
// exercises output: 'export' without touching the real next.config.mjs.
|
|
pagesBundlePath = await buildPagesFixture(PAGES_FIXTURE);
|
|
}, 120_000);
|
|
|
|
it("throws when next.config output: 'export' and SSR routes exist", async () => {
|
|
const { runPrerender } = await import("../packages/vinext/src/build/run-prerender.js");
|
|
await expect(
|
|
runPrerender({
|
|
root: PAGES_FIXTURE,
|
|
nextConfigOverride: { output: "export" },
|
|
pagesBundlePath,
|
|
}),
|
|
).rejects.toThrow(/Static export failed/);
|
|
});
|
|
|
|
it("error message names the offending SSR route", async () => {
|
|
const { runPrerender } = await import("../packages/vinext/src/build/run-prerender.js");
|
|
await expect(
|
|
runPrerender({
|
|
root: PAGES_FIXTURE,
|
|
nextConfigOverride: { output: "export" },
|
|
pagesBundlePath,
|
|
}),
|
|
).rejects.toThrow(/\/ssr/);
|
|
});
|
|
});
|
|
|
|
// ─── App Router — Cloudflare Workers build ────────────────────────────────────
|
|
//
|
|
// Verifies that prerenderApp() works correctly when the production bundle is a
|
|
// Cloudflare Workers build (dist/server/index.js). Prerendering goes through a
|
|
// locally-spawned prod server over HTTP — same path as plain Node builds.
|
|
|
|
// ─── Cloudflare Workers hybrid build (app/ + pages/) ─────────────────────────
|
|
//
|
|
// Verifies that both prerenderApp() and prerenderPages() work correctly when
|
|
// the build is a Cloudflare Workers bundle. Both phases render via HTTP through
|
|
// a shared local prod server started by runPrerender().
|
|
|
|
describe("Cloudflare Workers hybrid build (cf-app-basic)", () => {
|
|
let outDir: string;
|
|
let allResults: PrerenderRouteResult[];
|
|
|
|
beforeAll(async () => {
|
|
const { root, rscBundlePath } = await buildCloudflareAppFixture(CF_FIXTURE);
|
|
outDir = path.join(root, "dist", "server", "prerendered-routes");
|
|
|
|
const { runPrerender } = await import("../packages/vinext/src/build/run-prerender.js");
|
|
|
|
const result = await runPrerender({ root, rscBundlePath });
|
|
allResults = result?.routes ?? [];
|
|
}, 180_000);
|
|
|
|
// ── App Router ──────────────────────────────────────────────────────────────
|
|
|
|
describe("prerenderApp — app router via prod server HTTP", () => {
|
|
it("renders / speculatively", () => {
|
|
const r = findRoute(allResults, "/");
|
|
expect(r).toMatchObject({ route: "/", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("index.html");
|
|
expect(r.outputFiles).toContain("index.rsc");
|
|
}
|
|
});
|
|
|
|
it("renders /about speculatively", () => {
|
|
const r = findRoute(allResults, "/about");
|
|
expect(r).toMatchObject({ route: "/about", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("about.html");
|
|
}
|
|
});
|
|
|
|
it("renders /blog/[slug] expanded from generateStaticParams", () => {
|
|
for (const slug of ["hello-world", "getting-started"]) {
|
|
const r = findRoute(allResults, `/blog/${slug}`);
|
|
expect(r).toMatchObject({
|
|
route: "/blog/:slug",
|
|
path: `/blog/${slug}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain(`blog/${slug}.html`);
|
|
expect(r.outputFiles).toContain(`blog/${slug}.rsc`);
|
|
}
|
|
}
|
|
});
|
|
|
|
it("skips API routes", () => {
|
|
const apiSkipped = allResults.filter(
|
|
(r) => r.status === "skipped" && "reason" in r && r.reason === "api",
|
|
);
|
|
expect(apiSkipped.length).toBeGreaterThan(0);
|
|
});
|
|
|
|
it("writes HTML and RSC files to outDir", () => {
|
|
expect(fs.existsSync(path.join(outDir, "index.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "index.rsc"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "about.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "blog/hello-world.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "blog/hello-world.rsc"))).toBe(true);
|
|
});
|
|
});
|
|
|
|
// ── Pages Router ────────────────────────────────────────────────────────────
|
|
|
|
describe("prerenderPages — pages router via prod server HTTP", () => {
|
|
it("renders static index page", () => {
|
|
const r = findRoute(allResults, "/");
|
|
expect(r).toMatchObject({ route: "/", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("index.html");
|
|
}
|
|
});
|
|
|
|
it("renders static about page", () => {
|
|
const r = findRoute(allResults, "/about");
|
|
expect(r).toMatchObject({ route: "/about", status: "rendered", revalidate: false });
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain("about.html");
|
|
}
|
|
});
|
|
|
|
it("renders /posts/[id] expanded from getStaticPaths", () => {
|
|
for (const id of ["first", "second"]) {
|
|
const r = findRoute(allResults, `/posts/${id}`);
|
|
expect(r).toMatchObject({
|
|
route: "/posts/:id",
|
|
path: `/posts/${id}`,
|
|
status: "rendered",
|
|
revalidate: false,
|
|
});
|
|
if (r?.status === "rendered") {
|
|
expect(r.outputFiles).toContain(`posts/${id}.html`);
|
|
}
|
|
}
|
|
});
|
|
|
|
it("skips API routes", () => {
|
|
const apiSkipped = allResults.filter(
|
|
(r) => r.status === "skipped" && "reason" in r && r.reason === "api",
|
|
);
|
|
expect(apiSkipped.length).toBeGreaterThan(0);
|
|
});
|
|
|
|
it("writes HTML files to outDir", () => {
|
|
expect(fs.existsSync(path.join(outDir, "posts/first.html"))).toBe(true);
|
|
expect(fs.existsSync(path.join(outDir, "posts/second.html"))).toBe(true);
|
|
});
|
|
});
|
|
});
|
|
|
|
// ─── resolveParentParams unit tests ─────────────────────────────────────────
|
|
|
|
function mockRoute(pattern: string, opts: { pagePath?: string | null } = {}): AppRoute {
|
|
const parts = pattern.split("/").filter(Boolean);
|
|
return {
|
|
pattern,
|
|
pagePath: opts.pagePath ?? `/app${pattern}/page.tsx`,
|
|
routePath: null,
|
|
layouts: [],
|
|
templates: [],
|
|
parallelSlots: [],
|
|
loadingPath: null,
|
|
errorPath: null,
|
|
layoutErrorPaths: [],
|
|
notFoundPath: null,
|
|
notFoundPaths: [],
|
|
forbiddenPaths: [],
|
|
forbiddenPath: null,
|
|
unauthorizedPaths: [],
|
|
unauthorizedPath: null,
|
|
routeSegments: [],
|
|
layoutTreePositions: [],
|
|
isDynamic: parts.some((p) => p.startsWith(":")),
|
|
params: parts
|
|
.filter((p) => p.startsWith(":"))
|
|
.map((p) => p.replace(/^:/, "").replace(/[+*]$/, "")),
|
|
patternParts: parts,
|
|
};
|
|
}
|
|
|
|
describe("resolveParentParams", () => {
|
|
it("returns empty array when route has no parent dynamic segments", async () => {
|
|
const route = mockRoute("/blog/:slug");
|
|
const result = await resolveParentParams(route, {});
|
|
expect(result).toEqual([]);
|
|
});
|
|
|
|
it("returns empty array when no parent generateStaticParams is registered", async () => {
|
|
const child = mockRoute("/shop/:category/:item");
|
|
const result = await resolveParentParams(child, {});
|
|
expect(result).toEqual([]);
|
|
});
|
|
|
|
it("resolves layout-level parent generateStaticParams without requiring a parent page", async () => {
|
|
// Ported from Next.js: test/e2e/app-dir/app-root-params-getters/generate-static-params.test.ts
|
|
// https://github.com/vercel/next.js/blob/canary/test/e2e/app-dir/app-root-params-getters/generate-static-params.test.ts
|
|
const child = mockRoute("/:lang/:locale/other/:slug");
|
|
const staticParamsMap: StaticParamsMap = {
|
|
"/:lang/:locale": async () => [
|
|
{ lang: "en", locale: "us" },
|
|
{ lang: "es", locale: "es" },
|
|
],
|
|
};
|
|
|
|
const result = await resolveParentParams(child, staticParamsMap);
|
|
|
|
expect(result).toEqual([
|
|
{ lang: "en", locale: "us" },
|
|
{ lang: "es", locale: "es" },
|
|
]);
|
|
});
|
|
|
|
it("returns empty array when parent has no generateStaticParams", async () => {
|
|
const child = mockRoute("/shop/:category/:item");
|
|
const staticParamsMap: StaticParamsMap = {};
|
|
const result = await resolveParentParams(child, staticParamsMap);
|
|
expect(result).toEqual([]);
|
|
});
|
|
|
|
it("skips missing parent providers but bails on malformed non-array results", async () => {
|
|
const child = mockRoute("/shop/:category/:item/:slug");
|
|
const calls: Record<string, string | string[]>[] = [];
|
|
const itemGenerateStaticParams = async ({
|
|
params,
|
|
}: {
|
|
params: Record<string, string | string[]>;
|
|
}) => {
|
|
calls.push(params);
|
|
return [{ item: "shoes" }];
|
|
};
|
|
const staticParamsMap: StaticParamsMap = {
|
|
"/shop/:category": async () => null,
|
|
"/shop/:category/:item": itemGenerateStaticParams,
|
|
};
|
|
|
|
const missingProviderResult = await resolveParentParams(child, staticParamsMap);
|
|
|
|
expect(missingProviderResult).toEqual([{ item: "shoes" }]);
|
|
expect(calls).toEqual([{}]);
|
|
|
|
calls.length = 0;
|
|
const malformedProviderResult = await resolveParentParams(child, {
|
|
"/shop/:category": async () => undefined,
|
|
"/shop/:category/:item": itemGenerateStaticParams,
|
|
});
|
|
|
|
expect(malformedProviderResult).toEqual([]);
|
|
expect(calls).toEqual([]);
|
|
});
|
|
|
|
it("resolves single parent dynamic segment", async () => {
|
|
const child = mockRoute("/shop/:category/:item");
|
|
const staticParamsMap: StaticParamsMap = {
|
|
"/shop/:category": async () => [{ category: "electronics" }, { category: "clothing" }],
|
|
};
|
|
const result = await resolveParentParams(child, staticParamsMap);
|
|
expect(result).toEqual([{ category: "electronics" }, { category: "clothing" }]);
|
|
});
|
|
|
|
it("resolves two levels of parent dynamic segments", async () => {
|
|
const child = mockRoute("/a/:b/c/:d/:e");
|
|
const staticParamsMap: StaticParamsMap = {
|
|
"/a/:b": async () => [{ b: "1" }, { b: "2" }],
|
|
"/a/:b/c/:d": async ({ params }) => {
|
|
if (params.b === "1") return [{ d: "x" }];
|
|
return [{ d: "y" }, { d: "z" }];
|
|
},
|
|
};
|
|
const result = await resolveParentParams(child, staticParamsMap);
|
|
expect(result).toEqual([
|
|
{ b: "1", d: "x" },
|
|
{ b: "2", d: "y" },
|
|
{ b: "2", d: "z" },
|
|
]);
|
|
});
|
|
|
|
it("skips static segments between dynamic parents", async () => {
|
|
const child = mockRoute("/shop/:category/details/:item");
|
|
const staticParamsMap: StaticParamsMap = {
|
|
"/shop/:category": async () => [{ category: "shoes" }],
|
|
};
|
|
const result = await resolveParentParams(child, staticParamsMap);
|
|
expect(result).toEqual([{ category: "shoes" }]);
|
|
});
|
|
|
|
it("returns empty array for a fully static route", async () => {
|
|
const route = mockRoute("/about/contact");
|
|
const result = await resolveParentParams(route, {});
|
|
expect(result).toEqual([]);
|
|
});
|
|
|
|
it("returns empty array for a single-segment dynamic route", async () => {
|
|
const route = mockRoute("/:id");
|
|
const result = await resolveParentParams(route, {});
|
|
expect(result).toEqual([]);
|
|
});
|
|
|
|
it("resolves parent with catch-all child segment", async () => {
|
|
const child = mockRoute("/shop/:category/:rest+");
|
|
const staticParamsMap: StaticParamsMap = {
|
|
"/shop/:category": async () => [{ category: "electronics" }],
|
|
};
|
|
const result = await resolveParentParams(child, staticParamsMap);
|
|
expect(result).toEqual([{ category: "electronics" }]);
|
|
});
|
|
});
|