67 lines
2.9 KiB
JavaScript
67 lines
2.9 KiB
JavaScript
const { test } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
const vm = require('node:vm');
|
|
const { JSDOM } = require('jsdom');
|
|
|
|
function loadAdminDocsHarness() {
|
|
const dom = new JSDOM(`<!doctype html>
|
|
<section id="docs-reader">
|
|
<article id="docs-reader-body"></article>
|
|
</section>
|
|
<div id="docs-reader-meta"></div>
|
|
<div id="docs-tree"></div>`, { url: 'https://app.example.test/' });
|
|
const source = fs.readFileSync(path.join(__dirname, '..', 'public/js/admin-docs.js'), 'utf8');
|
|
const context = vm.createContext({
|
|
window: dom.window,
|
|
document: dom.window.document,
|
|
console: { log() {}, warn() {}, error() {} },
|
|
URL: dom.window.URL,
|
|
history: dom.window.history,
|
|
requestAnimationFrame: function(fn) { fn(); },
|
|
setTimeout: function(fn) { fn(); return 0; },
|
|
fetch: function() { throw new Error('fetch not expected'); },
|
|
getAuthHeaders: function() { return {}; }
|
|
});
|
|
vm.runInContext(source + '\nwindow.__adminDocsTest = { prepareDocAnchors, prepareDocLinks, scrollReaderToHash, handleDocAnchorClick };', context);
|
|
return { dom, api: dom.window.__adminDocsTest };
|
|
}
|
|
|
|
test('admin docs TOC links keep href and scroll the internal reader', () => {
|
|
const { dom, api } = loadAdminDocsHarness();
|
|
const document = dom.window.document;
|
|
const body = document.getElementById('docs-reader-body');
|
|
const reader = document.getElementById('docs-reader');
|
|
body.innerHTML = '<ul><li><a href="#admin---configuration">Admin - Configuration</a></li></ul><h2>Admin - Configuration</h2>';
|
|
|
|
api.prepareDocAnchors(body);
|
|
api.prepareDocLinks(body);
|
|
|
|
const link = body.querySelector('a');
|
|
const target = document.getElementById('admin---configuration');
|
|
assert.equal(link.getAttribute('href'), '#admin---configuration');
|
|
assert.equal(link.dataset.docHash, '#admin---configuration');
|
|
assert.ok(target, 'heading should get a stable GitHub-style id');
|
|
|
|
reader.getBoundingClientRect = function() { return { top: 10 }; };
|
|
target.getBoundingClientRect = function() { return { top: 110 }; };
|
|
|
|
const handled = api.handleDocAnchorClick({ target: link, preventDefault() {} });
|
|
assert.equal(handled, true);
|
|
assert.equal(reader.scrollTop, 92);
|
|
assert.equal(dom.window.location.hash, '#admin---configuration');
|
|
});
|
|
|
|
test('admin docs rewrites relative markdown hash links as in-app doc links', () => {
|
|
const { dom, api } = loadAdminDocsHarness();
|
|
const body = dom.window.document.getElementById('docs-reader-body');
|
|
body.innerHTML = '<a href="logic/architecture.md#runtime-architecture">Architecture</a>';
|
|
|
|
api.prepareDocLinks(body);
|
|
|
|
const link = body.querySelector('a');
|
|
assert.equal(link.getAttribute('href'), 'logic/architecture.md#runtime-architecture');
|
|
assert.equal(link.dataset.docFile, 'logic/architecture.md');
|
|
assert.equal(link.dataset.docHash, '#runtime-architecture');
|
|
});
|