Polyfills

Diese Seite beschreibt MDNs Richtlinien für die Aufnahme von Polyfills in die Referenzdokumentation für JavaScript und Web-APIs.

Ein Polyfill ist eine Implementierung einer Webplattform-Funktion, die Websites in Browsern verwenden können, die diese Funktion nicht nativ unterstützen. Polyfills ermöglichen es Webentwicklern, eine einzige Codebasis zu erstellen, die auf mehrere Browser und Browserversionen abzielt, selbst wenn einige dieser Browser einige der verwendeten Funktionen nicht unterstützen.

Polyfills sind für Webentwickler wichtig, stellen aber auch ein Risiko dar: fehlerhafte Polyfills können Websites beschädigen oder Sicherheitslücken schaffen. Aus diesem Grund empfiehlt MDN spezielle Quellen für Polyfills und ist sehr vorsichtig bei der Aufnahme zusätzlicher Quellen.

Polyfills in der JavaScript-Referenz

Ausgewählte Polyfills

Die JavaScript-Referenzdokumentation kann auf Polyfills aus zwei Quellen verlinken:

Die core-js Bibliothek.
Die es-shims Organisation.

Quellen werden von den MDN-Maintainern nach folgenden Kriterien ausgewählt:

Konformität zur Spezifikation der Funktion, für die sie eine Implementierung bereitstellen.
Verbreitung in der Webentwickler-Community, basierend auf Metriken wie der Anzahl der npm Downloads.

Vorschlag einer zusätzlichen Polyfill-Quelle

Jeder kann vorschlagen, dass MDN eine zusätzliche Quelle für Polyfills anerkennt, indem er eine Diskussion im MDN-Diskussionsforum startet. Die MDN-Maintainer erwarten jedoch, dass die Anzahl der anerkannten Polyfills, die von MDN verlinkt werden, sehr gering bleibt, um das Risiko zu verringern, Polyfills zu empfehlen, die Probleme für Webentwickler verursachen.

Integration von Polyfills in Seiten

Wenn eine Seite in der JavaScript-Referenzdokumentation auf ein Polyfill verlinkt, wird der Link im Abschnitt "Siehe auch" am Ende der Seite hinzugefügt.

Der Link wird am Anfang der "Siehe auch"-Liste im folgenden Format platziert:

- [Polyfill for `featureName` in `project-name`](link)