メインコンテンツへ飛ぶ

実験的な API

Some of Electron's APIs are tagged with _Experimental_ in the documentation. このタグは、その API が不安定であろうと考えられており、他の API に比べて警告をあまりせずに API の削除や変更が頻繁に行われるかもしれないということです。

API が Experimental とタグ付けされる条件

新機能の PR では、誰でも API を実験的なものとしてタグ付けるよう要求できます。新機能が実験的かどうかに関する意見の相違が PR で解決できない場合、API WG で議論にかけることができます。

実験的なタグ付けを取り除くプロセス

その API が安定しており、2 つ以上のメジャー安定版のリリースラインにある場合は、API の実験的なタグ付けの削除指名ができます。 この議論は API WG ミーティングで執り行われます。 議論/指名の際に考慮すべきこと:

  • 上記の "2つのメジャーリリースライン" の条件を満たしていること
  • その間、この機能の採用で大きなバグや問題が発生しなかったこと
  • API が十分に安定しており、Chromium のアップグレードに大きな影響を受けないこと
  • その API を使う人がいるのかどうか
  • API は提案当初のユースケースを満たしていて、かけ離れていないどうか