mirror of
https://github.com/lrnselfreliance/wrolpi.git
synced 2026-10-26 19:01:39 -04:00
Markdown files are typed text/markdown (libmagic reports them as text/plain, or as a programming language when they hold code) and keep the text indexer, so they stay deep-searchable. Existing files switch type on their next refresh. The file preview renders markdown with markdown-it into the page, so it follows the theme tokens and the night media filter. A Formatted/Raw toggle shows the source instead, and the choice is remembered. Relative links and images resolve against the file's directory; URLs that climb out of /media/ are dropped. Raw HTML in a file is escaped rather than parsed, and the output is also sanitized with DOMPurify. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
157 lines
6.1 KiB
JavaScript
157 lines
6.1 KiB
JavaScript
import React from 'react';
|
|
import {fireEvent, screen, waitFor} from '@testing-library/react';
|
|
import {isMarkdownFile, MarkdownPreview, renderMarkdown} from './MarkdownPreview';
|
|
import {renderUI} from '../test-utils';
|
|
|
|
const FILE_URL = '/media/notes/water/storage.md';
|
|
|
|
/** Render markdown into a detached element so assertions read the DOM, not the HTML string. */
|
|
const renderToDOM = (text, fileURL = FILE_URL) => {
|
|
const div = document.createElement('div');
|
|
div.innerHTML = renderMarkdown(text, fileURL);
|
|
return div;
|
|
};
|
|
|
|
describe('renderMarkdown', () => {
|
|
test('formats headings, emphasis, lists, code, and tables', () => {
|
|
const div = renderToDOM([
|
|
'# Water',
|
|
'',
|
|
'Rotate *every* barrel.',
|
|
'',
|
|
'- one',
|
|
'- two',
|
|
'',
|
|
'```',
|
|
'boil 1 minute',
|
|
'```',
|
|
'',
|
|
'| a | b |',
|
|
'|---|---|',
|
|
'| 1 | 2 |',
|
|
].join('\n'));
|
|
|
|
expect(div.querySelector('h1').textContent).toBe('Water');
|
|
expect(div.querySelector('em').textContent).toBe('every');
|
|
expect(div.querySelectorAll('ul li')).toHaveLength(2);
|
|
expect(div.querySelector('pre code').textContent).toBe('boil 1 minute\n');
|
|
expect(div.querySelectorAll('table td')).toHaveLength(2);
|
|
});
|
|
|
|
test('raw HTML in the file is shown as text, never parsed', () => {
|
|
const div = renderToDOM('<script>alert(1)</script>\n\n<img src=x onerror="alert(2)">');
|
|
|
|
expect(div.querySelector('script')).toBeNull();
|
|
expect(div.querySelector('img')).toBeNull();
|
|
expect(div.textContent).toContain('<script>alert(1)</script>');
|
|
});
|
|
|
|
test('script URLs are not turned into links', () => {
|
|
const div = renderToDOM('[click](javascript:alert(1))');
|
|
|
|
expect(div.querySelector('a')).toBeNull();
|
|
});
|
|
|
|
test('relative images resolve against the markdown file directory', () => {
|
|
const div = renderToDOM('\n\n');
|
|
|
|
const [pump, tank] = div.querySelectorAll('img');
|
|
expect(pump.getAttribute('src')).toBe('/media/notes/water/images/hand%20pump.png');
|
|
expect(tank.getAttribute('src')).toBe('/media/notes/tank.jpg');
|
|
});
|
|
|
|
test('relative links resolve against the markdown file directory and open a new tab', () => {
|
|
const a = renderToDOM('[filters](filters.md#ceramic)').querySelector('a');
|
|
|
|
expect(a.getAttribute('href')).toBe('/media/notes/water/filters.md#ceramic');
|
|
expect(a.getAttribute('target')).toBe('_blank');
|
|
});
|
|
|
|
test('a relative URL that climbs out of the media directory is dropped', () => {
|
|
const div = renderToDOM('[api](../../../api/status)\n\n');
|
|
|
|
expect(div.querySelector('a').hasAttribute('href')).toBe(false);
|
|
expect(div.querySelector('img').hasAttribute('src')).toBe(false);
|
|
});
|
|
|
|
test('external links open in a new tab without an opener', () => {
|
|
const a = renderToDOM('<https://example.com/page>').querySelector('a');
|
|
|
|
expect(a.getAttribute('href')).toBe('https://example.com/page');
|
|
expect(a.getAttribute('target')).toBe('_blank');
|
|
expect(a.getAttribute('rel')).toBe('noopener noreferrer');
|
|
});
|
|
|
|
test('absolute and fragment URLs are left alone', () => {
|
|
const [root, fragment] = renderToDOM('[root](/files)\n\n[top](#top)').querySelectorAll('a');
|
|
|
|
expect(root.getAttribute('href')).toBe('/files');
|
|
expect(fragment.getAttribute('href')).toBe('#top');
|
|
expect(fragment.hasAttribute('target')).toBe(false);
|
|
});
|
|
});
|
|
|
|
describe('MarkdownPreview', () => {
|
|
const SOURCE = '# Water storage\n\nRotate *every* six months.\n';
|
|
|
|
beforeEach(() => {
|
|
window.localStorage.clear();
|
|
global.fetch = jest.fn(() => Promise.resolve({
|
|
ok: true,
|
|
text: () => Promise.resolve(SOURCE),
|
|
}));
|
|
});
|
|
|
|
afterEach(() => {
|
|
delete global.fetch;
|
|
});
|
|
|
|
test('fetches the file and shows it formatted', async () => {
|
|
renderUI(<MarkdownPreview url={FILE_URL}/>);
|
|
|
|
const heading = await screen.findByRole('heading', {name: 'Water storage'});
|
|
expect(heading.tagName).toBe('H1');
|
|
expect(global.fetch).toHaveBeenCalledWith(FILE_URL, expect.anything());
|
|
});
|
|
|
|
test('Raw shows the unformatted source, and the choice is remembered', async () => {
|
|
const {unmount} = renderUI(<MarkdownPreview url={FILE_URL}/>);
|
|
await screen.findByRole('heading', {name: 'Water storage'});
|
|
|
|
fireEvent.click(screen.getByRole('button', {name: 'Raw'}));
|
|
|
|
expect(screen.queryByRole('heading')).toBeNull();
|
|
expect(screen.getByTestId('markdown-raw').textContent).toBe(SOURCE);
|
|
|
|
// The next preview opens in the mode the reader chose last.
|
|
unmount();
|
|
renderUI(<MarkdownPreview url={FILE_URL}/>);
|
|
await waitFor(() => expect(screen.getByTestId('markdown-raw').textContent).toBe(SOURCE));
|
|
expect(screen.queryByRole('heading')).toBeNull();
|
|
|
|
fireEvent.click(screen.getByRole('button', {name: 'Formatted'}));
|
|
expect(screen.getByRole('heading', {name: 'Water storage'})).toBeTruthy();
|
|
});
|
|
|
|
test('a failed fetch shows an error instead of loading forever', async () => {
|
|
global.fetch = jest.fn(() => Promise.resolve({ok: false, status: 404, statusText: 'Not Found'}));
|
|
|
|
renderUI(<MarkdownPreview url={FILE_URL}/>);
|
|
|
|
expect(await screen.findByText(/404 Not Found/)).toBeTruthy();
|
|
});
|
|
});
|
|
|
|
describe('isMarkdownFile', () => {
|
|
test.each([
|
|
['text/markdown', 'notes/a.md', true],
|
|
// Files indexed before text/markdown existed are text/plain until their next refresh.
|
|
['text/plain', 'notes/a.md', true],
|
|
['text/plain', 'notes/a.markdown', true],
|
|
['text/plain', 'notes/a.txt', false],
|
|
// A suffix alone is not enough; a binary file named .md is not markdown.
|
|
['application/octet-stream', 'notes/a.md', false],
|
|
])('%s %s -> %s', (mimetype, lowerPath, expected) => {
|
|
expect(isMarkdownFile(mimetype, lowerPath)).toBe(expected);
|
|
});
|
|
});
|