everything-claude-code/docs/ja-JP/rules/arkts/testing.md

paths

paths
**/*.ets **/*.ts **/ohosTest/**

HarmonyOS / ArkTS テスト

このファイルは common/testing.md を HarmonyOS 固有のテストプラクティスで拡張します。

テストフレームワーク

HarmonyOS は @ohos.test 機能を持つ組み込みテストフレームワークを使用する:

• ユニットテスト: src/ohosTest/ets/test/ に配置
• UI テスト: コンポーネントテストには @ohos.UiTest を使用
• インストルメントテスト: デバイス/エミュレーターで実行

テストディレクトリ構成

module/
  |-- src/
  |   |-- main/ets/          # プロダクションコード
  |   |-- ohosTest/ets/      # テストコード
  |       |-- test/
  |       |   |-- Ability.test.ets
  |       |   |-- List.test.ets
  |       |-- TestAbility.ets
  |       |-- TestRunner.ets

テストの実行

# モジュールのすべてのテストを実行する
hvigorw testHap -p product=default

# 接続されたデバイスでテストを実行する
hdc shell aa test -b com.example.app -m entry_test -s unittest /ets/TestRunner/OpenHarmonyTestRunner

ユニットテストの例

import { describe, it, expect } from '@ohos/hypium';

export default function UserViewModelTest() {
  describe('UserViewModel', () => {
    it('should_initialize_with_empty_state', 0, () => {
      const vm = new UserViewModel();
      expect(vm.userName).assertEqual('');
      expect(vm.isLoading).assertFalse();
    });

    it('should_update_user_name', 0, () => {
      const vm = new UserViewModel();
      vm.updateUserName('Alice');
      expect(vm.userName).assertEqual('Alice');
    });

    it('should_handle_empty_input', 0, () => {
      const vm = new UserViewModel();
      vm.updateUserName('');
      expect(vm.userName).assertEqual('');
      expect(vm.hasError).assertFalse();
    });
  });
}

UI テストの例

import { describe, it, expect } from '@ohos/hypium';
import { Driver, ON } from '@ohos.UiTest';

export default function HomePageUITest() {
  describe('HomePage_UI', () => {
    it('should_display_title', 0, async () => {
      const driver = Driver.create();
      await driver.delayMs(1000);

      const title = await driver.findComponent(ON.text('Home'));
      expect(title !== null).assertTrue();
    });

    it('should_navigate_to_detail_on_click', 0, async () => {
      const driver = Driver.create();
      const button = await driver.findComponent(ON.id('detailButton'));
      await button.click();
      await driver.delayMs(500);

      const detailTitle = await driver.findComponent(ON.text('Detail'));
      expect(detailTitle !== null).assertTrue();
    });
  });
}

HarmonyOS 向け TDD ワークフロー

HarmonyOS に適応した標準 TDD サイクルに従う:

1. RED: ohosTest/ets/test/ に失敗するテストを書く
2. GREEN: main/ets/ にテストを通過するための最小限のコードを実装する
3. REFACTOR: テストをグリーンに保ちながらクリーンアップする
4. ビルド: hvigorw assembleHap を実行してコンパイルを確認する
5. VERIFY: デバイス/エミュレーターでテストを実行する

テストカバレッジ要件

• すべての重要なアプリケーションコード（ViewModels、サービス、ユーティリティ）で最低 80% のカバレッジ
• ユニットテスト: すべてのユーティリティ関数、ViewModel ロジック、データモデル
• 統合テスト: API 呼び出し、データベース操作、クロスモジュールインタラクション
• E2E / UI テスト: 重要なユーザーフロー（ログイン、ナビゲーション、データ送信）
• エッジケースのテスト: 空のデータ、ネットワークエラー、パーミッション拒否

テストのベストプラクティス

• テストを独立させる — テスト間で共有のミュータブルな状態を持たない
• ユニットテストではネットワーク呼び出しとシステム API をモックする
• 意味のあるテスト名を使用する: should_[期待される動作]_when_[条件]
• V2 状態管理のリアクティビティをテストする: @Trace プロパティが UI 更新をトリガーすることを確認する
• Navigation フローをテストする: NavPathStack のプッシュ/ポップ/置き換え操作を確認する
• フレームワーク内部のテストは避ける — ビジネスロジックとユーザーが見える動作に集中する