angular/adev/shared-docs/pipeline/guides/testing/docs-code/docs-code.spec.ts
Joey Perrott 2d8635d29d refactor(docs-infra): migrate @angular/docs from dev-infra into adev directory (#57132)
To increase the ease of development we are moving @angular/docs into the adev directory within this repo. While
we are doing this to improve our development experience in the short term, efforts are also in place
to maintain a division between this @angular/docs (shared) code and adev itself, so that it can be extracted
back out in the future when components is ready to leverage it as well.

PR Close #57132
2024-07-30 15:51:26 +00:00

55 lines
2.2 KiB
TypeScript

import {parseMarkdown} from '../../../guides/parse';
import {runfiles} from '@bazel/runfiles';
import {readFile} from 'fs/promises';
import {JSDOM} from 'jsdom';
import {initHighlighter} from '../../extensions/docs-code/format/highlight';
describe('markdown to html', () => {
let markdownDocument: DocumentFragment;
beforeAll(async () => {
await initHighlighter();
const markdownContent = await readFile(
runfiles.resolvePackageRelative('docs-code/docs-code.md'),
{encoding: 'utf-8'},
);
markdownDocument = JSDOM.fragment(await parseMarkdown(markdownContent, {}));
});
it('converts docs-code elements into a code block', () => {
const codeBlock = markdownDocument.querySelectorAll('code')[0];
expect(codeBlock).toBeTruthy();
expect(codeBlock?.textContent?.trim()).toBe('this is code');
});
it('removes eslint comments from the code', () => {
const codeBlock = markdownDocument.querySelectorAll('code')[1];
expect(codeBlock).toBeTruthy();
expect(codeBlock?.textContent?.trim()).not.toContain('// eslint');
});
it('extract regions from the code', () => {
// This unit test is sensible to additional node, like text nodes between the lines.
// The specific index here makes sure there is no space/linebreak between the code lines
const codeBlock = markdownDocument.querySelectorAll('code')[2];
expect(codeBlock).toBeTruthy();
expect(codeBlock?.textContent?.trim()).toContain(`const x = 'within the region';`);
expect(codeBlock?.textContent?.trim()).not.toContain('docregion');
});
it('properly shows the diff of two provided file paths', () => {
const codeBlock = markdownDocument.querySelectorAll('code')[3];
expect(codeBlock).toBeTruthy();
const codeLines = codeBlock.querySelectorAll('.line');
expect(codeLines[0].textContent).toContain('oldFuncName');
expect(codeLines[0].classList.contains('remove')).toBeTrue();
expect(codeLines[1].textContent).toContain('newName');
expect(codeLines[1].classList.contains('add')).toBeTrue();
expect(codeLines[2].classList.contains('add')).toBeFalse();
expect(codeLines[2].classList.contains('remove')).toBeFalse();
});
});