Skip to content

HTTP 테스트

소개

라라벨은 애플리케이션에 HTTP 요청을 보내고 응답을 검사하기 위한 매우 유연한 API를 제공합니다. 예를 들어, 아래 정의된 기능 테스트를 살펴보십시오:

<?php
test('애플리케이션이 성공적인 응답을 반환하는지 확인', function () {
$response = $this->get('/');
$response->assertStatus(200);
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본적인 테스트 예제.
*/
public function test_the_application_returns_a_successful_response(): void
{
$response = $this->get('/');
$response->assertStatus(200);
}
}

get 메서드는 애플리케이션에 GET 요청을 보내고, assertStatus 메서드는 반환된 응답이 주어진 HTTP 상태 코드를 가져야 하는지 확인합니다. 이 간단한 단언 외에도 Laravel은 응답 헤더, 콘텐츠, JSON 구조 등을 검사하기 위한 다양한 단언을 포함하고 있습니다.

요청 만들기

애플리케이션에 요청을 하려면 테스트 내에서 get, post, put, patch 또는 delete 메서드를 호출할 수 있습니다. 이러한 메서드는 실제로 애플리케이션에 "실제" HTTP 요청을 보내지 않습니다. 대신 전체 네트워크 요청이 내부적으로 시뮬레이션됩니다.

Illuminate\Http\Response 인스턴스를 반환하는 대신 테스트 요청 메서드는 Illuminate\Testing\TestResponse 인스턴스를 반환하며, 이 인스턴스는 애플리케이션의 응답을 검사할 수 있는 다양한 유용한 단언을 제공합니다.

<?php
test('기본 요청', function () {
$response = $this->get('/');
$response->assertStatus(200);
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본 테스트 예시입니다.
*/
public function test_a_basic_request(): void
{
$response = $this->get('/');
$response->assertStatus(200);
}
}

일반적으로 각 테스트는 애플리케이션에 하나의 요청만 보내야 합니다. 단일 테스트 메서드 내에서 여러 요청이 실행되면 예기치 않은 동작이 발생할 수 있습니다.

lightbulb

편의를 위해 테스트를 실행할 때 CSRF 미들웨어가 자동으로 비활성화됩니다.

요청 헤더 사용자 정의

애플리케이션으로 보내기 전에 withHeaders 메서드를 사용하여 요청 헤더를 사용자 정의할 수 있습니다. 이 메서드를 사용하면 요청에 원하는 사용자 정의 헤더를 추가할 수 있습니다.

<?php
test('헤더와 상호 작용', function () {
$response = $this->withHeaders([
'X-Header' => 'Value',
])->post('/user', ['name' => 'Sally']);
$response->assertStatus(201);
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본적인 기능 테스트 예시.
*/
public function test_interacting_with_headers(): void
{
$response = $this->withHeaders([
'X-Header' => 'Value',
])->post('/user', ['name' => 'Sally']);
$response->assertStatus(201);
}
}

쿠키

요청을 하기 전에 쿠키 값을 설정하기 위해 withCookie 또는 withCookies 메서드를 사용할 수 있습니다. withCookie 메서드는 쿠키 이름과 값을 두 개의 인수로 받아들이고, withCookies 메서드는 이름/값 쌍의 배열을 받아들입니다.

<?php
test('쿠키와 상호 작용', function () {
$response = $this->withCookie('color', 'blue')->get('/');
$response = $this->withCookies([
'color' => 'blue',
'name' => 'Taylor',
])->get('/');
//
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
public function test_interacting_with_cookies(): void
{
$response = $this->withCookie('color', 'blue')->get('/');
$response = $this->withCookies([
'color' => 'blue',
'name' => 'Taylor',
])->get('/');
//
}
}

세션 / 인증

라라벨은 HTTP 테스트 중에 세션과 상호 작용하기 위한 여러 헬퍼를 제공합니다. 먼저, withSession 메서드를 사용하여 세션 데이터를 주어진 배열로 설정할 수 있습니다. 이는 애플리케이션에 요청을 보내기 전에 세션에 데이터를 로드하는 데 유용합니다.

<?php
test('세션과 상호 작용', function () {
$response = $this->withSession(['banned' => false])->get('/');
//
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
public function test_interacting_with_the_session(): void
{
$response = $this->withSession(['banned' => false])->get('/');
//
}
}

Laravel의 세션은 일반적으로 현재 인증된 사용자의 상태를 유지하는 데 사용됩니다. 따라서 actingAs 헬퍼 메서드는 주어진 사용자를 현재 사용자로 인증하는 간단한 방법을 제공합니다. 예를 들어, 모델 팩토리를 사용하여 사용자를 생성하고 인증할 수 있습니다.

<?php
use App\Models\User;
test('인증이 필요한 액션', function () {
$user = User::factory()->create();
$response = $this->actingAs($user)
->withSession(['banned' => false])
->get('/');
//
});
<?php
namespace Tests\Feature;
use App\Models\User;
use Tests\TestCase;
class ExampleTest extends TestCase
{
public function test_an_action_that_requires_authentication(): void
{
$user = User::factory()->create();
$response = $this->actingAs($user)
->withSession(['banned' => false])
->get('/');
//
}
}

또한 actingAs 메서드에 두 번째 인수로 가드 이름을 전달하여 주어진 사용자를 인증하는 데 사용할 가드를 지정할 수 있습니다. actingAs 메서드에 제공된 가드는 테스트 기간 동안 기본 가드가 됩니다.

$this->actingAs($user, 'web')

응답 디버깅

애플리케이션에 테스트 요청을 한 후, dump, dumpHeaders, 및 dumpSession 메서드를 사용하여 응답 내용을 검사하고 디버그할 수 있습니다.

<?php
test('기본 테스트', function () {
$response = $this->get('/');
$response->dumpHeaders(); // 헤더 정보를 출력합니다.
$response->dumpSession(); // 세션 정보를 출력합니다.
$response->dump(); // 응답 정보를 출력합니다.
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본 테스트 예제.
*/
public function test_basic_test(): void
{
$response = $this->get('/');
$response->dumpHeaders(); // 헤더 정보를 출력합니다.
$response->dumpSession(); // 세션 정보를 출력합니다.
$response->dump(); // 응답 정보를 출력합니다.
}
}

또는, dd, ddHeaders, 그리고 ddSession 메소드를 사용하여 응답에 대한 정보를 출력하고 실행을 중지할 수 있습니다:

<?php
test('기본 테스트', function () {
$response = $this->get('/');
$response->ddHeaders(); // 헤더 정보를 출력하고 실행을 중지합니다.
$response->ddSession(); // 세션 정보를 출력하고 실행을 중지합니다.
$response->dd(); // 응답 정보를 출력하고 실행을 중지합니다.
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본 테스트 예제.
*/
public function test_basic_test(): void
{
$response = $this->get('/');
$response->ddHeaders(); // 헤더 정보를 출력하고 실행을 중지합니다.
$response->ddSession(); // 세션 정보를 출력하고 실행을 중지합니다.
$response->dd(); // 응답 정보를 출력하고 실행을 중지합니다.
}
}

예외 처리

때로는 애플리케이션이 특정 예외를 발생시키는지 테스트해야 할 수 있습니다. 이를 위해 Exceptions facade를 통해 예외 핸들러를 "가짜"로 만들 수 있습니다. 예외 핸들러가 가짜로 만들어지면 assertReportedassertNotReported 메소드를 사용하여 요청 중에 발생한 예외에 대한 어설션을 수행할 수 있습니다.

<?php
use App\Exceptions\InvalidOrderException;
use Illuminate\Support\Facades\Exceptions;
test('예외가 발생했는지 확인', function () {
Exceptions::fake();
$response = $this->get('/order/1');
// 예외가 발생했는지 확인...
Exceptions::assertReported(InvalidOrderException::class);
// 예외에 대한 확인...
Exceptions::assertReported(function (InvalidOrderException $e) {
return $e->getMessage() === 'The order was invalid.';
});
});
<?php
namespace Tests\Feature;
use App\Exceptions\InvalidOrderException;
use Illuminate\Support\Facades\Exceptions;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본적인 테스트 예제.
*/
public function test_exception_is_thrown(): void
{
Exceptions::fake();
$response = $this->get('/');
// 예외가 발생했는지 확인...
Exceptions::assertReported(InvalidOrderException::class);
// 예외에 대한 확인...
Exceptions::assertReported(function (InvalidOrderException $e) {
return $e->getMessage() === 'The order was invalid.';
});
}
}

assertNotReportedassertNothingReported 메소드는 요청 중에 주어진 예외가 발생하지 않았거나 예외가 전혀 발생하지 않았는지 확인하는 데 사용할 수 있습니다:

Exceptions::assertNotReported(InvalidOrderException::class);
Exceptions::assertNothingReported();

요청을 보내기 전에 withoutExceptionHandling 메서드를 호출하여 특정 요청에 대한 예외 처리를 완전히 비활성화할 수 있습니다.

$response = $this->withoutExceptionHandling()->get('/');

또한, 애플리케이션이 PHP 언어나 애플리케이션이 사용하는 라이브러리에서 더 이상 사용되지 않는 기능을 사용하지 않도록 하려면 요청을 보내기 전에 withoutDeprecationHandling 메서드를 호출할 수 있습니다. 더 이상 사용되지 않는 기능 처리를 비활성화하면, 더 이상 사용되지 않는 경고가 예외로 변환되어 테스트가 실패하게 됩니다.

$response = $this->withoutDeprecationHandling()->get('/');

assertThrows 메서드를 사용하여 주어진 클로저 내의 코드가 지정된 유형의 예외를 던지는지 확인할 수 있습니다.

$this->assertThrows(
fn () => (new ProcessOrder)->execute(),
OrderInvalid::class
);

던져진 예외를 검사하고 어설션을 수행하려면 assertThrows 메서드의 두 번째 인수로 클로저를 제공할 수 있습니다.

$this->assertThrows(
fn () => (new ProcessOrder)->execute(),
fn (OrderInvalid $e) => $e->orderId() === 123;
);

JSON API 테스트

Laravel은 JSON API와 해당 응답을 테스트하기 위한 여러 헬퍼도 제공합니다. 예를 들어, json, getJson, postJson, putJson, patchJson, deleteJsonoptionsJson 메서드를 사용하여 다양한 HTTP 동사를 사용하여 JSON 요청을 발행할 수 있습니다. 또한 이러한 메서드에 데이터 및 헤더를 쉽게 전달할 수도 있습니다. 시작하려면 /api/user에 대한 POST 요청을 만들고 예상된 JSON 데이터가 반환되었는지 확인하는 테스트를 작성해 보겠습니다.

<?php
test('making an api request', function () {
$response = $this->postJson('/api/user', ['name' => 'Sally']);
$response
->assertStatus(201)
->assertJson([
'created' => true,
]);
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본적인 기능 테스트 예제입니다.
*/
public function test_making_an_api_request(): void
{
$response = $this->postJson('/api/user', ['name' => 'Sally']);
$response
->assertStatus(201)
->assertJson([
'created' => true,
]);
}
}

또한, JSON 응답 데이터는 응답에서 배열 변수로 접근할 수 있어 JSON 응답 내에서 반환된 개별 값을 검사하는 데 편리합니다.

expect($response['created'])->toBeTrue();
$this->assertTrue($response['created']);
lightbulb

assertJson 메서드는 응답을 배열로 변환하여 주어진 배열이 애플리케이션에서 반환된 JSON 응답 내에 존재하는지 확인합니다. 따라서 JSON 응답에 다른 속성이 있더라도 주어진 조각이 존재하면 이 테스트는 여전히 통과됩니다.

정확한 JSON 일치 어설션

앞서 언급했듯이 assertJson 메서드를 사용하여 JSON 응답 내에 JSON 조각이 존재하는지 어설션할 수 있습니다. 주어진 배열이 애플리케이션에서 반환된 JSON과 정확히 일치하는지 확인하려면 assertExactJson 메서드를 사용해야 합니다.

<?php
test('asserting an exact json match', function () {
$response = $this->postJson('/user', ['name' => 'Sally']);
$response
->assertStatus(201)
->assertExactJson([
'created' => true,
]);
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본적인 기능 테스트 예제입니다.
*/
public function test_asserting_an_exact_json_match(): void
{
$response = $this->postJson('/user', ['name' => 'Sally']);
$response
->assertStatus(201)
->assertExactJson([
'created' => true,
]);
}
}

JSON 경로에서 어설션하기

JSON 응답이 지정된 경로에 주어진 데이터를 포함하는지 확인하려면 assertJsonPath 메서드를 사용해야 합니다.

<?php
test('json 경로 값 어설션', function () {
$response = $this->postJson('/user', ['name' => 'Sally']);
$response
->assertStatus(201)
->assertJsonPath('team.owner.name', 'Darian');
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* 기본적인 기능 테스트 예제입니다.
*/
public function test_asserting_a_json_paths_value(): void
{
$response = $this->postJson('/user', ['name' => 'Sally']);
$response
->assertStatus(201)
->assertJsonPath('team.owner.name', 'Darian');
}
}

assertJsonPath 메서드는 클로저를 허용하며, 이를 사용하여 어설션이 통과해야 하는지 여부를 동적으로 결정할 수 있습니다.

$response->assertJsonPath('team.owner.name', fn (string $name) => strlen($name) >= 3);

Fluent JSON 테스팅

Laravel은 또한 애플리케이션의 JSON 응답을 유려하게 테스트할 수 있는 멋진 방법을 제공합니다. 시작하려면 assertJson 메서드에 클로저를 전달하세요. 이 클로저는 애플리케이션에서 반환된 JSON에 대한 어설션을 만드는 데 사용할 수 있는 Illuminate\Testing\Fluent\AssertableJson 인스턴스와 함께 호출됩니다. where 메서드를 사용하여 JSON의 특정 속성에 대한 어설션을 만들 수 있으며, missing 메서드를 사용하여 특정 속성이 JSON에서 누락되었는지 어설션할 수 있습니다.

use Illuminate\Testing\Fluent\AssertableJson;
test('fluent json', function () {
$response = $this->getJson('/users/1');
$response
->assertJson(fn (AssertableJson $json) =>
$json->where('id', 1)
->where('name', 'Victoria Faith')
->where('email', fn (string $email) => str($email)->is('[email protected]'))
->whereNot('status', 'pending')
->missing('password')
->etc()
);
});
use Illuminate\Testing\Fluent\AssertableJson;
/**
* A basic functional test example.
*/
public function test_fluent_json(): void
{
$response = $this->getJson('/users/1');
$response
->assertJson(fn (AssertableJson $json) =>
$json->where('id', 1)
->where('name', 'Victoria Faith')
->where('email', fn (string $email) => str($email)->is('[email protected]'))
->whereNot('status', 'pending')
->missing('password')
->etc()
);
}

etc 메서드 이해하기

위 예제에서, 어설션 체인의 끝에 etc 메서드를 호출한 것을 보셨을 겁니다. 이 메서드는 JSON 객체에 다른 속성이 존재할 수 있음을 Laravel에 알립니다. etc 메서드를 사용하지 않으면, 어설션을 만들지 않은 다른 속성이 JSON 객체에 존재할 경우 테스트는 실패합니다.

이러한 동작의 의도는 속성에 대해 명시적으로 어설션을 만들거나 etc 메서드를 통해 추가 속성을 명시적으로 허용하도록 하여 JSON 응답에서 의도치 않게 민감한 정보가 노출되는 것을 방지하는 데 있습니다.

그러나 어설션 체인에 etc 메서드를 포함하지 않는다고 해서 JSON 객체 내에 중첩된 배열에 추가 속성이 추가되지 않는다는 것을 보장하지는 않는다는 점에 유의해야 합니다. etc 메서드는 etc 메서드가 호출되는 중첩 수준에서 추가 속성이 존재하지 않도록 보장할 뿐입니다.

속성 존재 / 부재 어설션

속성이 존재하거나 부재하는지 어설션하려면 hasmissing 메서드를 사용할 수 있습니다:

$response->assertJson(fn (AssertableJson $json) =>
$json->has('data')
->missing('message')
);

또한, hasAllmissingAll 메서드를 사용하면 여러 속성의 존재 또는 부재를 동시에 어설션할 수 있습니다:

$response->assertJson(fn (AssertableJson $json) =>
$json->hasAll(['status', 'data'])
->missingAll(['message', 'code'])
);

hasAny 메서드를 사용하여 주어진 속성 목록 중 적어도 하나가 존재하는지 확인할 수 있습니다:

$response->assertJson(fn (AssertableJson $json) =>
$json->has('status')
->hasAny('data', 'message', 'code')
);

JSON 컬렉션에 대한 어설션

일반적으로, 라우트는 여러 사용자 등 여러 항목을 포함하는 JSON 응답을 반환합니다:

Route::get('/users', function () {
return User::all();
});

이러한 상황에서, 응답에 포함된 사용자에 대해 어설션을 만들 때 유창한 JSON 객체의 has 메서드를 사용할 수 있습니다. 예를 들어, JSON 응답에 세 명의 사용자가 포함되어 있다고 어설션해 보겠습니다. 다음으로, first 메서드를 사용하여 컬렉션의 첫 번째 사용자에 대한 몇 가지 어설션을 만듭니다. first 메서드는 JSON 컬렉션의 첫 번째 객체에 대해 어설션을 만드는 데 사용할 수 있는 또 다른 어설션 가능한 JSON 문자열을 받는 클로저를 허용합니다:

$response
->assertJson(fn (AssertableJson $json) =>
$json->has(3)
->first(fn (AssertableJson $json) =>
$json->where('id', 1)
->where('name', 'Victoria Faith')
->where('email', fn (string $email) => str($email)->is('[email protected]'))
->missing('password')
->etc()
)
);

JSON 컬렉션 어설션 범위 지정

경우에 따라 애플리케이션의 라우트는 이름이 지정된 키에 할당된 JSON 컬렉션을 반환합니다:

Route::get('/users', function () {
return [
'meta' => [...],
'users' => User::all(),
];
})

이러한 라우트를 테스트할 때, has 메서드를 사용하여 컬렉션의 항목 수에 대해 어설션할 수 있습니다. 또한, has 메서드를 사용하여 어설션 체인의 범위를 지정할 수 있습니다:

$response
->assertJson(fn (AssertableJson $json) =>
$json->has('meta')
->has('users', 3)
->has('users.0', fn (AssertableJson $json) =>
$json->where('id', 1)
->where('name', 'Victoria Faith')
->where('email', fn (string $email) => str($email)->is('[email protected]'))
->missing('password')
->etc()
)
);

그러나 users 컬렉션에 대해 어설션하기 위해 has 메서드를 두 번 호출하는 대신, 세 번째 매개변수로 클로저를 제공하는 단일 호출을 할 수 있습니다. 이렇게 하면 클로저가 자동으로 호출되고 컬렉션의 첫 번째 항목으로 범위가 지정됩니다:

$response
->assertJson(fn (AssertableJson $json) =>
$json->has('meta')
->has('users', 3, fn (AssertableJson $json) =>
$json->where('id', 1)
->where('name', 'Victoria Faith')
->where('email', fn (string $email) => str($email)->is('[email protected]'))
->missing('password')
->etc()
)
);

JSON 타입 어설션

JSON 응답의 속성이 특정 타입인지 어설션하기만 원할 수 있습니다. Illuminate\Testing\Fluent\AssertableJson 클래스는 이를 위한 whereTypewhereAllType 메서드를 제공합니다:

$response->assertJson(fn (AssertableJson $json) =>
$json->whereType('id', 'integer')
->whereAllType([
'users.0.name' => 'string',
'meta' => 'array'
])
);

| 문자를 사용하거나 whereType 메서드에 두 번째 매개변수로 타입 배열을 전달하여 여러 타입을 지정할 수 있습니다. 응답 값이 나열된 타입 중 어느 하나라도 해당되면 어설션은 성공합니다:

$response->assertJson(fn (AssertableJson $json) =>
$json->whereType('name', 'string|null')
->whereType('id', ['string', 'integer'])
);

whereTypewhereAllType 메서드는 string, integer, double, boolean, arraynull 타입을 인식합니다.

파일 업로드 테스트

Illuminate\Http\UploadedFile 클래스는 테스트용 더미 파일 또는 이미지를 생성하는 데 사용할 수 있는 fake 메서드를 제공합니다. 이는 Storage 파사드의 fake 메서드와 결합하여 파일 업로드 테스트를 크게 간소화합니다. 예를 들어, 이러한 두 가지 기능을 결합하여 아바타 업로드 폼을 쉽게 테스트할 수 있습니다:

<?php
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
test('avatars can be uploaded', function () {
// 'avatars' 디스크를 모의(fake)로 설정합니다.
Storage::fake('avatars');
// 가짜 이미지 파일을 생성합니다.
$file = UploadedFile::fake()->image('avatar.jpg');
// '/avatar' 경로로 파일 업로드를 시도합니다.
$response = $this->post('/avatar', [
'avatar' => $file,
]);
// 'avatars' 디스크에 파일이 존재하는지 확인합니다.
Storage::disk('avatars')->assertExists($file->hashName());
});
<?php
namespace Tests\Feature;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Tests\TestCase;
class ExampleTest extends TestCase
{
public function test_avatars_can_be_uploaded(): void
{
// 'avatars' 디스크를 모의(fake)로 설정합니다.
Storage::fake('avatars');
// 가짜 이미지 파일을 생성합니다.
$file = UploadedFile::fake()->image('avatar.jpg');
// '/avatar' 경로로 파일 업로드를 시도합니다.
$response = $this->post('/avatar', [
'avatar' => $file,
]);
// 'avatars' 디스크에 파일이 존재하는지 확인합니다.
Storage::disk('avatars')->assertExists($file->hashName());
}
}

지정된 파일이 존재하지 않는지 단언하려면 Storage 파사드에서 제공하는 assertMissing 메서드를 사용할 수 있습니다.

Storage::fake('avatars');
// ...
Storage::disk('avatars')->assertMissing('missing.jpg');

가짜 파일 사용자 정의

UploadedFile 클래스에서 제공하는 fake 메서드를 사용하여 파일을 생성할 때, 애플리케이션의 유효성 검사 규칙을 더 잘 테스트하기 위해 이미지의 너비, 높이, 크기(킬로바이트 단위)를 지정할 수 있습니다.

UploadedFile::fake()->image('avatar.jpg', $width, $height)->size(100);

이미지 생성 외에도 create 메서드를 사용하여 다른 유형의 파일을 생성할 수 있습니다.

UploadedFile::fake()->create('document.pdf', $sizeInKilobytes);

필요한 경우, 파일에서 반환해야 하는 MIME 유형을 명시적으로 정의하기 위해 메서드에 $mimeType 인수를 전달할 수 있습니다.

UploadedFile::fake()->create(
'document.pdf', $sizeInKilobytes, 'application/pdf'
);

뷰 테스트

Laravel을 사용하면 애플리케이션에 대한 시뮬레이션된 HTTP 요청을 수행하지 않고도 뷰를 렌더링할 수 있습니다. 이를 위해 테스트 내에서 view 메서드를 호출할 수 있습니다. view 메서드는 뷰 이름과 선택적 데이터 배열을 허용합니다. 이 메서드는 Illuminate\Testing\TestView 인스턴스를 반환하며, 이 인스턴스는 뷰의 내용에 대한 어설션을 편리하게 만들 수 있는 여러 메서드를 제공합니다.

<?php
test('a welcome view can be rendered', function () {
$view = $this->view('welcome', ['name' => 'Taylor']);
$view->assertSee('Taylor');
});
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
public function test_a_welcome_view_can_be_rendered(): void
{
$view = $this->view('welcome', ['name' => 'Taylor']);
$view->assertSee('Taylor');
}
}

TestView 클래스는 assertSee, assertSeeInOrder, assertSeeText, assertSeeTextInOrder, assertDontSee, assertDontSeeText 와 같은 assertion 메서드를 제공합니다.

필요한 경우, TestView 인스턴스를 문자열로 캐스팅하여 원시 렌더링된 뷰 내용을 얻을 수 있습니다:

$contents = (string) $this->view('welcome');

에러 공유하기

일부 뷰는 Laravel에서 제공하는 전역 에러 백에 공유된 에러에 의존할 수 있습니다. 에러 백에 에러 메시지를 채우려면 withViewErrors 메서드를 사용할 수 있습니다:

$view = $this->withViewErrors([
'name' => ['유효한 이름을 제공해주세요.']
])->view('form');
$view->assertSee('유효한 이름을 제공해주세요.');

Blade 및 컴포넌트 렌더링

필요한 경우 blade 메서드를 사용하여 원시 Blade 문자열을 평가하고 렌더링할 수 있습니다. view 메서드와 마찬가지로 blade 메서드는 Illuminate\Testing\TestView 인스턴스를 반환합니다.

$view = $this->blade(
'<x-component :name="$name" />',
['name' => 'Taylor']
);
$view->assertSee('Taylor');

component 메서드를 사용하여 Blade 컴포넌트를 평가하고 렌더링할 수 있습니다. component 메서드는 Illuminate\Testing\TestComponent 인스턴스를 반환합니다:

$view = $this->component(Profile::class, ['name' => 'Taylor']);
$view->assertSee('Taylor');

사용 가능한 Assertion

응답 Assertion

Laravel의 Illuminate\Testing\TestResponse 클래스는 애플리케이션을 테스트할 때 활용할 수 있는 다양한 사용자 정의 assertion 메서드를 제공합니다. 이러한 assertion은 json, get, post, put, delete 테스트 메서드에서 반환된 응답에서 접근할 수 있습니다:

assertBadRequest

응답에 잘못된 요청 (400) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertBadRequest();

assertAccepted

응답에 승인됨 (202) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertAccepted();

assertConflict

응답에 충돌 (409) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertConflict();

응답에 주어진 쿠키가 있는지 assertion합니다:

$response->assertCookie($cookieName, $value = null);

응답에 주어진 쿠키가 있고 만료되었는지 assertion합니다:

$response->assertCookieExpired($cookieName);

응답에 주어진 쿠키가 있고 만료되지 않았는지 assertion합니다:

$response->assertCookieNotExpired($cookieName);

응답에 주어진 쿠키가 없는지 assertion합니다:

$response->assertCookieMissing($cookieName);

assertCreated

응답에 201 HTTP 상태 코드가 있는지 assertion합니다:

$response->assertCreated();

assertDontSee

애플리케이션에서 반환된 응답 내에 주어진 문자열이 포함되어 있지 않은지 assertion합니다. 이 assertion은 두 번째 인수로 false를 전달하지 않는 한 주어진 문자열을 자동으로 이스케이프 처리합니다:

$response->assertDontSee($value, $escaped = true);

assertDontSeeText

응답 텍스트 내에 주어진 문자열이 포함되어 있지 않은지 assertion합니다. 이 assertion은 두 번째 인수로 false를 전달하지 않는 한 주어진 문자열을 자동으로 이스케이프 처리합니다. 이 메서드는 assertion을 수행하기 전에 응답 콘텐츠를 strip_tags PHP 함수에 전달합니다:

$response->assertDontSeeText($value, $escaped = true);

assertDownload

응답이 "다운로드"인지 assertion합니다. 일반적으로 이는 응답을 반환한 호출된 라우트가 Response::download 응답, BinaryFileResponse 또는 Storage::download 응답을 반환했음을 의미합니다:

$response->assertDownload();

원하는 경우 다운로드 가능한 파일에 지정된 파일 이름이 할당되었는지 assertion할 수 있습니다:

$response->assertDownload('image.jpg');

assertExactJson

응답에 주어진 JSON 데이터와 정확히 일치하는 내용이 포함되어 있는지 assertion합니다:

$response->assertExactJson(array $data);

assertExactJsonStructure

응답에 주어진 JSON 구조와 정확히 일치하는 내용이 포함되어 있는지 assertion합니다:

$response->assertExactJsonStructure(array $data);

이 메서드는 assertJsonStructure의 더 엄격한 변형입니다. assertJsonStructure와 달리, 이 메서드는 응답에 예상 JSON 구조에 명시적으로 포함되지 않은 키가 있으면 실패합니다.

assertForbidden

응답에 금지됨 (403) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertForbidden();

assertFound

응답에 찾음 (302) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertFound();

assertGone

응답에 사라짐 (410) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertGone();

assertHeader

응답에 주어진 헤더 및 값이 있는지 assertion합니다:

$response->assertHeader($headerName, $value = null);

assertHeaderMissing

응답에 주어진 헤더가 없는지 assertion합니다:

$response->assertHeaderMissing($headerName);

assertInternalServerError

응답에 "내부 서버 오류" (500) HTTP 상태 코드가 있는지 assertion합니다:

$response->assertInternalServerError();

assertJson

응답에 주어진 JSON 데이터가 포함되어 있는지 assertion합니다:

$response->assertJson(array $data, $strict = false);

assertJson 메서드는 응답을 배열로 변환하여 애플리케이션에서 반환된 JSON 응답 내에 주어진 배열이 있는지 확인합니다. 따라서 JSON 응답에 다른 속성이 있는 경우에도 주어진 조각이 있으면 이 테스트는 계속 통과됩니다.

assertJsonCount

응답 JSON에 지정된 키에서 예상되는 항목 수의 배열이 있는지 assertion합니다:

$response->assertJsonCount($count, $key = null);

assertJsonFragment

응답에 응답의 어느 곳에든 주어진 JSON 데이터가 포함되어 있는지 assertion합니다:

Route::get('/users', function () {
return [
'users' => [
[
'name' => 'Taylor Otwell',
],
],
];
});
$response->assertJsonFragment(['name' => 'Taylor Otwell']);

assertJsonIsArray

응답 JSON이 배열인지 assertion합니다:

$response->assertJsonIsArray();

assertJsonIsObject

응답 JSON이 객체인지 assertion합니다:

$response->assertJsonIsObject();

assertJsonMissing

응답에 주어진 JSON 데이터가 포함되어 있지 않은지 assertion합니다:

$response->assertJsonMissing(array $data);

assertJsonMissingExact

응답에 정확한 JSON 데이터가 포함되어 있지 않은지 assertion합니다:

$response->assertJsonMissingExact(array $data);

assertJsonMissingValidationErrors

응답에 주어진 키에 대한 JSON 유효성 검사 오류가 없는지 assertion합니다:

$response->assertJsonMissingValidationErrors($keys);
lightbulb

더 일반적인 assertValid 메서드를 사용하여 응답에 JSON으로 반환된 유효성 검사 오류가 없고 세션 스토리지에 오류가 플래시되지 않았는지 assertion할 수 있습니다.

assertJsonPath

응답에 지정된 경로에 주어진 데이터가 있는지 assertion합니다:

$response->assertJsonPath($path, $expectedValue);

예를 들어, 애플리케이션에서 다음 JSON 응답이 반환되면 다음과 같습니다.

{
"user": {
"name": "Steve Schoger"
}
}

다음과 같이 user 객체의 name 속성이 주어진 값과 일치하는지 확인할 수 있습니다.

$response->assertJsonPath('user.name', 'Steve Schoger');

assertJsonMissingPath

응답에 주어진 경로가 포함되어 있지 않은지 확인합니다.

$response->assertJsonMissingPath($path);

예를 들어, 애플리케이션에서 다음 JSON 응답이 반환되는 경우:

{
"user": {
"name": "Steve Schoger"
}
}

user 객체에 email 속성이 없는지 확인할 수 있습니다.

$response->assertJsonMissingPath('user.email');

assertJsonStructure

응답이 주어진 JSON 구조를 갖는지 확인합니다.

$response->assertJsonStructure(array $structure);

예를 들어, 애플리케이션에서 반환된 JSON 응답에 다음 데이터가 포함되어 있는 경우:

{
"user": {
"name": "Steve Schoger"
}
}

다음과 같이 JSON 구조가 기대와 일치하는지 확인할 수 있습니다.

$response->assertJsonStructure([
'user' => [
'name',
]
]);

때로는 애플리케이션에서 반환되는 JSON 응답에 객체 배열이 포함될 수 있습니다.

{
"user": [
{
"name": "Steve Schoger",
"age": 55,
"location": "Earth"
},
{
"name": "Mary Schoger",
"age": 60,
"location": "Earth"
}
]
}

이러한 상황에서는 배열 내 모든 객체의 구조를 검증하기 위해 * 문자를 사용할 수 있습니다.

$response->assertJsonStructure([
'user' => [
'*' => [
'name',
'age',
'location'
]
]
]);

assertJsonValidationErrors

응답에 주어진 키에 대한 JSON 유효성 검사 오류가 있는지 확인합니다. 이 메서드는 유효성 검사 오류가 세션에 플래시되는 대신 JSON 구조로 반환되는 응답을 검증할 때 사용해야 합니다.

$response->assertJsonValidationErrors(array $data, $responseKey = 'errors');
lightbulb

더 일반적인 assertInvalid 메서드를 사용하여 응답에 JSON으로 반환된 유효성 검사 오류가 있는지 또는 세션 스토리지에 오류가 플래시되었는지 확인할 수 있습니다.

assertJsonValidationErrorFor

응답에 주어진 키에 대한 JSON 유효성 검사 오류가 있는지 확인합니다.

$response->assertJsonValidationErrorFor(string $key, $responseKey = 'errors');

assertMethodNotAllowed

응답에 허용되지 않는 메서드 (405) HTTP 상태 코드가 있는지 확인합니다.

$response->assertMethodNotAllowed();

assertMovedPermanently

응답에 영구적으로 이동됨 (301) HTTP 상태 코드가 있는지 확인합니다.

$response->assertMovedPermanently();

assertLocation

응답의 Location 헤더에 주어진 URI 값이 있는지 확인합니다.

$response->assertLocation($uri);

assertContent

주어진 문자열이 응답 내용과 일치하는지 확인합니다.

$response->assertContent($value);

assertNoContent

응답에 주어진 HTTP 상태 코드가 있고 내용이 없는지 확인합니다.

$response->assertNoContent($status = 204);

assertStreamedContent

주어진 문자열이 스트리밍된 응답 내용과 일치하는지 확인합니다.

$response->assertStreamedContent($value);

assertNotFound

응답에 찾을 수 없음 (404) HTTP 상태 코드가 있는지 확인합니다.

$response->assertNotFound();

assertOk

응답에 200 HTTP 상태 코드가 있는지 확인합니다.

$response->assertOk();

assertPaymentRequired

응답에 결제 필요 (402) HTTP 상태 코드가 있는지 확인합니다.

$response->assertPaymentRequired();

응답에 주어진 암호화되지 않은 쿠키가 있는지 확인합니다.

$response->assertPlainCookie($cookieName, $value = null);

assertRedirect

응답이 주어진 URI로 리디렉션되는지 확인합니다.

$response->assertRedirect($uri = null);

assertRedirectContains

응답이 주어진 문자열을 포함하는 URI로 리디렉션되는지 여부를 확인합니다.

$response->assertRedirectContains($string);

assertRedirectToRoute

응답이 주어진 명명된 라우트로 리디렉션되는지 확인합니다.

$response->assertRedirectToRoute($name, $parameters = []);

assertRedirectToSignedRoute

응답이 주어진 서명된 라우트로 리디렉션되는지 확인합니다.

$response->assertRedirectToSignedRoute($name = null, $parameters = []);

assertRequestTimeout

응답에 요청 시간 초과 (408) HTTP 상태 코드가 있는지 확인합니다.

$response->assertRequestTimeout();

assertSee

응답 내에 주어진 문자열이 포함되어 있는지 확인합니다. 이 검증은 두 번째 인수로 false를 전달하지 않는 한 주어진 문자열을 자동으로 이스케이프 처리합니다.

$response->assertSee($value, $escaped = true);

assertSeeInOrder

응답 내에 주어진 문자열들이 순서대로 포함되어 있는지 확인합니다. 이 검증은 두 번째 인수로 false를 전달하지 않는 한 주어진 문자열을 자동으로 이스케이프 처리합니다.

$response->assertSeeInOrder(array $values, $escaped = true);

assertSeeText

응답 텍스트 내에 주어진 문자열이 포함되어 있는지 확인합니다. 이 검증은 두 번째 인수로 false를 전달하지 않는 한 주어진 문자열을 자동으로 이스케이프 처리합니다. 응답 내용은 검증을 수행하기 전에 strip_tags PHP 함수에 전달됩니다.

$response->assertSeeText($value, $escaped = true);

assertSeeTextInOrder

응답 텍스트 내에 주어진 문자열들이 순서대로 포함되어 있는지 확인합니다. 이 검증은 두 번째 인수로 false를 전달하지 않는 한 주어진 문자열을 자동으로 이스케이프 처리합니다. 응답 내용은 검증을 수행하기 전에 strip_tags PHP 함수에 전달됩니다.

$response->assertSeeTextInOrder(array $values, $escaped = true);

assertServerError

응답에 서버 오류 (>= 500, < 600) HTTP 상태 코드가 있는지 확인합니다.

$response->assertServerError();

assertServiceUnavailable

응답에 "서비스를 사용할 수 없음" (503) HTTP 상태 코드가 있는지 확인합니다.

$response->assertServiceUnavailable();

assertSessionHas

세션에 주어진 데이터 조각이 있는지 확인합니다.

$response->assertSessionHas($key, $value = null);

필요한 경우 assertSessionHas 메서드의 두 번째 인수로 클로저를 제공할 수 있습니다. 클로저가 true를 반환하면 검증이 통과됩니다.

$response->assertSessionHas($key, function (User $value) {
return $value->name === 'Taylor Otwell';
});

assertSessionHasInput

세션에 플래시된 입력 배열에 주어진 값이 있는지 확인합니다.

$response->assertSessionHasInput($key, $value = null);

필요한 경우 assertSessionHasInput 메서드의 두 번째 인수로 클로저를 제공할 수 있습니다. 클로저가 true를 반환하면 검증이 통과됩니다.

use Illuminate\Support\Facades\Crypt;
$response->assertSessionHasInput($key, function (string $value) {
return Crypt::decryptString($value) === 'secret';
});

assertSessionHasAll

세션에 주어진 키/값 쌍 배열이 포함되어 있는지 확인합니다.

$response->assertSessionHasAll(array $data);

예를 들어 애플리케이션의 세션에 namestatus 키가 포함된 경우 다음과 같이 두 키가 모두 존재하고 지정된 값을 갖는지 확인할 수 있습니다.

$response->assertSessionHasAll([
'name' => 'Taylor Otwell',
'status' => 'active',
]);

assertSessionHasErrors

세션에 주어진 $keys에 대한 오류가 있는지 확인합니다. $keys가 연관 배열인 경우 세션에 각 필드(키)에 대한 특정 오류 메시지(값)가 포함되어 있는지 확인합니다. 이 메서드는 유효성 검사 오류를 JSON 구조로 반환하는 대신 세션에 플래시하는 라우트를 테스트할 때 사용해야 합니다.

$response->assertSessionHasErrors(
array $keys = [], $format = null, $errorBag = 'default'
);

예를 들어 nameemail 필드에 세션에 플래시된 유효성 검사 오류 메시지가 있는지 확인하려면 다음과 같이 assertSessionHasErrors 메서드를 호출할 수 있습니다.

$response->assertSessionHasErrors(['name', 'email']);

또는 주어진 필드에 특정 유효성 검사 오류 메시지가 있는지 확인할 수 있습니다.

$response->assertSessionHasErrors([
'name' => 'The given name was invalid.'
]);
lightbulb

더 일반적인 assertInvalid 메서드를 사용하여 응답에 JSON으로 반환된 유효성 검사 오류가 있는지 또는 세션 스토리지에 오류가 플래시되었는지 확인할 수 있습니다.

assertSessionHasErrorsIn

세션에 특정 오류 백 내에서 주어진 $keys에 대한 오류가 있는지 확인합니다. $keys가 연관 배열인 경우 세션에 오류 백 내에서 각 필드(키)에 대한 특정 오류 메시지(값)가 포함되어 있는지 확인합니다.

$response->assertSessionHasErrorsIn($errorBag, $keys = [], $format = null);

assertSessionHasNoErrors

세션에 유효성 검사 오류가 없는지 확인합니다.

$response->assertSessionHasNoErrors();

assertSessionDoesntHaveErrors

세션에 주어진 키에 대한 유효성 검사 오류가 없는지 확인합니다.

$response->assertSessionDoesntHaveErrors($keys = [], $format = null, $errorBag = 'default');
lightbulb

더 일반적인 assertValid 메서드를 사용하여 응답에 JSON으로 반환된 유효성 검사 오류가 없고 세션 스토리지에 오류가 플래시되지 않았는지 확인할 수 있습니다.

assertSessionMissing

세션에 주어진 키가 없는지 확인합니다.

$response->assertSessionMissing($key);

assertStatus

응답에 주어진 HTTP 상태 코드가 있는지 확인합니다.

$response->assertStatus($code);

assertSuccessful

응답에 성공적인 (>= 200 및 < 300) HTTP 상태 코드가 있는지 확인합니다.

$response->assertSuccessful();

assertTooManyRequests

응답에 너무 많은 요청 (429) HTTP 상태 코드가 있는지 확인합니다.

$response->assertTooManyRequests();

assertUnauthorized

응답에 권한 없음 (401) HTTP 상태 코드가 있는지 확인합니다.

$response->assertUnauthorized();

assertUnprocessable

응답에 처리할 수 없는 엔티티 (422) HTTP 상태 코드가 있는지 확인합니다.

$response->assertUnprocessable();

assertUnsupportedMediaType

응답에 지원되지 않는 미디어 유형 (415) HTTP 상태 코드가 있는지 확인합니다.

$response->assertUnsupportedMediaType();

assertValid

응답에 주어진 키에 대한 유효성 검사 오류가 없는지 확인합니다. 이 메서드는 유효성 검사 오류가 JSON 구조로 반환되거나 유효성 검사 오류가 세션에 플래시된 응답을 검증하는 데 사용할 수 있습니다.

// 유효성 검사 오류가 없는지 확인합니다...
$response->assertValid();
// 주어진 키에 유효성 검사 오류가 없는지 확인합니다...
$response->assertValid(['name', 'email']);

assertInvalid

응답에 주어진 키에 대한 유효성 검사 오류가 있는지 확인합니다. 이 메서드는 유효성 검사 오류가 JSON 구조로 반환되거나 유효성 검사 오류가 세션에 플래시된 응답을 검증하는 데 사용할 수 있습니다.

$response->assertInvalid(['name', 'email']);

또한 주어진 키에 특정 유효성 검사 오류 메시지가 있는지 확인할 수도 있습니다. 그렇게 할 때 전체 메시지 또는 메시지의 작은 부분만 제공할 수 있습니다.

$response->assertInvalid([
'name' => 'The name field is required.',
'email' => 'valid email address',
]);

assertViewHas

응답 뷰에 주어진 데이터 조각이 있는지 확인합니다.

$response->assertViewHas($key, $value = null);

assertViewHas 메서드의 두 번째 인수로 클로저를 전달하면 특정 뷰 데이터를 검사하고 어설션을 수행할 수 있습니다.

$response->assertViewHas('user', function (User $user) {
return $user->name === 'Taylor';
});

또한 뷰 데이터는 응답에서 배열 변수로 접근할 수 있으므로 편리하게 검사할 수 있습니다.

expect($response['name'])->toBe('Taylor');
$this->assertEquals('Taylor', $response['name']);

assertViewHasAll

응답 뷰에 주어진 데이터 목록이 있는지 확인합니다:

$response->assertViewHasAll(array $data);

이 메서드는 뷰에 주어진 키와 일치하는 데이터가 포함되어 있는지 확인하는 데 사용할 수 있습니다:

$response->assertViewHasAll([
'name',
'email',
]);

또는 뷰 데이터가 존재하고 특정 값을 가지는지 확인할 수 있습니다:

$response->assertViewHasAll([
'name' => 'Taylor Otwell',
'email' => '[email protected],',
]);

assertViewIs

주어진 뷰가 경로에 의해 반환되었는지 확인합니다:

$response->assertViewIs($value);

assertViewMissing

주어진 데이터 키가 애플리케이션 응답에서 반환된 뷰에 제공되지 않았는지 확인합니다:

$response->assertViewMissing($key);

인증 어설션

Laravel은 또한 애플리케이션의 기능 테스트 내에서 활용할 수 있는 다양한 인증 관련 어설션을 제공합니다. 이러한 메서드는 getpost와 같은 메서드에서 반환된 Illuminate\Testing\TestResponse 인스턴스가 아닌 테스트 클래스 자체에서 호출된다는 점에 유의하세요.

assertAuthenticated

사용자가 인증되었는지 확인합니다:

$this->assertAuthenticated($guard = null);

assertGuest

사용자가 인증되지 않았는지 확인합니다:

$this->assertGuest($guard = null);

assertAuthenticatedAs

특정 사용자가 인증되었는지 확인합니다:

$this->assertAuthenticatedAs($user, $guard = null);

유효성 검사 어설션

Laravel은 요청에 제공된 데이터가 유효하거나 유효하지 않은지 확인하는 데 사용할 수 있는 두 가지 주요 유효성 검사 관련 어설션을 제공합니다.

assertValid

응답에 주어진 키에 대한 유효성 검사 오류가 없는지 확인합니다. 이 메서드는 유효성 검사 오류가 JSON 구조로 반환되거나 유효성 검사 오류가 세션에 플래시된 응답에 대해 어설션하는 데 사용할 수 있습니다:

// 유효성 검사 오류가 없는지 확인...
$response->assertValid();
// 주어진 키에 유효성 검사 오류가 없는지 확인...
$response->assertValid(['name', 'email']);

assertInvalid

응답에 주어진 키에 대한 유효성 검사 오류가 있는지 확인합니다. 이 메서드는 유효성 검사 오류가 JSON 구조로 반환되거나 유효성 검사 오류가 세션에 플래시된 응답에 대해 어설션하는 데 사용할 수 있습니다:

$response->assertInvalid(['name', 'email']);

또한 주어진 키에 특정 유효성 검사 오류 메시지가 있는지 확인할 수도 있습니다. 이렇게 할 때 전체 메시지 또는 메시지의 일부만 제공할 수 있습니다:

$response->assertInvalid([
'name' => 'The name field is required.',
'email' => 'valid email address',
]);