Prothèses d'émulation (polyfills)
Cette page présente la politique de MDN concernant l'inclusion de prothèses d'émulation (polyfills) dans la documentation de référence pour JavaScript et les API Web.
Un·e prothèse d'émulation est une implémentation d'une fonctionnalité de la plateforme web que les sites peuvent utiliser dans les navigateurs qui ne prennent pas en charge cette fonctionnalité nativement. Les prothèses d'émulation permettent aux développeur·euse·s web d'écrire une seule base de code ciblant plusieurs navigateurs et versions de navigateurs, même lorsque certains de ces navigateurs ne prennent pas en charge certaines fonctionnalités utilisées.
Les prothèses d'émulation sont importantes pour les développeur·euse·s web mais présentent aussi un risque : des prothèses défectueuses peuvent casser des sites ou créer des failles de sécurité. Pour cette raison, MDN recommande des sources spécifiques de prothèses d'émulation et reste très prudent·e quant à l'ajout de nouvelles sources.
Prothèses d'émulation dans la référence JavaScript
Prothèses sélectionnées
La documentation de référence JavaScript peut lier des prothèses d'émulation provenant de deux sources :
- La bibliothèque core-js (angl.).
- L'organisation es-shims (angl.).
Les sources sont sélectionnées par les mainteneur·euse·s MDN selon les critères suivants :
- Conformité à la spécification de la fonctionnalité pour laquelle elles fournissent une implémentation.
- Adoption par la communauté du développement web, mesurée par des indicateurs comme le nombre de téléchargements sur npm (angl.).
Proposer une nouvelle source de prothèses
Toute personne peut proposer que MDN reconnaisse une nouvelle source de prothèses d'émulation en ouvrant une discussion sur le forum MDN (angl.). Cependant, les mainteneur·euse·s MDN s'attendent à ce que le nombre de prothèses reconnues et liées depuis MDN reste très faible, afin de réduire le risque de recommander des prothèses qui poseraient problème aux développeur·euse·s web.
Intégration des prothèses dans les pages
Lorsqu'une page de la documentation de référence JavaScript lie vers une prothèse d'émulation, le lien est ajouté dans la section « Voir aussi » à la fin de la page.
Le lien est placé au début de la liste « Voir aussi », au format suivant :
- [Prothèse d'émulation pour `featureName` dans `project-name`](lien)
Prothèses d'émulation dans la référence des API Web
Prothèses sélectionnées
La documentation de référence des API Web peut lier des prothèses d'émulation qui sont maintenues avec la spécification de la fonctionnalité elle-même.
Par exemple, l'API Trusted Types dispose d'une prothèse d'émulation maintenue dans le même dépôt que la spécification (angl.). Ainsi, la documentation de référence de l'API Trusted Types sur MDN peut lier cette prothèse.
Intégration des prothèses dans les pages
Les prothèses d'émulation sont généralement intégrées dans la page d'ensemble de l'API.