jest-hands-on/src/basic-jest-api.md

# 基本的な機能

Jestの機能について説明します。

## テストファイルの検出

Jestは、デフォルトで下記のファイルをテストファイルとして検出します。

- 名前の末尾に `.test` あるいは `.spec` の含まれる `.js`、`.jsx`、`.ts`、`.tsx` ファイル
- `__tests__` ディレクトリ以下の `.js`、`.jsx`、`.ts`、`.tsx` ファイル

## テストの自動監視

`--watchAll` オプションを指定することで、テストファイルの変更を自動で監視します。

```bash
npx jest --watchAll
```

終了するには、キーボードの `q` を押します。

## プロジェクトでのテストコマンドの設定

この設定を行うと、`npm test` コマンドでJestを実行できるようになります。

```bash
npm set-script test jest
```

実行すると、`package.json` には下記のような設定が追加されます。

```json
{
  "scripts": {
    "test": "jest"
  }
}
```

NPMコマンドでのテストの実行:

```bash
npm test
```

`npx jest` コマンドの実行と同様のテスト結果が得られます。