> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# 콘솔 테스트

> Laravel에서 Artisan 명령을 테스트하는 방법(입출력 기대값, 종료 코드 검증, 콘솔 이벤트 검증)을 배웁니다.

# 콘솔 테스트

Laravel에서는 Artisan 명령에 대해 입력·출력을 포함한 테스트를 간결하게 작성할 수 있습니다.

<Info>
  이 페이지는 Laravel 최신 콘솔 테스트 API에 맞춰져 있으며, Laravel Prompts의 검색 입력을 검증하는 `expectsSearch`도 다룹니다.
</Info>

## 소개

`artisan` 메서드로 명령을 실행하고 기대값을 체이닝하여 검증합니다.

<Tabs>
  <Tab title="Pest">
    ```php theme={null}
    test('question 명령', function () {
        // 사용자 입력과 출력을 순서대로 검증한다
        $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.')
            ->assertExitCode(0);
    });
    ```
  </Tab>

  <Tab title="PHPUnit">
    ```php theme={null}
    public function test_question_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.')
            ->assertExitCode(0);
    }
    ```
  </Tab>
</Tabs>

```mermaid theme={null}
flowchart TD
    A[artisan으로 명령 실행] --> B[입력 기대값 정의]
    B --> C[출력 또는 테이블 검증]
    C --> D[종료 상태 검증]
```

## 성공 / 실패 어서션

종료 상태를 검증하여 명령의 성공·실패를 판정할 수 있습니다.

```php theme={null}
$this->artisan('inspire')->assertExitCode(0);
$this->artisan('inspire')->assertSuccessful();
$this->artisan('inspire')->assertFailed();
```

## 입력 / 출력 기대값

### 입력 기대값

질문 입력이나 검색 입력에 대한 사용자 조작을 모의할 수 있습니다.

```php theme={null}
// 질문 입력과 검색 입력을 모두 모의한다
$this->artisan('example')
    ->expectsQuestion('What is your name?', 'Taylor Otwell')
    ->expectsSearch('What is your name?', search: 'Tay', answers: [
        'Taylor Otwell',
        'Taylor Swift',
        'Darian Taylor',
    ], answer: 'Taylor Otwell')
    ->assertExitCode(0);
```

### 출력 기대값

출력 문자열의 완전 일치·부분 일치·테이블 표시를 검증할 수 있습니다.

```php theme={null}
// 기대하는 출력만 표시되는지 확인한다
$this->artisan('users:all')
    ->expectsOutput('The expected output')
    ->doesntExpectOutput('Unexpected output')
    ->expectsOutputToContain('expected')
    ->expectsTable([
        'ID',
        'Email',
    ], [
        [1, 'taylor@example.com'],
        [2, 'abigail@example.com'],
    ])
    ->assertExitCode(0);
```

## 확인 프롬프트 기대값

Yes / No 확인 프롬프트에는 `expectsConfirmation`을 사용합니다.

```php theme={null}
$this->artisan('module:import')
    ->expectsConfirmation('Do you really wish to run this command?', 'no')
    ->assertExitCode(1);
```

## 콘솔 이벤트

기본적으로 테스트 실행 시에는 `CommandStarting` / `CommandFinished`가 발생하지 않습니다.

이벤트 검증이 필요한 테스트 클래스에는 `WithConsoleEvents`를 추가합니다.

```php theme={null}
<?php

namespace Tests\Feature;

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

class ConsoleEventTest extends TestCase
{
    use WithConsoleEvents;
}
```

<Tip>
  `WithConsoleEvents`는 필요한 테스트에 한정해서 사용하면 일반 테스트 속도를 유지하기 쉬워집니다.
</Tip>


## Related topics

- [Artisan 콘솔](/ko/artisan.md)
- [브라우저 테스트(Dusk)](/ko/dusk.md)
- [테스트](/ko/packages/laravel-bluesky/testing.md)
- [Laravel Prompts](/ko/prompts.md)
- [HTTP 테스트](/ko/http-tests.md)