Web Platform Tests et confiance dans les fonctions navigateur
Combinez Web Platform Tests, vérifications d’exécution et assertions applicatives pour évaluer une fonction navigateur.
BotBrowser Team
Vous voulez la documentation structurée pour Plateforme ?
Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.
Web Platform Tests fournit une preuve de conformité dans des conditions déclarées, mais ne garantit pas chaque parcours applicatif. Séparez spécification, test partagé, vérification locale et signal visible de l’application. Une capacité ne révèle ni identité ni appareil. BotBrowser peut fournir un profil contrôlé pour exécuter des vérifications de capacités ; il ne peut pas changer la façon dont une norme définit une capacité ni dont un autre navigateur l’implémente.
Résumé
- Un test WPT qui passe démontre un algorithme sous l'origine, le harness et le moment déclarés, et non qu'un parcours produit aboutira.
- Lisez d'abord les métadonnées : une entrée tentative, instable ou marquée comme échec attendu est une question de couverture, et un test ignoré pour une origine non sécurisée ou un geste utilisateur absent ne devient pas une cellule verte.
- Gardez distincts les cinq états, missing, available, denied, failed et completed, car une méthode présente ne dit rien d'une autorisation accordée ni d'un enregistrement côté serveur.
- Prouvez la moitié applicative séparément : une réponse
201avec en-têteLocation, une annonce dans un élément portantrole="status"etaria-live="polite", et un contrôle de repli atteignable au clavier. - Consignez dans un même registre le chemin WPT, la section de spécification, la compilation du navigateur, la version du harness, la révision du fixture et la date du résultat, puis rejouez le sous-ensemble dès que l'un d'eux change.
Sommaire
- Choisir la preuve WPT
- Vérification de capacité
- Tableau de décision
- Fixture d'échec
- Vérification applicative
- BotBrowser : portée
- Conclusion pratique
Choisir la preuve WPT
Consultez le dépôt WPT et l’API testharness. Notez le chemin, la spécification, la version, l’origine, les permissions et la date. Un test omis, expérimental ou attendu en échec exige une alternative. Les fonctions expérimentales proposées par essai sont présentées dans Origin Trials et fonctions expérimentales du Web.
Lisez les métadonnées avec le résultat. Un test local peut différer selon le contexte sécurisé, le geste utilisateur ou la politique de permissions. Vérifiez licence, dépendances et nettoyage avant de réutiliser un fixture.
Vérification de capacité
Testez la méthode nécessaire juste avant l’appel. Distinguez absente, disponible, refusée, échouée et terminée. Une propriété présente ne prouve ni permission, ni service disponible, ni écriture serveur. La différence entre fonction prise en charge et fonction de qualité est traitée dans La prise en charge d’une fonction n’est pas sa qualité.
Conservez la saisie et proposez une action de repli accessible. Notez origine, contexte sécurisé, version, état, repli et résultat visible sans données étrangères.
Tableau de décision
| Observation | Décision | Résultat visible | Limite |
|---|---|---|---|
| WPT réussit dans la matrice | inclure le candidat | essayer après vérification | conformité déclarée |
| WPT omis ou expérimental | revoir les métadonnées | garder le repli | couverture de test |
| Méthode absente ou contexte bloqué | utiliser le repli | garder la tâche | capacité de la page |
| Appel refusé | classer une fois | afficher la récupération | comportement navigateur |
| Appel terminé | vérifier l’application | confirmer le signal visible | navigateur et application |
Fixture d’échec
Le fixture crée ses contrôles, simule uniquement l’API possédée, vérifie le texte visible et supprime les nœuds dans chaque branche. Ne modifiez pas une empreinte et n’envoyez pas d’identifiants.
async function tester() {
const h = document.createElement('div');
h.innerHTML = '<p id="etat"></p><button id="repli" hidden>Utiliser le repli</button>';
document.body.append(h);
const etat = h.querySelector('#etat');
const repli = h.querySelector('#repli');
try {
const ok = typeof navigator.share === 'function';
const resultat = ok
? await navigator
.share({ title: 'Élément synthétique', url: '/fixture' })
.then(() => 'termine')
.catch(() => 'echec')
: 'absent';
etat.textContent = resultat === 'termine' ? 'Terminé' : 'Utilisez le repli';
if (resultat !== 'termine') repli.hidden = false;
console.assert(etat.textContent && (resultat === 'termine' || !repli.hidden));
return resultat;
} finally {
h.remove();
}
}
Vérification applicative
Après l’appel, vérifiez le message, le contrôle ou l’enregistrement appartenant à l’application. Une promesse résolue ne prouve pas une écriture serveur. Séparez les résultats et testez focus, clavier, libellés et récupération.
Répétez la matrice après une version, une spécification, un contexte sécurisé, une permission ou un changement de harness. Pour suivre ces changements de version, voir Notes de version du navigateur pour les équipes web. Conservez le chemin WPT, l’état, le repli et la date sans contenu personnel.
BotBrowser : portée
BotBrowser fournit des contextes contrôlés pour des parcours autorisés inspirés de WPT et des vérifications répétables. Un contexte isolé sépare l’état mutable et compare les résultats visibles.
Il ne certifie pas WPT, n’accorde pas de permissions, ne sécurise pas une origine, ne remplace pas l’infrastructure de conformité et ne prouve pas une transaction serveur. La documentation d’isolation BotBrowser démontre la répétabilité, pas une garantie universelle.
Voir aussi le guide de compatibilité des API et le guide WebDriver BiDi.
BotBrowser peut exécuter des vérifications répétables dans des contextes autorisés inspirés de WPT, mais ne garantit pas la conformité, n’accorde pas de permissions et ne remplace pas la preuve d’une transaction. Gardez les deux limites dans le rapport.
La confiance augmente quand chaque couche a un responsable: spécification, test WPT, matrice de navigateurs, application et fixture. Notez chemin, version, origine, état, repli et résultat visible.
Utilisez l’évidence négative honnêtement. Un test omis, un refus ou un délai doit être classé et ne doit pas devenir un succès caché. Gardez le repli jusqu’à preuve applicative suffisante.
Gardez une fiche concise avec le chemin WPT, la version, le contexte, l’état, l’assertion visible et le repli.
Comparez la version candidate à la précédente avec le même fixture et conservez le premier échec utile.
Indiquez le responsable et la date de revue pour chaque exception.
Nommez le repli visible afin que le support puisse reproduire le résultat.
Rendez le rapport lisible pour une personne qui n’a pas exécuté le navigateur et indiquez limite, résultat et prochaine action.
Cette explication évite de transformer une preuve étroite en promesse universelle.
Notez aussi la date et le responsable de la prochaine vérification.
Ce transfert maintient la confiance à jour.
Le résultat doit conserver la frontière entre conformité et comportement applicatif.
Ne présentez pas un contexte contrôlé comme une garantie universelle.
Sources
Conclusion pratique
Posez une question par couche et notez la réponse : quel algorithme le fichier WPT exerce, quelle méthode la page a réellement atteinte, quel état la vérification de capacité a produit, et quel résultat visible l'application a confirmé. Quand une ligne du tableau de décision a une réponse à chaque couche, la note de version tient ; quand une couche manque, l'entrée honnête est non testé plutôt que validé.
Exécutez d'abord le fixture sur une page synthétique, avec navigator.share simulé et un bouton #fallback masqué, puis conservez les appels console.assert qui vérifient ensemble le texte visible et le repli. Rejouez ensuite le même parcours dans le contexte contrôlé fourni par wpt run --channel dev --log-wptreport wptreport.json, afin que la compilation du navigateur reste à côté des comptes pass, skip et fail au lieu d'un tableau recopié à la main.
Avant la sortie de navigateur suivante, rejouez le sous-ensemble déclaré et comparez les deux registres entrée par entrée. Ne modifiez l'entrée d'un navigateur qu'après lecture de l'écart par le responsable du parcours concerné, et gardez le repli jusqu'à ce que la preuve applicative montre que la voie optionnelle fonctionne sans lui.
Cet article fait partie du guide : Surfaces de la plateforme web : carte de revue
Articles Connexes
La prise en charge d'une fonction n'est pas sa qualité
PlateformeDonnées de compatibilité des API et solutions de repli du navigateur
PlateformeMoteur de navigateur : définition et différences
PlateformeNotes de version du navigateur pour les équipes web
PlateformeSurfaces de la plateforme web : carte de revue
PlateformeOrigin Trials et fonctions expérimentales du Web
Exécutez la même vérification dans BotBrowser
Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.