ライフサイクル
ウィンドウごとの有効化・停止・リソースの後始末
Feature は ESM から任意の activate()・deactivate() を export します。activate() で API への登録を行い、deactivate() で自分が作ったタイマー・接続・DOM 資源などを片付けます。完全なコードはテンプレートにあります。
実行するウィンドウ
メインウィンドウと各ノートウィンドウに、それぞれ PluginHost と JS 実行環境があります。有効・互換・同意済みのプラグインは、それぞれのウィンドウで有効化されます。設定ウィンドウはプラグインのコードを実行しません。モジュール変数はウィンドウ間の共有ストレージではなく、同じコマンドや購読もウィンドウごとに存在します。
起動順はインストール済み一覧の読み込み順です。更新・開発プラグインの再読み込みでは version / generation が変わり、旧セッションを停止してから新しいセッションを読み込みます。
時間制限と例外
activate()・deactivate()・ホストからのコマンド実行は10秒でタイムアウトします。同期例外と Promise の reject も失敗として扱います。有効化に失敗した場合はそのプラグインの登録を巻き戻し、無効化してエラーを表示します。activate() が完了していないプラグインに deactivate() は呼びません。
停止では、deactivate() が失敗・タイムアウトしても登録解除を続行します。CSS、テーマ、パネル、Markdown、エディタ、コマンド、ツールバー、キー、通知購読はホストがセッション単位で解除します。ただし、任意の JavaScript や未完了 Promise を強制終了する仕組みではありません。自作タイマー・通信などは自分でもキャンセルしてください。
パネルの描画
render(container) はビュー表示時に呼ばれ、返した関数はタブ切り替え・パネルを閉じる・プラグイン停止時に呼ばれます。再表示時は再び render されるため、以前の container に依存しない設計にします。描画の同期例外はそのパネル内のエラーとして隔離されます。render 後の独自の非同期処理はこの try/catch の対象外です。
activate() にネットワークやユーザー操作待ちを入れず、必要な処理はコマンド実行に分けてください。サンプルの通信・ノート操作は有効化時に副作用を起こしません。