
# テスト

`package:spring_boot_starter_flutter_security/testing.dart` は、`spring_security_core` のテストヘルパー `withMockUser`、`withAuthentication`、`withAnonymousUser` を再エクスポートします。アプリのテストに他の依存関係は不要です。ウィジェットテストでは、パッケージの Bean は他の Bean と同じように置き換えます。

## 使う理由

ガードされたサービス、`PrincipalView`、ガードされた画面のテストには、プロバイダーやログインウィンドウなしのユーザーが必要です。ヘルパーはユーザーとしてコードを実行し、Bean のオーバーライドは、テストのマシンにないプラットフォームの部品 (安全なストレージ、ウィンドウ) を置き換えます。

## 例

```dart
import 'package:spring_boot_starter_flutter_security/testing.dart';
import 'package:test/test.dart';

void main() {
  test('an admin sees the orders', () async {
    await withMockUser(() async {
      expect(await orders.all(), isNotEmpty);
    }, roles: ['ADMIN']);
  });
}
```

## ウィジェットテストでのフェイク

パッケージのすべての Bean は、アプリケーションがその型のものを宣言すると身を引き、`springBootTest(overrides:)` がそれらを置き換えます。

```dart
final app = springBootTest(
  springApplication,
  overrides: [
    BeanOverride<SecretStore>(InMemorySecretStore()),   // テストのマシンにキーチェーンはない
    BeanOverride<OAuth2LoginService>(FakeLoginService()), // プロバイダーなし
  ],
);
```

| Bean | 置き換えるもの |
|---|---|
| `SecretStore` | `InMemorySecretStore` |
| `OAuth2LoginService` | ユーザーを `SecurityContextHolder` に置くフェイク |
| `AuthorizationWindow` | リダイレクトで応答するフェイク。偽のプロバイダーに対して本物のログインのサービスをテストするため |
| `DPoPKey` | Dart で作った鍵 |

`PrincipalNotifier` は `SecurityContextHolder` に従うので、`withMockUser` も偽のログインも、`PrincipalBuilder` と `PrincipalView` を再ビルドします。

## Spring (Java) との対応

`spring-security-test` の `@WithMockUser` です。

## 関連項目

- [spring_boot_starter_flutter でのテスト](../spring-boot-starter-flutter/testing.md)
- [spring_boot_starter_test](../spring-boot-starter-test/index.md)
