Tests
La section « Version 2.0 » en fin de document couvre les sources supplémentaires, les films, les séries, l'ONF, la bibliothèque et la nouvelle interface. Ce qui précède décrit la validation de la version 1 (toujours valable).
Tout ce qui suit a été exécuté le 2026-11-16, sur de vraies données IPTV-org et de vrais flux publics. Aucune chaîne fictive n'est utilisée pour démontrer une fonctionnalité ; le seul jeu de données généré (12 000 lignes) sert à mesurer la vitesse de recherche dans les tests unitaires et est signalé comme tel dans le fichier de test.
Lancer les tests
pnpm test # Vitest : 35 tests unitaires et d'intégration (≈ 3 s)
node_modules/.bin/playwright install chromium firefox webkit # une fois
SPTV_URL=https://tv.spboucher.ai SPTV_PASSWORD='…' node_modules/.bin/playwright test # 40 tests de bout en boutLes tests de bout en bout visent une instance réelle (production ou build local pnpm build && pnpm start + pnpm worker).
Résultats
| # | Exigence | Comment | Résultat |
|---|---|---|---|
| 1 | Import réel d'une playlist IPTV-org | worker en production, tâche n° 1 : index.m3u (11 502 entrées), ca.m3u (264), us.m3u (1 497), fr.m3u (208) + API de métadonnées |
10 368 chaînes, 11 484 flux, 1 969 doublons écartés, 3 entrées bloquées (liste IPTV-org), 15 protocoles non http(s) ignorés, 0 erreur d'analyse, 1,1 s |
| 2 | Métadonnées extraites | contrôle en base : 10 368/10 368 chaînes reliées à l'API IPTV-org, pays connu pour toutes, 141 sans logo, 180 pays ; tests unitaires de l'analyseur (tvg-id, feed, qualité, étiquettes, logo, groupes, #EXTVLCOPT, virgules entre guillemets) |
conforme |
| 3 | Persistance des favoris | E2E : ajout par l'interface, rechargement, nouvelle session dans un autre contexte de navigateur ; unitaire : ordre conservé après reconstruction du catalogue, favori conservé quand ses flux disparaissent | réussi (4 profils) |
| 4 | Recherche et filtres | E2E : « frnace 24 » → France 24, filtre pays ; unitaire : accents, casse, fautes, transpositions, pays/catégorie/langue/statut, pagination | réussi |
| 5 | Lecture de flux publics | E2E en production, horloge vidéo qui avance réellement : Firefox (hls.js), WebKit iPhone et iPad (HLS natif) : 10 TV, 13 Siam Thai, 3CatInfo, Africa 24 ; mesure manuelle Firefox : 3ABN Canada, Amazing Discoveries TV, Apna Punjab TV, Az Star TV | lus ; zapping sans rechargement vérifié |
| 6 | Flux indisponibles | E2E : ouverture d'une chaîne « indisponible au dernier test » → panneau d'erreur avec la cause, Réessayer, Tester maintenant ; unitaire : 403, 404, HTML, variante morte, délai dépassé | réussi ; un flux qui cesse d'émettre 25 s devient une erreur (plus de chargement infini) |
| 7 | Authentification | E2E : pages et API refusées sans session (307 / 401), mauvais mot de passe, cookie __Host-sptv HttpOnly + Secure + SameSite=Lax, déconnexion ; sur le nœud : 5 échecs → HTTP 429 « Réessayez dans 15 min » même avec le bon mot de passe, origine étrangère → 403 ; unitaire : scrypt, sessions, verrouillage par adresse et global |
réussi |
| 8 | Compatibilité mobile | E2E profil iPhone 15 (WebKit) et iPad Pro 11 : toutes les pages, aucun débordement horizontal, lecture, favoris, guide, admin | réussi |
| 9 | Performance sur un grand catalogue | production, 10 368 chaînes : recherche serveur 1 à 36 ms, aller-retour API 22 à 62 ms, accueil 31 ms, guide 45 ms ; démarrage du lecteur 0,3 à 1,2 s (4 chaînes canadiennes) ; listes paginées (72 par page, défilement infini), logos en chargement différé | conforme |
| 10 | Déploiement HTTPS | https://tv.spboucher.ai : 200, certificat Let's Encrypt, HTTP → HTTPS (308), HSTS ; mld status --live : local 200 / public 200 ; redémarrage PM2 puis santé 200 |
réussi |
Autres vérifications :
- Guide TV réel : première collecte en production, 171 chaînes demandées (Canada + France), 134 avec données, 7 859 programmes en 3 min 39 s. Les 37 autres n'ont rien renvoyé ce jour-là : le site suivant sera essayé à la prochaine collecte, et elles affichent « Programme indisponible ».
- SSRF : l'ajout de
http://192.168.2.1/…,http://127.0.0.1:8670/…,http://localhost/…,file:///etc/passwd,http://169.254.169.254/…est refusé (400) ; un nom public qui résout vers 127.0.0.1 est refusé à la connexion. - Sauvegarde / restauration :
scripts/backup.shsur le nœud → archive de 3,0 Mo, décompressée et relue (integrity_check= ok, 10 368 chaînes, 11 484 flux). - Navigation clavier / télécommande (Chromium, Firefox, WebKit iPad) : flèches entre champ de recherche, filtres et cartes, focus visible, Entrée ouvre le lecteur, Échap le réduit.
Bilan de la suite de bout en bout en production : 38 réussis, 2 exclus (sur 40). Exclus volontairement : lecture vidéo dans le Chromium de Playwright (ce build n'a pas de décodeur H.264/AAC) ; navigation clavier sur le profil iPhone (écran tactile).
Disponibilité mesurée (au moment de la rédaction)
Le premier passage de vérification était en cours (≈ 1 flux toutes les 2 s, par politesse envers les serveurs). Sur les premiers flux testés depuis le nœud : environ 68 % disponibles, dont plus de 90 % avec en-têtes CORS (lisibles par hls.js hors Safari). Causes d'indisponibilité les plus fréquentes : délai d'attente dépassé, HTTP 404, HTTP 403, DNS introuvable, certificat TLS invalide. Les chiffres à jour sont dans Admin → Aperçu.
Plateformes réellement testées
| Plateforme | Testé | Comment |
|---|---|---|
| Firefox 159 (macOS) | oui | Playwright, lecture réelle par hls.js |
| WebKit (moteur de Safari) — profils iPhone 15 et iPad Pro 11, macOS 27 | oui | Playwright WebKit, lecture réelle par HLS natif |
| Chromium 159 (macOS) | oui, sauf vidéo | interface, recherche, favoris, admin, clavier ; pas de décodeur H.264 dans ce build |
| Safari sur un vrai iPhone / iPad, AirPlay réel | non | le bouton AirPlay n'apparaît que si l'appareil annonce une cible ; à valider sur l'appareil |
| Google Chrome, Microsoft Edge (builds officiels) | non | même moteur que Chromium + codecs : hls.js y est pris en charge, mais non vérifié ici (non installés sur le poste de test) |
| Android (Chrome), Android TV | non | |
| Navigateurs de Smart TV (Tizen, webOS, Vidaa…) | non | la navigation directionnelle et les touches Retour (BrowserBack, GoBack) sont gérées, mais aucun téléviseur n'a été testé. Les téléviseurs anciens (moteurs antérieurs à ~2020) ne feront probablement pas tourner l'application |
| PWA installée | non vérifié sur appareil | manifeste, icônes et service worker servis ; l'installation elle-même n'a pas été faite |
| Clés d'accès (passkeys) | oui, authentificateur virtuel | production, Chromium + authentificateur WebAuthn virtuel : enregistrement, déconnexion, connexion par clé, suppression. Touch ID / Face ID réels : à enrôler par le propriétaire (Admin → Sécurité) |
Limites connues
- Flux HTTP (≈ 21 % du catalogue) : bloqués par les navigateurs sur une page HTTPS ; signalés comme tels, URL copiable pour un lecteur externe.
- Flux exigeant un Referer/User-Agent (≈ 7 %), géobloqués, DASH (≈ 1 %) ou protégés : non lus, cause affichée.
- Le statut « disponible » vient d'un test serveur depuis le Québec ; un flux peut répondre au serveur et refuser le navigateur (ou l'inverse).
- Guide : 60 chaînes par vue (filtre pour atteindre les autres) ; données limitées aux chaînes que les sites de programmes couvrent.
- Les tests de bout en bout dépendent de flux publics tiers : un flux peut s'interrompre pendant un test.
Version 2.0 — validation du 2026-11-16
Lancer
pnpm test # 53 tests unitaires et d'intégration
SPTV_URL=https://tv.spboucher.ai SPTV_PASSWORD='…' node_modules/.bin/playwright test # app.spec.ts (v1) + vod.spec.ts (v2)Résultats par exigence (phase 10 du cahier des charges)
| # | Exigence | Comment | Résultat |
|---|---|---|---|
| 1 | Nouvelles playlists vérifiées | chaque dépôt proposé téléchargé et mesuré (entrées, doublons avec IPTV-org, marques payantes, hôtes) + recherche élargie (≈ 45 sources, 90 playlists) | 7 sources actives, 4 désactivées par défaut, une vingtaine refusées — SOURCES.md |
| 2 | Importation des chaînes | synchronisation en production | 11 650 chaînes, 13 975 flux (v1 : 10 368 / 11 484) ; 110 flux de la sélection vérifiée, 1 222 de Free-TV, 638 de Nexonic, 714 des grilles Pluto / Samsung |
| 3 | Déduplication | même synchronisation | 6 600 doublons d'URL écartés, 220 variantes sans identifiant regroupées par nom, 234 chaînes payantes présumées et 139 liens de pages écartés ; ICI Télé = 1 chaîne, 14 flux |
| 4 | Lecture de plusieurs chaînes | production, horloge vidéo qui avance | Firefox (hls.js) : ICI Télé, ICI RDI, Savoir média, Canal de l'Assemblée nationale, CPAC, France 24 ; WebKit iPhone (natif) : les mêmes + Global News et Radio-Canada INFO |
| 5 | Import d'un film légalement accessible | tâche vod en production |
6 271 films avec source vidéo : 1 682 Internet Archive, 1 207 Wikimedia Commons, 3 379 ONF (2 187 longs métrages, 2 468 documentaires, 1 340 films d'animation, 3 409 en français) ; écartés : 180 sans vidéo lisible, 150 dont l'élément Internet Archive ne correspondait pas au film, 9 pour adultes, 98 films ONF non offerts gratuitement en entier ; 5 642 avec synopsis, 5 547 avec affiche |
| 6 | Lecture du film | E2E Firefox : lecture, saut à 5:00, fermeture, « Reprendre à 5:0x », reprise à la bonne position | réussi en production — Firefox, WebKit iPhone, WebKit iPad |
| 7 | Série à plusieurs épisodes | Flash Gordon Conquers the Universe (11 chapitres), Pioneer One (6 épisodes), Undersea Kingdom ; Caminandes (3 épisodes, bibliothèque) | importées |
| 8 | Navigation saisons / épisodes | E2E : liste d'épisodes, « marquer comme vu » déplace « Regarder » sur l'épisode suivant, lecture d'un épisode puis « Épisode suivant » | réussi — Firefox, WebKit iPhone, WebKit iPad (production) |
| 9 | Bibliothèque NAS | NAS injoignables (voir Blocages). Validée en production sur un dossier local réel : 3 films + 1 série Blender (Creative Commons) | reconnus avec affiche et synopsis ; MP4 lu tel quel ; MKV H.264 converti par copie de flux (< 1 s) avec sous-titres français (60 répliques) ; MKV HEVC 10 bits / AC-3 réencodé par VideoToolbox (14 min 48 de film en 15 s) ; lus sur Firefox, WebKit iPhone et iPad |
| 10 | Favoris et reprise | E2E : « Ma liste » (ajout, relecture par l'API, retrait), position enregistrée à la fermeture, « Continuer à regarder », marquage vu / non vu | réussi |
| 11 | Mobile et ordinateur | profils iPhone 15 et iPad Pro 11 (WebKit), Firefox et Chromium 1440 px ; aucun débordement horizontal | réussi |
| 12 | Authentification et sécurité | 9 routes (catalogue, lecture, fichier, HLS, sous-titres, miniature, admin) → 401 sans session ; fichier servi en 206 avec session, refusé sans ; chemins .. refusés ; checkDir refuse /etc, le dossier des secrets, les chemins relatifs ou cachés |
réussi |
| 13 | Déploiement | mld inchangé ; migrations 2 et 3 appliquées sur la base de production ; clé d'accès, sessions et réglages existants conservés |
réussi |
| 14 | Fonctionnement réel après déploiement | suites E2E rejouées contre https://tv.spboucher.ai | 70 réussis, 2 exclus sur 72 (18 scénarios × 4 profils : Chromium, Firefox, WebKit iPhone, WebKit iPad). Exclus : lecture vidéo dans le Chromium de Playwright (pas de décodeur H.264) et navigation clavier sur iPhone |
Autres vérifications faites :
- Guide TV : 759 chaînes avec programmes réels après ajout des guides Pluto / Samsung (v1 : 134). Un rafraîchissement a échoué le 16 nov. à 13 h 51 (coupure réseau passagère vers GitHub) : les téléchargements sont désormais retentés et le guide redemandé dans l'heure.
- Disponibilité : premier passage complet terminé — 9 851 flux disponibles, 4 059 indisponibles au dernier test ; 521 chaînes canadiennes, 465 chaînes francophones.
- Sauvegardes : exécution nocturne constatée (03 h 50, 6,7 Mo).
- Piste audio et vitesse (local, Firefox) : fichier à deux pistes → bascule sur la seconde (nouvelle déclinaison HLS, AC-3 → AAC) avec reprise à la même position ; vitesse 1,5×.
- ONF : « 24 heures ou plus » (1973, 1 h 53) lu dans le lecteur officiel intégré, lien « Voir sur onf.ca » présent (local, Firefox) ; en production, « … et la musique » lu dans le lecteur officiel sur Firefox, WebKit iPhone et WebKit iPad. Import ONF : 3 625 films listés, 3 477 examinés en 80 minutes, 3 379 retenus, 98 écartés (pas de film entier gratuit dans le lecteur), 148 en erreur réseau qui seront réexaminés au prochain import.
- Garde titre + année : « His Girl Friday » (1940) n'est plus relié à « The Saint's Girl Friday » (1953) — test unitaire.
- Non-régression v1 :
app.spec.ts28 réussis / 2 exclus en production après la refonte.
Playlists M3U personnelles (ajout du 2026-11-17)
- E2E en production (4 profils) : création, lecture de l'adresse sans session (200,
audio/x-mpegurl, autant d'URL que de chaînes annoncées), guide XMLTV, API de gestion refusée sans session (401), jeton erroné → 404, « nouvelle adresse » → l'ancienne répond 404. - Validation « comme une télé » depuis le réseau de la maison : playlist réelle « Québec et Canada français » (favoris + Canada en français, flux disponibles seulement) téléchargée sans session, puis chaque flux ouvert avec ffprobe (le moteur de VLC et Kodi) : 10 sur 10 lisibles (Canal de l'Assemblée nationale, CPAC, ICI Télé, ICI RDI, Savoir média, TVA, Stingray Classica…) ; guide : 152 programmes pour 4 de ces chaînes.
- Non vérifié : l'import dans une vraie application de téléviseur (TiviMate, IPTV Smarters, Smart IPTV, Apple TV…) et leur
lecture du guide ; le comportement des options
http-referrer/http-user-agentdépend de chaque application.
Blocages et fonctionnalités non vérifiées
| Sujet | État |
|---|---|
| NAS Ugreen | injoignables le 2026-11-16 : aucun montage sur les nœuds, port SMB fermé aux adresses connues, adresses MAC absentes du réseau. La lecture depuis un vrai partage SMB n'a donc pas été testée. Procédure de raccordement : DEPLOYMENT.md |
| TMDB | aucune clé disponible : le code d'enrichissement (TMDB_API_KEY) n'a jamais été exécuté |
| Affiches haute résolution | celles de Wikimedia Commons et de l'ONF ; beaucoup de films anciens n'ont qu'une vignette Internet Archive ou une image fixe |
| Synopsis | Wikipédia a limité le débit pendant l'import : une partie des films n'a pas encore de synopsis ; une seconde passe est faite à chaque import |
| Sous-titres des films distants | fichiers .srt d'Internet Archive convertis en WebVTT : couvert par test unitaire et par la bibliothèque, pas rejoué en E2E sur un film distant |
| ONF | reprise de lecture, sous-titres et vitesse sont ceux du lecteur de l'ONF (SP TV n'y a pas accès) ; la vérification de gratuité a écarté 98 films sur 3 477 ; elle repose sur ce que le lecteur annonce (source et durée), pas sur une information tarifaire officielle |
| Films en WebM (Wikimedia Commons) | non lus sur les Safari anciens ; l'application le dit |
| Avance rapide pendant une conversion | impossible au-delà de la partie déjà convertie tant que la conversion n'est pas terminée |
| Chrome / Edge officiels, vrai iPhone, AirPlay, Android TV, Smart TV, PWA installée | toujours non testés (voir tableau de la version 1) |
| Pluto TV hors Safari | en-tête CORS figé par Pluto : lisible avec le lecteur natif de Safari, pas avec hls.js |
| TV5MONDE Info | même contrainte (CORS réservé à tv5monde.com) |
Guides québécois supplémentaires (iptv-epg.org, xmltvfr.fr) |
identifiés, non intégrés (table de correspondance d'identifiants à écrire) |
| Recommandations | les rangées sont thématiques et tournent chaque jour ; « Populaires dans votre bibliothèque » n'apparaît qu'avec de vraies lectures. Pas de moteur de recommandation personnalisé |
Version 3.0 — validation du 2026-11-17
pnpm test # 63 tests unitaires et d'intégration
SPTV_URL=https://tv.spboucher.ai SPTV_PASSWORD='…' node_modules/.bin/playwright test # app.spec.ts, vod.spec.ts, engine.spec.tsSuite de bout en bout en production : 90 réussis, 2 exclus sur 92 (23 scénarios × Chromium, Firefox, WebKit iPhone, WebKit iPad ; mêmes exclusions qu'avant).
| # | Exigence du cahier des charges | Comment | Résultat |
|---|---|---|---|
| 1 | Audit de l'application existante | architecture conservée ; migrations 4 et 5 appliquées sur la base de production ; clé d'accès, playlist M3U, réglages conservés | fait |
| 2 | Vérifier les sources actuelles | synchronisation en production : 11 sources actives sans erreur, 11 650 chaînes, 0 flux non vérifié | fait |
| 3 | Nouvelles sources autorisées | ARTE et NASA intégrés ; étude des services gratuits (tableau dans SOURCES.md) ; dearbulut et iptv-restream toujours refusés (motifs mesurés) | fait |
| 4 | Import des catalogues | tâche sources en production (7 min 16) : ARTE 393 programmes listés → 310 programmes + 33 séries (373 épisodes) retenus, 41 refusés (37 extraits ou dossiers sans vidéo, 2 sans flux, 1 hors droits, 1 indisponible) ; NASA 516 trouvées → 500 importées, 9 écartées, 4 erreurs |
fait |
| 5 | Lecture réelle | ARTE : « “Mission : Impossible” en 8 minutes — Blow up » lu dans le lecteur officiel (Firefox, WebKit iPhone, WebKit iPad) ; un film et une série ARTE lus en local ; NASA : vidéo lue depuis images-assets.nasa.gov (Firefox, WebKit) ; MPEG-DASH : 2TV, AsianBox, Antena 3 lus en production (Firefox, dash.js) |
réussi |
| 6 | Fournisseurs configurés | aucun fournisseur réel n'est configuré (pas d'abonnement fourni). L'adaptateur est exercé contre un faux portail local qui implémente l'API documentée : test de connexion, refus d'un mauvais mot de passe sans l'afficher, import des chaînes, films et séries, résolution des adresses, désactivation, suppression (tests unitaires) | adaptateur vérifié, pas un fournisseur |
| 6b | Jellyfin | aucun Jellyfin sur le cluster ; connecteur testé contre un vrai serveur Jellyfin 12.4 lancé temporairement sur le poste de développement : connexion (bon et mauvais mot de passe), import de 3 films avec affiches, lecture directe (MP4) et lecture transcodée par Jellyfin (MKV H.264, MKV HEVC 10 bits) dans Firefox | réussi en local ; les séries n'ont pas été importées dans ce test (Jellyfin ne les avait pas indexées) |
| 7 | Films et séries | E2E v2 rejoués (lecture, reprise, épisodes) + série ARTE avec épisodes | réussi |
| 8 | Guide TV | E2E v1 ; 759 chaînes avec programmes | réussi |
| 9 | Favoris et historique | E2E v1 / v2 | réussi |
| 10 | Sécurité | routes du moteur et de redirection fermées sans session ni ticket (401) ; adresses internes, absence de déclaration d'autorisation et type inconnu refusés (400) ; mot de passe d'essai absent de la réponse ; identifiants chiffrés illisibles dans la base et absents de la liste des sources (tests unitaires) ; source intégrée non supprimable | réussi |
| 11 | Déploiement | mld inchangé, dashjs ajouté, redémarrage des deux services, santé 200 |
fait |
| 12 | Rapport avant / après | RAPPORT-AVANT-APRES.md |
fait |
Écrans : Admin → Sources (ajout, test, priorité, suppression d'une source de type « flux » par l'API puis vérification à l'écran), Sports, Paramètres, liens vers les services officiels — E2E sur les 4 profils. Un débordement horizontal de 18 px sur iPhone dans la section des services officiels a été trouvé par ce test et corrigé.
Non vérifié en v3.0
- Un vrai fournisseur à API compatible Xtream (chaînes, films, guide, lecture) et la lecture de ses flux dans hls.js (beaucoup de portails n'envoient pas d'en-têtes CORS : lecture possible dans Safari et dans les applications de télé).
- Jellyfin : lecture depuis un vrai téléphone ou une télé ; ses sous-titres ; l'interface web de Jellyfin sous
/jellyfin/au-delà du contrôle d'accès (307 sans session, 200 avec). - ARTE : le retrait automatique à l'échéance des droits (codé et testé sur la requête, aucun titre n'a encore expiré) ; la reprise de lecture (gérée par le lecteur d'ARTE).
- NASA : durée des vidéos (l'API ne la fournit pas : elles sont classées comme courts métrages) ; sous-titres en lecture.
- Import d'un fichier M3U par l'écran (le connecteur est couvert par les tests unitaires, pas par un test navigateur).
- MPEG-DASH hors Firefox (dash.js fonctionne aussi dans Chrome et Safari, non testé ici) ; les flux DASH protégés par DRM échouent avec un message explicite.
- Tout ce qui était déjà non vérifié : vrais appareils, AirPlay, Chrome et Edge officiels, Smart TV, NAS.
Ajouts du 2026-11-17 (Jellyfin sur le cluster, TMDB)
| Élément | Test réel | Résultat |
|---|---|---|
Jellyfin 12.4 installé sur m4mn (/jellyfin, port 8096) |
source « Jellyfin (m4mn) » : tâche sources n° 24 |
3 films, 1 série, 3 épisodes importés |
| Lecture Jellyfin en production (Firefox, https://tv.spboucher.ai) | Big Buck Bunny (lecture directe), Cosmos Laundromat et Sintel (HLS transcodé par Jellyfin) : l'horloge avance | 3/3 lus, redirection 302 /api/provider/media/… avec ticket signé |
Accès à /jellyfin/ |
sans session SP TV, puis avec | 307 vers /connexion, puis 200 |
| TMDB (clé du propriétaire) | passe complète sur 6 275 titres en production (7 min) | 3 713 reconnus, 2 936 affiches et 80 synopsis ajoutés ; les titres non reconnus restent inchangés |
| Suite de bout en bout en production après ces changements | 92 cas (Chromium, Firefox, WebKit iPhone et iPad) | 90 réussis, 2 exclus prévus |
Limite : les trois films de démonstration existent deux fois (bibliothèque intégrée et Jellyfin).