Aller au contenu principal

API expérimentales

Some of Electron's APIs are tagged with _Experimental_ in the documentation. Cette balise indique que l'API peut ne pas être considérée comme stable et que l'API peut être supprimée ou modifiée plus couramment que les autres API avec moins d'avertissement.

Conditions pour qu'une API soit étiquetée comme expérimentale​

N'importe qui peut demander à ce qu'une API soit étiquetée comme expérimental dans un PR (pull request), les désaccords sur la nature expérimentale d'une fonctionnalité peuvent être discutés dans l'API WG si non résolus suite au PR.

Processus pour supprimer l'étiquette Experimental​

Une fois qu'une API est stable et avec au moins deux lignes de version stable majeures, elle peut être considérée pour supprimer sa balise expérimentale. Cette discussion devrait avoir lieu lors d'une réunion de l'API WG. Choses à considérer lors de la discussion / la nomination :

  • La condition ci-dessus "deux lignes de publication stables majeures" doit avoir été remplie
  • Pendant ce temps, aucun bug / problème majeur n'a dû être causé par l'adoption de cette fonctionnalité
  • L'API est assez stable et n'a pas été fortement impactée par les mises à jour de Chromium
  • Quelqu'un utilise-t-il l'API ?
  • L'API respecte-t-elle les cas d'usage proposés initialement, a-t-elle des lacunes?