Laravel 10.x コンソールテスト

イントロダクション

Laravelは、HTTPテストを簡素化することに加え、アプリケーションのカスタムコンソールコマンドをテストするためのシンプルなAPIも提供します。

実行成功／失敗のアサート

手始めに、Artisanコマンドの終了コードをアサートする方法を見てみましょう。それには、artisanメソッドを使用して、テストからArtisanコマンドを呼び出します。それから、assertExitCodeメソッドを使用して、指定した終了コードでコマンドが完了することをアサートします。

/**
 * コンソールコマンドのテスト
 */
public function test_console_command(): void
{
    $this->artisan('inspire')->assertExitCode(0);
}

コマンドが指定コードで終了しないことをアサートするには、assertNotExitCodeメソッドを使用します。

$this->artisan('inspire')->assertNotExitCode(1);

もちろん、すべてのターミナルコマンドは通常、成功した場合に0のステータスコードで終了し、成功しなかった場合には０以外の終了コードで終了します。したがって、使い勝手が良いようにassertSuccessfulとassertFailedのアサーションを利用し、コマンドが成功の終了コードで終了した／終了しなかったことをアサートできます。

$this->artisan('inspire')->assertSuccessful();

$this->artisan('inspire')->assertFailed();

入力/出力の期待値

LaravelでexpectsQuestionメソッドを使用すれば、コンソールコマンドのユーザー入力を簡単に「モック」できます。さらに、終了コードをassertExitCodeメソッドで、コンソールコマンドに期待する出力をexpectsOutputメソッドでそれぞれ指定することもできます。

Artisan::command('question', function () {
    $name = $this->ask('What is your name?');

    $language = $this->choice('Which language do you prefer?', [
        'PHP',
        'Ruby',
        'Python',
    ]);

    $this->line('Your name is '.$name.' and you prefer '.$language.'.');
});

このコマンドは、expectsQuestion、expectsOutput、doesntExpectOutput、expectsOutputToContain、doesntExpectOutputToContain、assertExitCodeメソッドを利用する以下の例でテストできます。

/**
 * コンソールコマンドのテスト
 */
public function test_console_command(): void
{
    $this->artisan('question')
         ->expectsQuestion('What is your name?', 'Taylor Otwell')
         ->expectsQuestion('Which language do you prefer?', 'PHP')
         ->expectsOutput('Your name is Taylor Otwell and you prefer PHP.')
         ->doesntExpectOutput('Your name is Taylor Otwell and you prefer Ruby.')
         ->expectsOutputToContain('Taylor Otwell')
         ->doesntExpectOutputToContain('you prefer Ruby')
         ->assertExitCode(0);
}

確認の期待

「はい」または「いいえ」の回答の形式で確認を期待するコマンドを作成する場合は、expectsConfirmationメソッドを使用できます。

$this->artisan('module:import')
    ->expectsConfirmation('Do you really wish to run this command?', 'no')
    ->assertExitCode(1);

テーブルの期待

コマンドがArtisanのtableメソッドを使用して情報のテーブルを表示する場合、テーブル全体の出力期待値を書き込むのは面倒な場合があります。代わりに、expectsTableメソッドを使用できます。このメソッドは、テーブルのヘッダを最初の引数として受け入れ、テーブルのデータを２番目の引数として受け入れます。

$this->artisan('users:all')
    ->expectsTable([
        'ID',
        'Email',
    ], [
        [1, 'taylor@example.com'],
        [2, 'abigail@example.com'],
    ]);

コンソールイベント

デフォルトでは、アプリケーションのテスト実行中は、Illuminate\Console\Events\CommandStartingとIlluminate\Console\Events\CommandFinishedはデフォルトでディスパッチしません。しかし、テストクラスへIlluminate\Foundation\Testing\WithConsoleEventsトレイトを追加すれば、これらのイベントを有効にできます：

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\WithConsoleEvents;
use Tests\TestCase;

class ConsoleEventTest extends TestCase
{
    use WithConsoleEvents;

    // ...
}