Files
iptvnator/tools/testing/website-guides.test.mjs
T
4grayandClaude Fable 5.1 50b980af7a feat(website): add the M3U playlist and EPG setup guide
Publish "How to Load an M3U Playlist and Add an EPG in IPTVnator": the
three import methods plus drag-and-drop and OS file opening, the
playlist views, refresh and startup auto-update, attaching an XMLTV
guide through Settings or a url-tvg header, the tvg-id / tvg-name /
name matching order with manual mapping, catch-up attributes,
troubleshooting and a seven-question FAQ. The three guides now link to
each other, the download pages point at all three, and llms.txt lists
the new one.

Three guide shots join the manifest: the M3U URL dialog, the Groups
view (reusing open-m3u-groups under the guides group) and the EPG
settings section with a staged source row. A settings shot leaves the
form dirty, which arms the app's close guard and blocked app.close()
indefinitely; the capture now discards unsaved settings before every
action and before teardown, and bounds every locator wait.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-04 16:39:09 +02:00

72 lines
2.6 KiB
JavaScript

import { access, readFile } from 'node:fs/promises';
import { test } from 'node:test';
import assert from 'node:assert/strict';
/**
* Structural checks for guide posts: they must carry FAQPage structured data
* next to the BlogPosting entry, link to the download hub, and reference only
* screenshots that the build actually shipped.
*/
const distRoot = new URL('../../dist/apps/website/', import.meta.url);
const SITE = 'https://4gray.github.io/iptvnator';
const GUIDES = [
{
slug: 'xtream-codes-setup-guide',
screenshots: [
'blog/guides/screenshots/guide-xtream-add-playlist-dark.png',
'blog/guides/screenshots/guide-xtream-auto-detect-dark.png',
'blog/guides/screenshots/guide-xtream-live-dark.png',
],
},
{
slug: 'stalker-portal-setup-guide',
screenshots: [
'blog/guides/screenshots/guide-stalker-add-playlist-dark.png',
'blog/guides/screenshots/guide-stalker-live-dark.png',
],
},
{
slug: 'm3u-playlist-epg-setup-guide',
screenshots: [
'blog/guides/screenshots/guide-m3u-add-playlist-dark.png',
'blog/guides/screenshots/guide-m3u-live-groups-dark.png',
'blog/guides/screenshots/guide-epg-settings-dark.png',
],
},
];
const readDist = (relativePath) => readFile(new URL(relativePath, distRoot), 'utf8');
function extractJsonLd(html) {
const blocks = [...html.matchAll(/<script type="application\/ld\+json">([\s\S]*?)<\/script>/g)];
assert.ok(blocks.length > 0, 'Expected at least one JSON-LD script block.');
return blocks.flatMap((match) => JSON.parse(match[1]));
}
for (const guide of GUIDES) {
test(`${guide.slug}: BlogPosting and FAQPage structured data`, async () => {
const html = await readDist(`blog/${guide.slug}/index.html`);
const schema = extractJsonLd(html);
assert.ok(schema.some((entry) => entry['@type'] === 'BlogPosting'), 'Expected a BlogPosting entry.');
const faq = schema.find((entry) => entry['@type'] === 'FAQPage');
assert.ok(faq, 'Expected a FAQPage entry.');
assert.ok(faq.mainEntity.length >= 5, 'Expected at least five FAQ questions.');
assert.match(html, /Frequently asked questions/);
assert.match(html, new RegExp(`<link rel="canonical" href="${SITE}/blog/${guide.slug}/"`));
});
test(`${guide.slug}: links to the download hub and ships its screenshots`, async () => {
const html = await readDist(`blog/${guide.slug}/index.html`);
assert.match(html, /href="\/iptvnator\/download\/"/);
for (const screenshot of guide.screenshots) {
assert.match(html, new RegExp(`src="/iptvnator/${screenshot.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"`));
await access(new URL(screenshot, distRoot));
}
});
}