メインコンテンツへ飛ぶ

テスト

私達は Electron のコード網羅率を維持することを目指しています。 すべてのプルリクエストは、既存のすべてのテストに合格するだけでなく、変更されたコードと新しいシナリオをカバーする新しいテストを追加することを推奨します。 できるだけ多くのコードパスと Electron のユースケースを確保することで、より少ないバグでアプリを出荷することができます。

このリポジトリには、JavaScript と C++ の両方に対する lint ルール、同様に対応するユニットテストと統合テストが付属しています。 Electron のコーディングスタイルの詳細については、コーディングスタイル ドキュメントを参照してください。

Lint

JavaScript が Electron コーディングスタイルに準拠していることを確認するには、npm run lint-js を実行します。これは、Electron 自身とユニットテストの両方に対し standard を実行します。 プラグイン/アドオンシステムを備えたエディタを使用している場合は、多くの StandardJS アドオン にコーディングスタイルの違反が通知されます。

引数つきで standard を実行するには、npm run lint-js --standard に渡したい引数を続けて書いて実行します。

C++ が Electron コーディングスタイルに準拠していることを確認するには、npm run lint-cpp を実行します。これは、cpplint スクリプトを実行します。 clang-format と用意された 短いチュートリアル を使うことを推奨します。

このリポジトリに Python が多数あるわけではありませんが、これもコーディングスタイル規則によって管理されています。 npm run lint-py を実行すれば、pylint を使ってすべての Python をチェックします。

単体テスト

build-tools を使用していない場合は、Electron のローカルビルド用コンフィグ名を確認してください。これは、TestingReleaseDefaultDebug、設定した process.env.ELECTRON_OUT_DIR のいずれかです。 これらをセットしていないと、Electron はテスト前の手順を実行できないことがあります。

すべてのユニットテストを実行するには、npm run test を実行します。 ユニットテストは spec フォルダにある Electron アプリ (オドロキ!) です。 その package.json もあり、その依存関係はトップレベルの package.json には定義されていないことに注意してください。

パターンに一致する特定のテストだけを実行するには、npm run test -- -g=PATTERN で、PATTERN を実行したいテストに一致する正規表現に置き換えて実行します。 例として、IPC テストのみを実行したい場合は、npm run test -g ipc を実行します。

Windows 10 デバイス上でテスト

単体テストを実行するための追加手順:

  1. Visual Studio 2019 をインストールする必要があります。

  2. Node ヘッダーは構成に合わせてコンパイルする必要があります。

    ninja -C out\Testing third_party\electron_node:headers
  3. electron.lib を node.lib としてコピーする必要があります。

    cd out\Testing
    mkdir gen\node_headers\Release
    copy electron.lib gen\node_headers\Release\node.lib

フォントの欠落

一部の Windows 10 デバイス はメイリオフォントがインストールされていない状態で出荷されるため、フォントフォールバックテストが失敗する可能性があります。 メイリオをインストールするには以下のようにします。

  1. Windows キーを押して オプション機能の管理 と検索します。
  2. 機能の追加 をクリックします。
  3. 日本語追加フォント を選択して インストール をクリックします。

ピクセル測定

正確なピクセル測定値に依存するようなテストは、浮動小数点精度の誤差のために Hi-DPI 画面設定のデバイスでは正しく動作しない場合があります。 これらのテストを正常に実行するには、そのデバイスが倍率 100% に設定されていることを確認してください。

ディスプレイ倍率を設定するには、

  1. Windows キーを押して ディスプレイの設定 と検索します。
  2. スケールとレイアウト で、そのデバイスが 100% に設定されていることを確認します。