3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-05-10 23:57:22 +02:00
Code Issues Projects Releases Packages Wiki Activity

test(content-docs): refactor navigation test snapshot (#6821)

Browse source 
* test(content-docs): refactor navigation test snapshot

* format
This commit is contained in:
Joshua Chen 2022-03-03 14:00:42 +08:00 • committed by GitHub
parent 1c91d2f20e
commit f04cb7abb9
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 250 additions and 145 deletions
Download patch file Download diff file Expand all files Collapse all files

374
packages/docusaurus-plugin-content-docs/src/__tests__/__snapshots__/docs.test.ts.snap
View file

@ -1,144 +1,244 @@
// Jest Snapshot v1, https://goo.gl/fbAQLP
exports[`simple site custom pagination 1`] = `
Array [
Array [
undefined,
Object {
"pagination": Array [
Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
"id": "doc with space",
"next": Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
"prev": undefined,
},
Object {
"id": "foo/bar",
"next": undefined,
"prev": undefined,
},
Object {
"id": "foo/baz",
"next": Object {
"permalink": "/docs/absoluteSlug",
"title": "absoluteSlug",
},
"prev": Object {
"permalink": "/docs/foo/bar",
"title": "Bar",
},
},
Object {
"id": "headingAsTitle",
"next": Object {
"permalink": "/docs/",
"title": "Hello sidebar_label",
},
"prev": Object {
"permalink": "/docs/doc with space",
"title": "Hoo hoo, if this path tricks you...",
},
},
Object {
"id": "hello",
"next": Object {
"permalink": "/docs/ipsum",
"title": "ipsum",
},
"prev": Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
},
Object {
"id": "ipsum",
"next": Object {
"permalink": "/docs/lorem",
"title": "lorem",
},
"prev": Object {
"permalink": "/docs/",
"title": "Hello sidebar_label",
},
},
Object {
"id": "lorem",
"next": Object {
"permalink": "/docs/rootAbsoluteSlug",
"title": "rootAbsoluteSlug",
},
"prev": Object {
"permalink": "/docs/ipsum",
"title": "ipsum",
},
},
Object {
"id": "rootAbsoluteSlug",
"next": Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
"prev": Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
},
Object {
"id": "rootRelativeSlug",
"next": Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
"prev": Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
},
Object {
"id": "rootResolvedSlug",
"next": Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
"prev": Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
},
Object {
"id": "rootTryToEscapeSlug",
"next": Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
"prev": Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
},
Object {
"id": "slugs/absoluteSlug",
"next": Object {
"permalink": "/docs/slugs/relativeSlug",
"title": "relativeSlug",
},
"prev": Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
},
Object {
"id": "slugs/relativeSlug",
"next": Object {
"permalink": "/docs/slugs/hey/resolvedSlug",
"title": "resolvedSlug",
},
"prev": Object {
"permalink": "/docs/absoluteSlug",
"title": "absoluteSlug",
},
},
Object {
"id": "slugs/resolvedSlug",
"next": Object {
"permalink": "/docs/tryToEscapeSlug",
"title": "tryToEscapeSlug",
},
"prev": Object {
"permalink": "/docs/slugs/relativeSlug",
"title": "relativeSlug",
},
},
Object {
"id": "slugs/tryToEscapeSlug",
"next": undefined,
"prev": Object {
"permalink": "/docs/slugs/hey/resolvedSlug",
"title": "resolvedSlug",
},
},
],
Array [
undefined,
undefined,
],
Array [
Object {
"permalink": "/docs/foo/bar",
"title": "Bar",
},
Object {
"permalink": "/docs/absoluteSlug",
"title": "absoluteSlug",
},
],
Array [
Object {
"permalink": "/docs/doc with space",
"title": "Hoo hoo, if this path tricks you...",
},
Object {
"permalink": "/docs/",
"title": "Hello sidebar_label",
},
],
Array [
Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
Object {
"permalink": "/docs/ipsum",
"title": "ipsum",
},
],
Array [
Object {
"permalink": "/docs/",
"title": "Hello sidebar_label",
},
Object {
"permalink": "/docs/lorem",
"title": "lorem",
},
],
Array [
Object {
"permalink": "/docs/ipsum",
"title": "ipsum",
},
Object {
"permalink": "/docs/rootAbsoluteSlug",
"title": "rootAbsoluteSlug",
},
],
Array [
Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
],
Array [
Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
],
Array [
Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
],
Array [
Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
Object {
"permalink": "/docs/headingAsTitle",
"title": "My heading as title",
},
],
Array [
Object {
"permalink": "/docs/foo/bazSlug.html",
"title": "baz pagination_label",
},
Object {
"permalink": "/docs/slugs/relativeSlug",
"title": "relativeSlug",
},
],
Array [
Object {
"permalink": "/docs/absoluteSlug",
"title": "absoluteSlug",
},
Object {
"permalink": "/docs/slugs/hey/resolvedSlug",
"title": "resolvedSlug",
},
],
Array [
Object {
"permalink": "/docs/slugs/relativeSlug",
"title": "relativeSlug",
},
Object {
"permalink": "/docs/tryToEscapeSlug",
"title": "tryToEscapeSlug",
},
],
Array [
Object {
"permalink": "/docs/slugs/hey/resolvedSlug",
"title": "resolvedSlug",
},
undefined,
],
]
"sidebars": Object {
"defaultSidebar": Array [
Object {
"id": "doc with space",
"type": "doc",
},
Object {
"id": "headingAsTitle",
"type": "doc",
},
Object {
"id": "hello",
"label": "Hello sidebar_label",
"type": "doc",
},
Object {
"id": "ipsum",
"type": "doc",
},
Object {
"id": "lorem",
"type": "doc",
},
Object {
"id": "rootAbsoluteSlug",
"type": "doc",
},
Object {
"id": "rootRelativeSlug",
"type": "doc",
},
Object {
"id": "rootResolvedSlug",
"type": "doc",
},
Object {
"id": "rootTryToEscapeSlug",
"type": "doc",
},
Object {
"collapsed": false,
"collapsible": true,
"items": Array [
Object {
"id": "foo/bar",
"type": "doc",
},
Object {
"id": "foo/baz",
"type": "doc",
},
],
"label": "foo",
"link": undefined,
"type": "category",
},
Object {
"collapsed": false,
"collapsible": true,
"items": Array [
Object {
"id": "slugs/absoluteSlug",
"type": "doc",
},
Object {
"id": "slugs/relativeSlug",
"type": "doc",
},
Object {
"id": "slugs/resolvedSlug",
"type": "doc",
},
Object {
"id": "slugs/tryToEscapeSlug",
"type": "doc",
},
],
"label": "slugs",
"link": undefined,
"type": "category",
},
],
},
}
`;

21
packages/docusaurus-plugin-content-docs/src/__tests__/docs.test.ts
View file

@ -15,6 +15,7 @@ import {
isCategoryIndex,
} from '../docs';
import {loadSidebars} from '../sidebars';
import type {Sidebars} from '../sidebars/types';
import {readVersionsMetadata} from '../versions';
import type {
DocFile,
@ -120,9 +121,10 @@ function createTestUtils({
expect(metadata.permalink).toEqual(expectedPermalink);
}
async function generateNavigation(
docFiles: DocFile[],
): Promise<[DocNavLink | undefined, DocNavLink | undefined][]> {
async function generateNavigation(docFiles: DocFile[]): Promise<{
pagination: {prev?: DocNavLink; next?: DocNavLink; id: string}[];
sidebars: Sidebars;
}> {
const rawDocs = docFiles.map((docFile) =>
processDocMetadata({
docFile,
@ -145,11 +147,14 @@ function createTestUtils({
});
const sidebarsUtils = createSidebarsUtils(sidebars);
return addDocNavigation(
rawDocs,
sidebarsUtils,
versionMetadata.sidebarFilePath as string,
).map((doc) => [doc.previous, doc.next]);
return {
pagination: addDocNavigation(
rawDocs,
sidebarsUtils,
versionMetadata.sidebarFilePath as string,
).map((doc) => ({prev: doc.previous, next: doc.next, id: doc.id})),
sidebars,
};
}
return {processDocFile, testMeta, testSlug, generateNavigation};