2026 Bun 1.4.4 --changedでメール認証テストがスキップされたときの対処法

変更範囲を先に確定する

Bun 1.4の説明では、--changedは変更を基準にテスト対象を絞る仕組みとして扱われています。どの比較基準が使われたか、今回の差分に何が含まれるかを確認せず、単にコマンドが成功したという理由でメール回帰一式が走ったと判断するのは危険です。Bun 1.4のリリース説明とテストの公式ドキュメントで、対象バージョンの説明とコマンドの使い方を照合してください。

まず、ローカルとCIで実行したコマンド、比較基準、変更ファイル一覧を記録します。Bunのバージョンが異なる環境を比べる場合は、その差も残してください。公式のv1.4.4リリースにある安定性修正は確認材料になりますが、個々のプロジェクトでメールテストが選ばれない原因まで特定するものではありません。

変更とテストの関連を確認する

メールテンプレート、登録処理、検証リンクやコードの処理が変更されたら、それぞれを利用するコードとテストファイルの関係を追います。テストが対象モジュールを直接インポートしていれば関連が見えやすい一方、設定ファイル、生成物、実行時に組み立てる依存関係が間に入ると、ランナーが認識する範囲と開発者が想定する範囲が一致しないことがあります。

そこで、テンプレート変更から送信処理、テストファイルまでをたどり、どの依存がコード上で読み取れるのかを確認します。明示的な依存関係がない場合は、増分テストの選択だけにメール回帰を任せず、重要なケースを個別に実行する経路を用意します。

実行された証拠を比較する

次に見るのはコマンドの終了状態ではなく、選ばれたテストファイルと実行されたテスト名です。CIログやテストレポートで、メール関連のケースが本当に動いたかを差分ファイルと突き合わせます。ログに対象ファイルが載っていても、その中のメール関連テストが条件分岐などで実行されなかった可能性は残ります。

Bunの設定や実行対象の指定を変えている場合は、テスト設定の公式資料も確認します。確認できたテスト一覧を差分ファイルと並べ、漏れたメール関連ケースがあれば、統合テストの実行対象として別に記録してください。

判定条件から増分実行と明示実行を選ぶ

• メール処理とテストの依存関係が追え、ログ上でも関連テストのケースまで確認できるなら、--changedを速いフィードバックとして使います。
• 依存関係が設定・生成物・実行時の組み立てに隠れているなら、増分実行だけで判断せず、メール関連のテストファイルを明示して実行します。
• リリース判定に必要なメール経路が実行されたとログから確かめられないなら、専用の統合テストを追加実行し、増分テストの成功とは分けて記録します。
• 外部の受信箱で読めることまで確認したいなら、テスト成功を受信証拠に置き換えず、管理下の受信先を使った確認へ進みます。

たとえば、対象ファイルが分かっている場合は、次のようにファイルを指定して実行できます。ファイル名はプロジェクトの構成に合わせて置き換えてください。

bun test ./tests/email-verification.test.ts

CIでも、増分テストのジョブとメール経路を対象にする統合テストのジョブを区別します。比較基準、実行コマンド、実際に選ばれたケースを同じ記録に残せば、「変更分だけの確認」と「メール回帰の確認」が混ざりません。

アプリの成功と実際の受信を切り分ける

メール検証では、何を確認したのかを段階ごとに分けて記録します。アプリがメールを生成したという断言は、本文や宛先データの組み立てを確認する材料です。検証リンクやコードの断言は、内容が期待どおりかを確かめます。アカウント状態の変化は、検証処理の結果を示しますが、外部のメール配送を証明するものではありません。

受信の確認が必要な場合は、自社製品の検証環境から管理下のアドレスへ送り、登録や検証に使ったテストとの対応が分かるようにします。テスト用メールアドレスの選び方や実受信と仮想的な確認の違いは、一時的な受信先と通常のメールアドレスの比較も参考になります。到着状況を確認する場合も、特定のメールが必ず届くとは前提にせず、受信側で見えた内容を独立した証拠として残してください。

CIの合格条件を明文化する

増分実行は、変更に近いテストから素早くフィードバックを得る用途に向いています。一方、公開やリリースの合格条件にメール認証の全経路が含まれるなら、その経路を実行するジョブを別に設定し、増分テストの結果と分けて評価します。

確認時は、CIのコマンド、比較基準、選択されたファイル、ケースごとの結果をひとまとまりで見ます。テンプレートの差分があったのに関連テストが記録されていない場合は、増分テストの成功をそのまま受け入れず、明示実行の結果を追加します。これにより、実行されていないテストを「通過」と扱う誤りを避けられます。

自社製品の試験データに個人情報を使わない運用を整える場合は、テストや通知に使うデータの注意点も確認してください。受信先を分離すれば、テストメールが業務用受信箱に混ざる問題を抑えやすくなります。

FAQ

bun test --changedでメール認証テストが選ばれないのはなぜですか？

--changedは変更ファイルとテストの関連をもとに対象を絞るため、メール処理とテストの依存関係をランナーが追えない場合、関連テストが対象外になることがあります。比較基準と変更ファイルを見直し、実行ログを確認してください。漏れが疑われるケースは、テストファイルを明示して別途実行します。

Bun 1.4.4で変更により選ばれたテストファイルを確認するには？

ローカルまたはCIで使ったコマンドと比較基準を記録し、ログやレポートから実際に開始されたテストファイルを確認します。ファイル名だけで判断せず、メール関連のテスト名と断言結果も照合してください。テストファイルが選択されたことと、その中の対象ケースが実行されたことは別の確認事項です。

メールテンプレートの変更がCIのテスト対象に入ったか、どう調べますか？

テンプレートから送信処理、テストファイルまでの依存関係を確認し、CIログに該当ファイルとケースの実行記録があるか照合します。増分実行で選ばれない可能性が残るなら、メール統合テストを独立したタスクとして実行します。コマンド、比較基準、結果を一緒に記録すると、別ジョブの結果との混同を避けられます。

bun testの成功は、認証メールが実際に届いた証拠になりますか？

いいえ。成功が示すのは、実行されたテストの断言が通ったことです。モックを利用したテストは、外部送信や受信箱での閲覧可能性を確認しません。実際の受信が必要な場合は、自社製品の検証環境から管理下の受信先へ送り、メール内容と今回のテストとの対応を確認してください。

メール認証テストの証拠をそろえるときは、まず公式資料でBunの選択範囲を確認し、次に自社の統合テスト、必要な場合のみ管理下の受信先での確認へ進みます。外部メールを実際に読めるか確かめたい一時的な登録や検証では、登録不要ですぐ使える受信先も選択肢になります。業務用のアドレスを公開せず、テスト由来の不要なメールを普段の受信箱から分けたい場合は、Inboxonceの受信先を受信確認の手段の一つとして利用できます。長期保管や返信が必要な重要アカウントには、通常の管理下にあるアドレスを使ってください。

最終更新：2026年10月30日。Bun v1.4.4の修正内容は公式リリースノート、--changedの説明はBun 1.4のリリース説明と公式テスト資料を基に確認しています。