Laravel Dusk

Introduction
Installation
- Managing ChromeDriver Installations
- Using Other Browsers
Getting Started
Browser Basics
Interacting With Elements
Available Assertions
Pages
Components
- Generating Components
- Using Components
Continuous Integration

Introduction

[!WARNING] Pest 4는 이제 자동화된 브라우저 테스트를 포함하며, 이는 Laravel Dusk에 비해 성능과 사용성이 크게 향상되었습니다. 새로운 프로젝트에서는 브라우저 테스트를 위해 Pest를 사용하는 것을 권장합니다.

Laravel Dusk는 표현력이 뛰어나고 사용하기 쉬운 브라우저 자동화 및 테스트 API를 제공합니다. 기본적으로 Dusk는 로컬 컴퓨터에 JDK 또는 Selenium을 설치할 필요가 없습니다. 대신, Dusk는 독립 실행형 ChromeDriver 설치를 사용합니다. 그러나 원하는 경우 다른 Selenium 호환 드라이버를 자유롭게 사용할 수 있습니다.

설치

시작하려면 Google Chrome을 설치하고 프로젝트에 laravel/dusk Composer 의존성을 추가해야 합니다:

composer require laravel/dusk --dev

[!WARNING] Dusk의 서비스 제공자를 수동으로 등록하는 경우, 절대 운영 환경에서 등록해서는 안 됩니다. 이렇게 하면 임의의 사용자가 애플리케이션에 인증할 수 있는 위험이 있기 때문입니다.

Dusk 패키지를 설치한 후, dusk:install Artisan 명령을 실행하세요. dusk:install 명령은 tests/Browser 디렉토리, 예제 Dusk 테스트를 생성하고, 운영 체제에 맞는 Chrome Driver 바이너리를 설치합니다:

php artisan dusk:install

다음으로, 애플리케이션의 .env 파일에서 APP_URL 환경 변수를 설정하십시오. 이 값은 브라우저에서 애플리케이션에 접근할 때 사용하는 URL과 일치해야 합니다.

[!NOTE] 로컬 개발 환경을 관리하기 위해 Laravel Sail을 사용하는 경우, Dusk 테스트 구성 및 실행에 대한 Sail 문서도 참조하십시오.

ChromeDriver 설치 관리

Laravel Dusk가 dusk:install 명령을 사용하여 설치한 것과 다른 버전의 ChromeDriver를 설치하고 싶다면, dusk:chrome-driver 명령을 사용할 수 있습니다:

# Install the latest version of ChromeDriver for your OS...
php artisan dusk:chrome-driver

# Install a given version of ChromeDriver for your OS...
php artisan dusk:chrome-driver 86

# Install a given version of ChromeDriver for all supported OSs...
php artisan dusk:chrome-driver --all

# Install the version of ChromeDriver that matches the detected version of Chrome / Chromium for your OS...
php artisan dusk:chrome-driver --detect

[!WARNING] Dusk는 chromedriver 바이너리를 실행 가능하도록 요구합니다. Dusk 실행에 문제가 있다면, 다음 명령어를 사용하여 바이너리가 실행 가능 상태인지 확인해야 합니다: chmod -R 0755 vendor/laravel/dusk/bin/.

다른 브라우저 사용

기본적으로 Dusk는 Google Chrome과 독립 실행형 ChromeDriver 설치를 사용하여 브라우저 테스트를 실행합니다. 그러나 직접 Selenium 서버를 시작하고 원하는 브라우저에서 테스트를 실행할 수도 있습니다.

시작하려면, tests/DuskTestCase.php 파일을 열어보세요. 이 파일은 애플리케이션용 기본 Dusk 테스트 케이스입니다. 파일 내에서 startChromeDriver 메서드 호출을 제거할 수 있습니다. 이렇게 하면 Dusk가 ChromeDriver를 자동으로 시작하는 것을 중지합니다:

/**
 * Prepare for Dusk test execution.
 *
 * @beforeClass
 */
public static function prepare(): void
{
    // static::startChromeDriver();
}

다음으로, 원하는 URL과 포트에 연결하도록 driver 메서드를 수정할 수 있습니다. 또한 WebDriver에 전달되어야 하는 “원하는 기능(desired capabilities)”을 수정할 수 있습니다:

use Facebook\WebDriver\Remote\RemoteWebDriver;

/**
 * Create the RemoteWebDriver instance.
 */
protected function driver(): RemoteWebDriver
{
    return RemoteWebDriver::create(
        'http://localhost:4444/wd/hub', DesiredCapabilities::phantomjs()
    );
}

시작하기

테스트 생성하기

Dusk 테스트를 생성하려면 dusk:make Artisan 명령어를 사용하세요. 생성된 테스트는 tests/Browser 디렉토리에 배치됩니다:

php artisan dusk:make LoginTest

각 테스트 후 데이터베이스 재설정

작성하는 대부분의 테스트는 애플리케이션 데이터베이스에서 데이터를 가져오는 페이지와 상호작용하지만, Dusk 테스트에서는 RefreshDatabase 트레잇을 절대 사용해서는 안 됩니다. RefreshDatabase 트레잇은 HTTP 요청 간에 적용되거나 사용 가능하지 않은 데이터베이스 트랜잭션을 활용합니다. 대신 두 가지 옵션이 있습니다: DatabaseMigrations 트레잇과 DatabaseTruncation 트레잇.

데이터베이스 마이그레이션 사용

DatabaseMigrations 트레잇은 각 테스트 전에 데이터베이스 마이그레이션을 실행합니다. 그러나 각 테스트마다 데이터베이스 테이블을 삭제하고 다시 생성하는 것은 일반적으로 테이블을 잘라내는(truncating) 것보다 느립니다:```php tab=Pest <?php

use Illuminate\Foundation\Testing\DatabaseMigrations;

pest()->use(DatabaseMigrations::class);

```php tab=PHPUnit
<?php

namespace Tests\Browser;

use Illuminate\Foundation\Testing\DatabaseMigrations;
use Laravel\Dusk\Browser;
use Tests\DuskTestCase;

class ExampleTest extends DuskTestCase
{
    use DatabaseMigrations;

    //
}

[!WARNING] Dusk 테스트를 실행할 때 SQLite 인메모리 데이터베이스는 사용할 수 없습니다. 브라우저가 자체 프로세스 내에서 실행되기 때문에 다른 프로세스의 인메모리 데이터베이스에 접근할 수 없습니다.

데이터베이스 트렁케이션 사용

DatabaseTruncation 트레이트는 데이터베이스 테이블이 올바르게 생성되었는지 확인하기 위해 첫 번째 테스트에서 데이터베이스를 마이그레이션합니다. 그러나 이후 테스트에서는 데이터베이스의 테이블이 단순히 트렁케이트되므로, 모든 데이터베이스 마이그레이션을 다시 실행하는 것보다 속도가 향상됩니다:```php tab=Pest <?php

use Illuminate\Foundation\Testing\DatabaseTruncation;

pest()->use(DatabaseTruncation::class);

```php tab=PHPUnit
<?php

namespace Tests\Browser;

use App\Models\User;
use Illuminate\Foundation\Testing\DatabaseTruncation;
use Laravel\Dusk\Browser;
use Tests\DuskTestCase;

class ExampleTest extends DuskTestCase
{
    use DatabaseTruncation;

    //
}

기본적으로, 이 트레잇은 migrations 테이블을 제외한 모든 테이블을 잘라냅니다. 잘라낼 테이블을 사용자 정의하고 싶다면, 테스트 클래스에 $tablesToTruncate 속성을 정의할 수 있습니다:

[!NOTE] Pest를 사용하는 경우, 기본 DuskTestCase 클래스나 테스트 파일이 확장하는 클래스 중 어느 곳에든 속성이나 메서드를 정의해야 합니다.

/**
 * Indicates which tables should be truncated.
 *
 * @var array
 */
protected $tablesToTruncate = ['users'];

또는 테스트 클래스에서 $exceptTables 속성을 정의하여 잘라내기에서 제외해야 하는 테이블을 지정할 수 있습니다:

/**
 * Indicates which tables should be excluded from truncation.
 *
 * @var array
 */
protected $exceptTables = ['users'];

테이블을 잘라야 하는 데이터베이스 연결을 지정하려면 테스트 클래스에 $connectionsToTruncate 속성을 정의할 수 있습니다:

/**
 * Indicates which connections should have their tables truncated.
 *
 * @var array
 */
protected $connectionsToTruncate = ['mysql'];

데이터베이스 절단이 수행되기 전이나 후에 코드를 실행하고 싶다면, 테스트 클래스에 beforeTruncatingDatabase 또는 afterTruncatingDatabase 메서드를 정의할 수 있습니다:

/**
 * Perform any work that should take place before the database has started truncating.
 */
protected function beforeTruncatingDatabase(): void
{
    //
}

/**
 * Perform any work that should take place after the database has finished truncating.
 */
protected function afterTruncatingDatabase(): void
{
    //
}

테스트 실행

브라우저 테스트를 실행하려면, dusk Artisan 명령어를 실행하세요:

php artisan dusk

마지막으로 dusk 명령을 실행했을 때 테스트가 실패했다면, dusk:fails 명령을 사용하여 먼저 실패한 테스트를 다시 실행함으로써 시간을 절약할 수 있습니다:

php artisan dusk:fails

dusk 명령은 특정 그룹에 대한 테스트만 실행하도록 허용하는 것과 같이 일반적으로 Pest / PHPUnit 테스트 러너에서 허용되는 모든 인수를 받아들입니다:

php artisan dusk --group=foo

[!NOTE] 로컬 개발 환경을 관리하기 위해 Laravel Sail을 사용하고 있다면, Dusk 테스트 설정 및 실행에 대한 Sail 문서를 참조하세요.

ChromeDriver 수동 시작

기본적으로 Dusk는 ChromeDriver를 자동으로 시작하려고 시도합니다. 만약 특정 시스템에서 이것이 작동하지 않는다면, dusk 명령을 실행하기 전에 ChromeDriver를 수동으로 시작할 수 있습니다. 수동으로 ChromeDriver를 시작하기로 선택한 경우, tests/DuskTestCase.php 파일의 다음 줄을 주석 처리해야 합니다:

/**
 * Prepare for Dusk test execution.
 *
 * @beforeClass
 */
public static function prepare(): void
{
    // static::startChromeDriver();
}

또한, ChromeDriver를 9515가 아닌 다른 포트에서 시작하는 경우, 동일한 클래스의 driver 메서드를 올바른 포트를 반영하도록 수정해야 합니다:

use Facebook\WebDriver\Remote\RemoteWebDriver;

/**
 * Create the RemoteWebDriver instance.
 */
protected function driver(): RemoteWebDriver
{
    return RemoteWebDriver::create(
        'http://localhost:9515', DesiredCapabilities::chrome()
    );
}

환경 처리

테스트를 실행할 때 Dusk가 자체 환경 파일을 사용하도록 강제하려면 프로젝트 루트에 .env.dusk.{environment} 파일을 생성하세요. 예를 들어, local 환경에서 dusk 명령을 실행할 예정이라면 .env.dusk.local 파일을 생성해야 합니다.

테스트를 실행할 때 Dusk는 .env 파일을 백업하고 Dusk 환경의 이름을 .env로 변경합니다. 테스트가 완료되면 .env 파일이 복원됩니다.

브라우저 기초

브라우저 생성

시작하려면, 우리 애플리케이션에 로그인할 수 있는지 검증하는 테스트를 작성해 봅시다. 테스트를 생성한 후에는 로그인 페이지로 이동하고, 자격 증명을 입력하며, “로그인” 버튼을 클릭하도록 수정할 수 있습니다. 브라우저 인스턴스를 생성하려면 Dusk 테스트 내에서 browse 메서드를 호출하면 됩니다:```php tab=Pest <?php

use App\Models\User; use Illuminate\Foundation\Testing\DatabaseMigrations;

pest()->use(DatabaseMigrations::class);

test(‘basic example’, function () { $user = User::factory()->create([ ‘email’ => ‘taylor@laravel.com’, ]);

$this->browse(function (Browser $browser) use ($user) {
    $browser->visit('/login')
        ->type('email', $user->email)
        ->type('password', 'password')
        ->press('Login')
        ->assertPathIs('/home');
}); }); ```

```php tab=PHPUnit <?php

namespace Tests\Browser;

use App\Models\User; use Illuminate\Foundation\Testing\DatabaseMigrations; use Laravel\Dusk\Browser; use Tests\DuskTestCase;

class ExampleTest extends DuskTestCase { use DatabaseMigrations;

/**
 * A basic browser test example.
 */
public function test_basic_example(): void
{
    $user = User::factory()->create([
        'email' => 'taylor@laravel.com',
    ]);

    $this->browse(function (Browser $browser) use ($user) {
        $browser->visit('/login')
            ->type('email', $user->email)
            ->type('password', 'password')
            ->press('Login')
            ->assertPathIs('/home');
    });
} } ```

위의 예제에서 볼 수 있듯이, browse 메서드는 클로저를 허용합니다. 브라우저 인스턴스는 Dusk에 의해 자동으로 이 클로저에 전달되며, 애플리케이션과 상호작용하고 애플리케이션에 대한 단언을 수행하는 데 사용되는 주요 객체입니다.

여러 브라우저 생성하기

테스트를 적절하게 수행하기 위해 때때로 여러 개의 브라우저가 필요할 수 있습니다. 예를 들어, 웹소켓과 상호작용하는 채팅 화면을 테스트하려면 여러 브라우저가 필요할 수 있습니다. 여러 브라우저를 생성하려면, browse 메서드에 제공된 클로저의 시그니처에 브라우저 인수를 추가하기만 하면 됩니다:

$this->browse(function (Browser $first, Browser $second) {
    $first->loginAs(User::find(1))
        ->visit('/home')
        ->waitForText('Message');

    $second->loginAs(User::find(2))
        ->visit('/home')
        ->waitForText('Message')
        ->type('message', 'Hey Taylor')
        ->press('Send');

    $first->waitForText('Hey Taylor')
        ->assertSee('Jeffrey Way');
});

탐색

visit 메서드는 애플리케이션 내에서 주어진 URI로 이동하는 데 사용할 수 있습니다:

$browser->visit('/login');

visitRoute 방법을 사용하여 이름 있는 경로로 이동할 수 있습니다:

$browser->visitRoute($routeName, $parameters);

back 및 forward 방법을 사용하여 ‘뒤로’ 및 ‘앞으로’ 이동할 수 있습니다:

$browser->back();

$browser->forward();

페이지를 새로 고치기 위해 refresh 방법을 사용할 수 있습니다:

$browser->refresh();

브라우저 창 크기 조정

브라우저 창의 크기를 조정하려면 resize 방법을 사용할 수 있습니다:

$browser->resize(1920, 1080);

maximize 방법은 브라우저 창을 최대화하는 데 사용할 수 있습니다:

$browser->maximize();

fitContent 방법은 브라우저 창의 크기를 내용의 크기에 맞게 조정합니다:

$browser->fitContent();

테스트가 실패하면 Dusk는 스크린샷을 찍기 전에 콘텐츠에 맞게 브라우저 크기를 자동으로 조정합니다. 테스트 내에서 disableFitOnFailure 메서드를 호출하여 이 기능을 비활성화할 수 있습니다:

$browser->disableFitOnFailure();

브라우저 창을 화면의 다른 위치로 이동하려면 move 방법을 사용할 수 있습니다:

$browser->move($x = 100, $y = 100);

브라우저 매크로

테스트에서 재사용할 수 있는 맞춤 브라우저 메서드를 정의하려면 Browser 클래스에서 macro 메서드를 사용할 수 있습니다. 일반적으로 이 메서드는 서비스 제공자의 boot 메서드에서 호출해야 합니다:

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Laravel\Dusk\Browser;

class DuskServiceProvider extends ServiceProvider
{
    /**
     * Register Dusk's browser macros.
     */
    public function boot(): void
    {
        Browser::macro('scrollToElement', function (string $element = null) {
            $this->script("$('html, body').animate({ scrollTop: $('$element').offset().top }, 0);");

            return $this;
        });
    }
}

macro 함수는 첫 번째 인수로 이름을 받고, 두 번째 인수로 클로저를 받습니다. 매크로의 클로저는 Browser 인스턴스에서 매크로를 메서드로 호출할 때 실행됩니다:

$this->browse(function (Browser $browser) use ($user) {
    $browser->visit('/pay')
        ->scrollToElement('#credit-card-details')
        ->assertSee('Enter Credit Card Details');
});

인증

종종 인증이 필요한 페이지를 테스트하게 됩니다. 매 테스트마다 애플리케이션의 로그인 화면과 상호작용하지 않으려면 Dusk의 loginAs 방법을 사용할 수 있습니다. loginAs 방법은 인증 가능한 모델과 연결된 기본 키 또는 인증 가능한 모델 인스턴스를 받습니다:

use App\Models\User;
use Laravel\Dusk\Browser;

$this->browse(function (Browser $browser) {
    $browser->loginAs(User::find(1))
        ->visit('/home');
});

[!WARNING] loginAs 방법을 사용한 후, 사용자 세션은 파일 내의 모든 테스트에서 유지됩니다.

쿠키

암호화된 쿠키의 값을 가져오거나 설정하려면 cookie 방법을 사용할 수 있습니다. 기본적으로, Laravel에서 생성된 모든 쿠키는 암호화됩니다:

$browser->cookie('name');

$browser->cookie('name', 'Taylor');

암호화되지 않은 쿠키의 값을 가져오거나 설정하려면 plainCookie 방법을 사용할 수 있습니다:

$browser->plainCookie('name');

$browser->plainCookie('name', 'Taylor');

주어진 쿠키를 삭제하기 위해 deleteCookie 방법을 사용할 수 있습니다:

$browser->deleteCookie('name');

자바스크립트 실행

브라우저 내에서 임의의 자바스크립트 문장을 실행하기 위해 script 메서드를 사용할 수 있습니다:

$browser->script('document.documentElement.scrollTop = 0');

$browser->script([
    'document.body.scrollTop = 0',
    'document.documentElement.scrollTop = 0',
]);

$output = $browser->script('return window.location.pathname');

스크린샷 찍기

주어진 파일 이름으로 스크린샷을 찍고 저장하려면 screenshot 방법을 사용할 수 있습니다. 모든 스크린샷은 tests/Browser/screenshots 디렉토리 내에 저장됩니다:

$browser->screenshot('filename');

responsiveScreenshots 방법은 다양한 중단점에서 일련의 스크린샷을 찍는 데 사용할 수 있습니다:

$browser->responsiveScreenshots('filename');

screenshotElement 메서드는 페이지의 특정 요소의 스크린샷을 찍는 데 사용할 수 있습니다:

$browser->screenshotElement('#selector', 'filename');

콘솔 출력을 디스크에 저장하기

현재 브라우저의 콘솔 출력을 주어진 파일 이름으로 디스크에 쓰려면 storeConsoleLog 방법을 사용할 수 있습니다. 콘솔 출력은 다음 tests/Browser/console 디렉토리에 저장됩니다:

$browser->storeConsoleLog('filename');

페이지 소스를 디스크에 저장하기

현재 페이지의 소스를 주어진 파일 이름으로 디스크에 쓰기 위해 storeSource 방법을 사용할 수 있습니다. 페이지 소스는 tests/Browser/source 디렉토리에 저장됩니다:

$browser->storeSource('filename');

요소와 상호 작용하기

Dusk 선택자

요소와 상호 작용하기 위한 좋은 CSS 선택자를 선택하는 것은 Dusk 테스트를 작성할 때 가장 어려운 부분 중 하나입니다. 시간이 지나면서 프론트엔드 변경으로 인해 다음과 같은 CSS 선택자가 테스트를 망가뜨릴 수 있습니다:

// HTML...

<button>Login</button>

// Test...

$browser->click('.login-page .container div > button');

Dusk 셀렉터를 사용하면 CSS 셀렉터를 기억하는 대신 효과적인 테스트 작성에 집중할 수 있습니다. 셀렉터를 정의하려면 HTML 요소에 dusk 속성을 추가하세요. 그런 다음 Dusk 브라우저와 상호작용할 때, 테스트 내에서 연결된 요소를 조작하기 위해 셀렉터 앞에 @를 붙이세요:

// HTML...

<button dusk="login-button">Login</button>

// Test...

$browser->click('@login-button');

원하는 경우, selectorHtmlAttribute 메서드를 통해 Dusk 선택자가 사용하는 HTML 속성을 사용자 정의할 수 있습니다. 일반적으로 이 메서드는 애플리케이션의 AppServiceProvider의 boot 메서드에서 호출해야 합니다:

use Laravel\Dusk\Dusk;

Dusk::selectorHtmlAttribute('data-dusk');

텍스트, 값, 그리고 속성

값 가져오기 및 설정

Dusk는 페이지의 요소들의 현재 값, 표시 텍스트 및 속성들과 상호작용할 수 있는 여러 방법을 제공합니다. 예를 들어, 주어진 CSS 또는 Dusk 선택자와 일치하는 요소의 “값”을 가져오려면 value 메서드를 사용하세요:

// Retrieve the value...
$value = $browser->value('selector');

// Set the value...
$browser->value('selector', 'value');

지정된 필드 이름을 가진 입력 요소의 “값”을 가져오기 위해 inputValue 방법을 사용할 수 있습니다:

$value = $browser->inputValue('field');

텍스트 가져오기

text 메서드는 주어진 선택자와 일치하는 요소의 표시 텍스트를 가져오는 데 사용할 수 있습니다:

$text = $browser->text('selector');

속성 가져오기

마지막으로, 주어진 선택자와 일치하는 요소의 속성 값을 가져오기 위해 attribute 메서드를 사용할 수 있습니다:

$attribute = $browser->attribute('selector', 'value');

폼과 상호작용하기

값 입력하기

Dusk는 폼과 입력 요소와 상호작용할 수 있는 다양한 방법을 제공합니다. 먼저, 입력 필드에 텍스트를 입력하는 예제를 살펴보겠습니다:

$browser->type('email', 'taylor@laravel.com');

참고로, 필요하다면 메서드가 하나를 허용하지만, type 메서드에 CSS 선택자를 전달할 필요는 없습니다. CSS 선택자가 제공되지 않으면, Dusk는 주어진 name 속성을 가진 input 또는 textarea 필드를 검색합니다.

내용을 지우지 않고 필드에 텍스트를 추가하려면 append 메서드를 사용할 수 있습니다:

$browser->type('tags', 'foo')
    ->append('tags', ', bar, baz');

clear 메서드를 사용하여 입력 값(input)의 값을 지울 수 있습니다:

$browser->clear('email');

Dusk에게 typeSlowly 방법을 사용하여 천천히 입력하도록 지시할 수 있습니다. 기본적으로 Dusk는 키를 누를 때마다 100밀리초 동안 일시 중지합니다. 키를 누르는 시간 간격을 사용자 지정하려면, 해당 메서드의 세 번째 인수로 적절한 밀리초 수를 전달할 수 있습니다:

$browser->typeSlowly('mobile', '+1 (202) 555-5555');

$browser->typeSlowly('mobile', '+1 (202) 555-5555', 300);

텍스트를 천천히 추가하려면 appendSlowly 방법을 사용할 수 있습니다:

$browser->type('tags', 'foo')
    ->appendSlowly('tags', ', bar, baz');

드롭다운

select 요소에서 사용 가능한 값을 선택하려면 select 메서드를 사용할 수 있습니다. type 메서드와 마찬가지로 select 메서드는 전체 CSS 선택자가 필요하지 않습니다. select 메서드에 값을 전달할 때는 표시 텍스트 대신 기본 옵션 값을 전달해야 합니다:

$browser->select('size', 'Large');

두 번째 인수를 생략하면 임의의 옵션을 선택할 수 있습니다:

$browser->select('size');

select 메서드에 두 번째 인수로 배열을 제공하면 메서드가 여러 옵션을 선택하도록 지시할 수 있습니다:

$browser->select('categories', ['Art', 'Music']);

체크박스

체크박스 입력을 “체크”하려면 check 방법을 사용할 수 있습니다. 다른 많은 입력 관련 방법과 마찬가지로 전체 CSS 선택자가 필요하지 않습니다. CSS 선택자 일치를 찾을 수 없는 경우, Dusk는 일치하는 name 속성을 가진 체크박스를 검색합니다:

$browser->check('terms');

uncheck 방법은 체크박스 입력을 ‘체크 해제’하는 데 사용할 수 있습니다:

$browser->uncheck('terms');

라디오 버튼

radio 입력 옵션을 “선택”하려면 radio 방법을 사용할 수 있습니다. 다른 많은 입력 관련 메서드와 마찬가지로 전체 CSS 선택자는 필요하지 않습니다. CSS 선택자 매치를 찾을 수 없는 경우, Dusk는 일치하는 name 및 value 속성을 가진 radio 입력을 검색합니다:

$browser->radio('size', 'large');

파일 첨부

attach 메서드는 파일을 file 입력 요소에 첨부하는 데 사용될 수 있습니다. 다른 많은 입력 관련 메서드와 마찬가지로 전체 CSS 선택자가 필요하지 않습니다. CSS 선택자 매치를 찾을 수 없는 경우, Dusk는 일치하는 name 속성을 가진 file 입력을 검색합니다:

$browser->attach('photo', __DIR__.'/photos/mountains.png');

[!WARNING] attach 함수는 서버에 Zip PHP 확장이 설치되어 활성화되어 있어야 합니다.

버튼 누르기

press 메서드는 페이지의 버튼 요소를 클릭하는 데 사용할 수 있습니다. press 메서드에 전달되는 인수는 버튼의 표시 텍스트이거나 CSS / Dusk 선택자일 수 있습니다:

$browser->press('Login');

양식을 제출할 때, 많은 애플리케이션은 버튼을 눌러 양식을 제출한 후 제출 버튼을 비활성화하고, 양식 제출의 HTTP 요청이 완료되면 버튼을 다시 활성화합니다. 버튼을 누른 후 버튼이 다시 활성화될 때까지 기다리려면 pressAndWaitFor 방법을 사용할 수 있습니다:

// Press the button and wait a maximum of 5 seconds for it to be enabled...
$browser->pressAndWaitFor('Save');

// Press the button and wait a maximum of 1 second for it to be enabled...
$browser->pressAndWaitFor('Save', 1);

링크 클릭

링크를 클릭하려면 브라우저 인스턴스에서 clickLink 방법을 사용할 수 있습니다. clickLink 방법은 주어진 표시 텍스트를 가진 링크를 클릭합니다:

$browser->clickLink($linkText);

다음 표시 텍스트를 가진 링크가 페이지에 표시되는지 확인하려면 seeLink 방법을 사용할 수 있습니다:

if ($browser->seeLink($linkText)) {
    // ...
}

[!WARNING] 이 메서드들은 jQuery와 상호작용합니다. 페이지에 jQuery가 없으면, Dusk는 테스트 기간 동안 사용할 수 있도록 자동으로 페이지에 jQuery를 주입합니다.

키보드 사용하기

keys 메서드는 type 메서드가 일반적으로 허용하는 것보다 더 복잡한 입력 시퀀스를 특정 요소에 제공할 수 있게 해줍니다. 예를 들어, 값을 입력하는 동안 Dusk에게 수정 키를 누른 채로 입력하도록 지시할 수 있습니다. 이 예제에서는 shift 키를 누른 상태에서 taylor가 주어진 선택자와 일치하는 요소에 입력됩니다. taylor가 입력된 후에는 swift가 수정 키 없이 입력됩니다:

$browser->keys('selector', ['{shift}', 'taylor'], 'swift');

keys 방법의 또 다른 가치 있는 사용 사례는 애플리케이션의 주요 CSS 선택자에 ‘키보드 단축키’ 조합을 보내는 것입니다:

$browser->keys('.app', ['{command}', 'j']);

[!NOTE] {command}와 같은 모든 수정 키는 {} 문자로 감싸져 있으며, Facebook\WebDriver\WebDriverKeys 클래스에 정의된 상수와 일치합니다. 해당 클래스는 GitHub에서 확인할 수 있습니다.

유창한 키보드 상호작용

Dusk는 또한 withKeyboard 메서드를 제공하여 Laravel\Dusk\Keyboard 클래스를 통해 복잡한 키보드 상호작용을 유창하게 수행할 수 있습니다. Keyboard 클래스는 press, release, type, pause 메서드를 제공합니다:

use Laravel\Dusk\Keyboard;

$browser->withKeyboard(function (Keyboard $keyboard) {
    $keyboard->press('c')
        ->pause(1000)
        ->release('c')
        ->type(['c', 'e', 'o']);
});

키보드 매크로

테스트 스위트 전체에서 쉽게 재사용할 수 있는 사용자 정의 키보드 상호작용을 정의하고 싶다면 Keyboard 클래스에서 제공하는 macro 메서드를 사용할 수 있습니다. 일반적으로 이 메서드는 서비스 제공자의 boot 메서드에서 호출해야 합니다:

<?php

namespace App\Providers;

use Facebook\WebDriver\WebDriverKeys;
use Illuminate\Support\ServiceProvider;
use Laravel\Dusk\Keyboard;
use Laravel\Dusk\OperatingSystem;

class DuskServiceProvider extends ServiceProvider
{
    /**
     * Register Dusk's browser macros.
     */
    public function boot(): void
    {
        Keyboard::macro('copy', function (string $element = null) {
            $this->type([
                OperatingSystem::onMac() ? WebDriverKeys::META : WebDriverKeys::CONTROL, 'c',
            ]);

            return $this;
        });

        Keyboard::macro('paste', function (string $element = null) {
            $this->type([
                OperatingSystem::onMac() ? WebDriverKeys::META : WebDriverKeys::CONTROL, 'v',
            ]);

            return $this;
        });
    }
}

macro 함수는 첫 번째 인수로 이름을, 두 번째 인수로 클로저를 받습니다. 매크로의 클로저는 Keyboard 인스턴스에서 메서드로 매크로를 호출할 때 실행됩니다:

$browser->click('@textarea')
    ->withKeyboard(fn (Keyboard $keyboard) => $keyboard->copy())
    ->click('@another-textarea')
    ->withKeyboard(fn (Keyboard $keyboard) => $keyboard->paste());

마우스 사용

요소 클릭

click 메서드는 주어진 CSS 또는 Dusk 선택자와 일치하는 요소를 클릭하는 데 사용할 수 있습니다:

$browser->click('.selector');

clickAtXPath 방법은 주어진 XPath 표현식과 일치하는 요소를 클릭하는 데 사용될 수 있습니다:

$browser->clickAtXPath('//div[@class = "selector"]');

clickAtPoint 방법은 브라우저의 표시 가능한 영역을 기준으로 주어진 좌표 쌍에서 가장 위에 있는 요소를 클릭하는 데 사용할 수 있습니다:

$browser->clickAtPoint($x = 0, $y = 0);

doubleClick 방법은 마우스 더블 클릭을 시뮬레이션하는 데 사용할 수 있습니다:

$browser->doubleClick();

$browser->doubleClick('.selector');

rightClick 방법은 마우스의 오른쪽 클릭을 시뮬레이션하는 데 사용될 수 있습니다:

$browser->rightClick();

$browser->rightClick('.selector');

clickAndHold 메서드는 마우스 버튼이 눌린 상태로 클릭되는 것을 시뮬레이션하는 데 사용될 수 있습니다. 이후 releaseMouse 메서드를 호출하면 이 동작이 취소되고 마우스 버튼이 놓이게 됩니다:

$browser->clickAndHold('.selector');

$browser->clickAndHold()
    ->pause(1000)
    ->releaseMouse();

controlClick 방법은 브라우저 내에서 ctrl+click 이벤트를 시뮬레이션하는 데 사용될 수 있습니다:

$browser->controlClick();

$browser->controlClick('.selector');

clickWhenVisible 또는 clickWhenEnabled 방법은 요소를 정확히 한 번 클릭하기 전에 준비될 때까지 기다리는 데 사용할 수 있습니다:

$browser->clickWhenVisible('@save-button');
$browser->clickWhenEnabled('@submit-button');

마우스오버

mouseover 메서드는 주어진 CSS 또는 Dusk 선택자와 일치하는 요소 위로 마우스를 이동해야 할 때 사용할 수 있습니다:

$browser->mouseover('.selector');

끌기 및 놓기

drag 메서드는 주어진 선택자와 일치하는 요소를 다른 요소로 끌어 놓는 데 사용할 수 있습니다:

$browser->drag('.from-selector', '.to-selector');

또는 요소를 한 방향으로만 드래그할 수 있습니다:

$browser->dragLeft('.selector', $pixels = 10);
$browser->dragRight('.selector', $pixels = 10);
$browser->dragUp('.selector', $pixels = 10);
$browser->dragDown('.selector', $pixels = 10);

마지막으로, 주어진 오프셋만큼 요소를 끌 수 있습니다:

$browser->dragOffset('.selector', $x = 10, $y = 10);

자바스크립트 다이얼로그

Dusk는 자바스크립트 다이얼로그와 상호작용할 수 있는 다양한 방법을 제공합니다. 예를 들어, 다이얼로그가 나타날 때까지 기다리기 위해 waitForDialog 메서드를 사용할 수 있습니다. 이 메서드는 다이얼로그가 나타날 때까지 몇 초 동안 기다릴지 나타내는 선택적 인수를 받습니다:

$browser->waitForDialog($seconds = null);

assertDialogOpened 방법은 대화 상자가 표시되었고 지정된 메시지를 포함하고 있음을 확인하는 데 사용될 수 있습니다:

$browser->assertDialogOpened('Dialog message');

JavaScript 대화 상자에 프롬프트가 포함된 경우 typeInDialog 메서드를 사용하여 프롬프트에 값을 입력할 수 있습니다:

$browser->typeInDialog('Hello World');

열려 있는 JavaScript 대화 상자를 ‘확인’ 버튼을 클릭하여 닫으려면, acceptDialog 메서드를 호출할 수 있습니다:

$browser->acceptDialog();

열려 있는 JavaScript 대화 상자를 ‘취소’ 버튼을 클릭하여 닫으려면, dismissDialog 메서드를 호출할 수 있습니다:

$browser->dismissDialog();

인라인 프레임과 상호작용하기

iframe 내의 요소와 상호작용해야 하는 경우, withinFrame 방법을 사용할 수 있습니다. withinFrame 메서드에 제공된 클로저 내에서 일어나는 모든 요소 상호작용은 지정된 iframe의 컨텍스트로 범위가 지정됩니다:

$browser->withinFrame('#credit-card-details', function ($browser) {
    $browser->type('input[name="cardnumber"]', '4242424242424242')
        ->type('input[name="exp-date"]', '1224')
        ->type('input[name="cvc"]', '123')
        ->press('Pay');
});

선택자 범위 지정

때때로 모든 작업을 주어진 선택자 내에서 범위 지정하면서 여러 작업을 수행하고자 할 수 있습니다. 예를 들어, 특정 텍스트가 테이블 내에만 존재하는지 확인한 후 그 테이블 내의 버튼을 클릭하고자 할 수 있습니다. 이를 수행하기 위해 with 메서드를 사용할 수 있습니다. with 메서드에 제공된 클로저 내에서 수행되는 모든 작업은 원래 선택자에 범위가 지정됩니다:

$browser->with('.table', function (Browser $table) {
    $table->assertSee('Hello World')
        ->clickLink('Delete');
});

가끔 현재 범위 외부에서 어설션을 실행해야 할 수도 있습니다. 이를 수행하기 위해 elsewhere 및 elsewhereWhenAvailable 메서드를 사용할 수 있습니다:

$browser->with('.table', function (Browser $table) {
    // Current scope is `body .table`...

    $browser->elsewhere('.page-title', function (Browser $title) {
        // Current scope is `body .page-title`...
        $title->assertSee('Hello World');
    });

    $browser->elsewhereWhenAvailable('.page-title', function (Browser $title) {
        // Current scope is `body .page-title`...
        $title->assertSee('Hello World');
    });
});

요소 대기

JavaScript를 광범위하게 사용하는 애플리케이션을 테스트할 때, 종종 테스트를 진행하기 전에 특정 요소나 데이터가 사용 가능해질 때까지 “대기”해야 할 필요가 있습니다. Dusk는 이를 매우 쉽게 만들어 줍니다. 다양한 방법을 사용하여 페이지에서 요소가 표시될 때까지 기다리거나 특정 JavaScript 표현식이 true이 될 때까지 기다릴 수 있습니다.

대기

단순히 주어진 밀리초(ms)만큼 테스트를 일시 중지해야 하는 경우, pause 메서드를 사용하세요:

$browser->pause(1000);

주어진 조건이 true인 경우에만 테스트를 일시 중지해야 한다면, pauseIf 메서드를 사용하세요:

$browser->pauseIf(App::environment('production'), 1000);

마찬가지로, 지정된 조건이 true가 아닌 한 테스트를 일시 중지해야 하는 경우, pauseUnless 방법을 사용할 수 있습니다:

$browser->pauseUnless(App::environment('testing'), 1000);

선택자 대기

waitFor 메서드는 지정된 CSS 또는 Dusk 선택자와 일치하는 요소가 페이지에 표시될 때까지 테스트 실행을 일시 중지하는 데 사용할 수 있습니다. 기본적으로, 이 메서드는 예외를 발생시키기 전 최대 5초 동안 테스트를 일시 중지합니다. 필요하다면, 메서드의 두 번째 인수로 사용자 지정 타임아웃 임계값을 전달할 수 있습니다:

// Wait a maximum of five seconds for the selector...
$browser->waitFor('.selector');

// Wait a maximum of one second for the selector...
$browser->waitFor('.selector', 1);

지정된 선택자와 일치하는 요소가 지정된 텍스트를 포함할 때까지 기다릴 수도 있습니다:

// Wait a maximum of five seconds for the selector to contain the given text...
$browser->waitForTextIn('.selector', 'Hello World');

// Wait a maximum of one second for the selector to contain the given text...
$browser->waitForTextIn('.selector', 'Hello World', 1);

주어진 선택자와 일치하는 요소가 페이지에서 사라질 때까지 기다릴 수도 있습니다:

// Wait a maximum of five seconds until the selector is missing...
$browser->waitUntilMissing('.selector');

// Wait a maximum of one second until the selector is missing...
$browser->waitUntilMissing('.selector', 1);

또는 주어진 선택자와 일치하는 요소가 활성화되거나 비활성화될 때까지 기다릴 수 있습니다:

// Wait a maximum of five seconds until the selector is enabled...
$browser->waitUntilEnabled('.selector');

// Wait a maximum of one second until the selector is enabled...
$browser->waitUntilEnabled('.selector', 1);

// Wait a maximum of five seconds until the selector is disabled...
$browser->waitUntilDisabled('.selector');

// Wait a maximum of one second until the selector is disabled...
$browser->waitUntilDisabled('.selector', 1);

사용 가능한 경우 선택자 범위 지정

때때로, 주어진 선택자와 일치하는 요소가 나타날 때까지 기다린 후 해당 요소와 상호작용하고 싶을 수 있습니다. 예를 들어, 모달 창이 활성화될 때까지 기다린 다음 모달 내의 “확인” 버튼을 누르고 싶을 수 있습니다. 이 작업은 whenAvailable 메서드를 사용하여 수행할 수 있습니다. 주어진 클로저 내에서 수행되는 모든 요소 작업은 원래 선택자 범위에 제한됩니다:

$browser->whenAvailable('.modal', function (Browser $modal) {
    $modal->assertSee('Hello World')
        ->press('OK');
});

텍스트를 기다리는 중

waitForText 메서드는 페이지에 지정된 텍스트가 표시될 때까지 기다리는 데 사용될 수 있습니다:

// Wait a maximum of five seconds for the text...
$browser->waitForText('Hello World');

// Wait a maximum of one second for the text...
$browser->waitForText('Hello World', 1);

표시된 텍스트가 페이지에서 제거될 때까지 기다리기 위해 waitUntilMissingText 방법을 사용할 수 있습니다:

// Wait a maximum of five seconds for the text to be removed...
$browser->waitUntilMissingText('Hello World');

// Wait a maximum of one second for the text to be removed...
$browser->waitUntilMissingText('Hello World', 1);

링크 대기 중

waitForLink 메서드는 주어진 링크 텍스트가 페이지에 표시될 때까지 대기하는 데 사용할 수 있습니다:

// Wait a maximum of five seconds for the link...
$browser->waitForLink('Create');

// Wait a maximum of one second for the link...
$browser->waitForLink('Create', 1);

입력 대기 중

waitForInput 메서드는 주어진 입력 필드가 페이지에 표시될 때까지 기다리는 데 사용할 수 있습니다:

// Wait a maximum of five seconds for the input...
$browser->waitForInput($field);

// Wait a maximum of one second for the input...
$browser->waitForInput($field, 1);

페이지 위치 대기

$browser->assertPathIs('/home')와 같은 경로 주장을 할 때, window.location.pathname가 비동기적으로 업데이트되는 경우 주장이 실패할 수 있습니다. 위치가 특정 값이 될 때까지 대기하려면 waitForLocation 메서드를 사용할 수 있습니다:

$browser->waitForLocation('/secret');

waitForLocation 방법은 현재 창 위치가 완전한 URL이 될 때까지 기다리는 데에도 사용할 수 있습니다:

$browser->waitForLocation('https://example.com/path');

또한 이름이 지정된 경로의 위치를 기다릴 수도 있습니다:

$browser->waitForRoute($routeName, $parameters);

페이지 재로드 대기

작업을 수행한 후 페이지가 재로드될 때까지 기다려야 하는 경우, waitForReload 방법을 사용하세요:

use Laravel\Dusk\Browser;

$browser->waitForReload(function (Browser $browser) {
    $browser->press('Submit');
})
->assertSee('Success!');

페이지가 다시 로드될 때까지 기다려야 하는 필요는 일반적으로 버튼을 클릭한 후에 발생하므로, 편의를 위해 clickAndWaitForReload 방법을 사용할 수 있습니다:

$browser->clickAndWaitForReload('.selector')
    ->assertSee('something');

JavaScript 표현식 대기

때때로 특정 JavaScript 표현식이 true로 평가될 때까지 테스트 실행을 일시 중지하고 싶을 수 있습니다. 이는 waitUntil 메서드를 사용하면 쉽게 수행할 수 있습니다. 이 메서드에 표현식을 전달할 때는 return 키워드나 끝 세미콜론을 포함할 필요가 없습니다:

// Wait a maximum of five seconds for the expression to be true...
$browser->waitUntil('App.data.servers.length > 0');

// Wait a maximum of one second for the expression to be true...
$browser->waitUntil('App.data.servers.length > 0', 1);

Vue 표현 대기

waitUntilVue 및 waitUntilVueIsNot 메서드는 Vue 컴포넌트 속성이 특정 값을 가질 때까지 대기하는 데 사용할 수 있습니다:

// Wait until the component attribute contains the given value...
$browser->waitUntilVue('user.name', 'Taylor', '@user');

// Wait until the component attribute doesn't contain the given value...
$browser->waitUntilVueIsNot('user.name', null, '@user');

자바스크립트 이벤트 대기

waitForEvent 메서드는 자바스크립트 이벤트가 발생할 때까지 테스트 실행을 일시 중지하는 데 사용할 수 있습니다:

$browser->waitForEvent('load');

이 이벤트 리스너는 현재 스코프에 첨부되며, 기본적으로 body 요소에 첨부됩니다. 스코프가 지정된 선택자를 사용하는 경우, 이벤트 리스너는 일치하는 요소에 첨부됩니다:

$browser->with('iframe', function (Browser $iframe) {
    // Wait for the iframe's load event...
    $iframe->waitForEvent('load');
});

waitForEvent 메서드에 이벤트 리스너를 특정 요소에 붙이기 위해 두 번째 인수로 선택기를 제공할 수도 있습니다:

$browser->waitForEvent('load', '.selector');

또한 document 및 window 객체의 이벤트를 기다릴 수도 있습니다:

// Wait until the document is scrolled...
$browser->waitForEvent('scroll', 'document');

// Wait a maximum of five seconds until the window is resized...
$browser->waitForEvent('resize', 'window', 5);

콜백과 함께 대기하기

Dusk의 많은 “wait” 메서드는 기본 waitUsing 메서드에 의존합니다. 이 메서드를 직접 사용하여 주어진 클로저가 true를 반환할 때까지 대기할 수 있습니다. waitUsing 메서드는 최대 대기 시간(초), 클로저를 평가할 간격, 클로저, 선택적 실패 메시지를 받습니다:

$browser->waitUsing(10, 1, function () use ($something) {
    return $something->isReady();
}, "Something wasn't ready in time.");

요소를 뷰로 스크롤하기

때때로 브라우저의 화면 표시 영역 밖에 요소가 있어서 클릭할 수 없을 수 있습니다. scrollIntoView 메서드는 지정된 선택자에 있는 요소가 화면에 들어올 때까지 브라우저 창을 스크롤합니다:

$browser->scrollIntoView('.selector')
    ->click('.selector');

사용 가능한 어서션

Dusk는 애플리케이션에 대해 수행할 수 있는 다양한 어서션을 제공합니다. 사용 가능한 모든 어서션은 아래 목록에 문서화되어 있습니다:

assertTitle assertTitleContains assertUrlIs assertSchemeIs assertSchemeIsNot assertHostIs assertHostIsNot assertPortIs assertPortIsNot assertPathBeginsWith assertPathEndsWith assertPathContains assertPathIs assertPathIsNot assertRouteIs assertQueryStringHas assertQueryStringMissing assertFragmentIs assertFragmentBeginsWith assertFragmentIsNot assertHasCookie assertHasPlainCookie assertCookieMissing assertPlainCookieMissing assertCookieValue assertPlainCookieValue assertSee assertDontSee assertSeeIn assertDontSeeIn assertSeeAnythingIn assertSeeNothingIn assertCount assertScript assertSourceHas assertSourceMissing assertSeeLink assertDontSeeLink assertInputValue assertInputValueIsNot assertChecked assertNotChecked assertIndeterminate assertRadioSelected assertRadioNotSelected assertSelected assertNotSelected assertSelectHasOptions assertSelectMissingOptions assertSelectHasOption assertSelectMissingOption assertValue assertValueIsNot assertAttribute assertAttributeMissing assertAttributeContains assertAttributeDoesntContain assertAriaAttribute assertDataAttribute assertVisible assertPresent assertNotPresent assertMissing assertInputPresent assertInputMissing assertDialogOpened assertEnabled assertDisabled assertButtonEnabled assertButtonDisabled assertFocused assertNotFocused assertAuthenticated assertGuest assertAuthenticatedAs assertVue assertVueIsNot assertVueContains assertVueDoesntContain

assertTitle

페이지 제목이 주어진 텍스트와 일치하는지 확인합니다:

$browser->assertTitle($title);

assertTitleContains

페이지 제목에 주어진 텍스트가 포함되어 있는지 확인합니다:

$browser->assertTitleContains($title);

assertUrlIs

현재 URL(쿼리 문자열 제외)이 주어진 문자열과 일치하는지 확인합니다:

$browser->assertUrlIs($url);

assertSchemeIs

현재 URL 스킴이 주어진 스킴과 일치하는지 확인합니다:

$browser->assertSchemeIs($scheme);

assertSchemeIsNot

현재 URL 스킴이 주어진 스킴과 일치하지 않는지 확인합니다:

$browser->assertSchemeIsNot($scheme);

assertHostIs

현재 URL 호스트가 주어진 호스트와 일치하는지 확인:

$browser->assertHostIs($host);

assertHostIsNot

현재 URL 호스트가 주어진 호스트와 일치하지 않음을 확인합니다:

$browser->assertHostIsNot($host);

assertPortIs

현재 URL 포트가 주어진 포트와 일치하는지 확인:

$browser->assertPortIs($port);

assertPortIsNot

현재 URL 포트가 주어진 포트와 일치하지 않음을 확인합니다:

$browser->assertPortIsNot($port);

assertPathBeginsWith

현재 URL 경로가 주어진 경로로 시작하는지 확인합니다:

$browser->assertPathBeginsWith('/home');

assertPathEndsWith

현재 URL 경로가 주어진 경로로 끝나는지 확인합니다:

$browser->assertPathEndsWith('/home');

assertPathContains

현재 URL 경로에 지정된 경로가 포함되어 있는지 확인합니다:

$browser->assertPathContains('/home');

assertPathIs

현재 경로가 주어진 경로와 일치하는지 확인합니다:

$browser->assertPathIs('/home');

assertPathIsNot

현재 경로가 주어진 경로와 일치하지 않음을 확인합니다:

$browser->assertPathIsNot('/home');

assertRouteIs

현재 URL이 주어진 명명된 라우트의 URL과 일치하는지 확인합니다:

$browser->assertRouteIs($name, $parameters);

assertQueryStringHas

주어진 쿼리 문자열 매개변수가 존재하는지 확인하십시오:

$browser->assertQueryStringHas($name);

주어진 쿼리 문자열 매개변수가 존재하며 특정 값을 가지는지 확인합니다:

$browser->assertQueryStringHas($name, $value);

assertQueryStringMissing

주어진 쿼리 문자열 매개변수가 없는지 확인합니다:

$browser->assertQueryStringMissing($name);

assertFragmentIs

URL의 현재 해시 조각이 주어진 조각과 일치하는지 확인합니다:

$browser->assertFragmentIs('anchor');

assertFragmentBeginsWith

URL의 현재 해시 조각이 주어진 조각으로 시작하는지 확인합니다:

$browser->assertFragmentBeginsWith('anchor');

assertFragmentIsNot

URL의 현재 해시 조각이 주어진 조각과 일치하지 않음을 확인합니다:

$browser->assertFragmentIsNot('anchor');

assertHasCookie

주어진 암호화된 쿠키가 존재하는지 확인합니다:

$browser->assertHasCookie($name);

assertHasPlainCookie

주어진 비암호화 쿠키가 존재하는지 확인합니다:

$browser->assertHasPlainCookie($name);

assertCookieMissing

주어진 암호화된 쿠키가 존재하지 않음을 확인합니다:

$browser->assertCookieMissing($name);

assertPlainCookieMissing

주어진 암호화되지 않은 쿠키가 존재하지 않음을 확인합니다:

$browser->assertPlainCookieMissing($name);

assertCookieValue

암호화된 쿠키가 특정 값을 가지고 있는지 확인합니다:

$browser->assertCookieValue($name, $value);

assertPlainCookieValue

암호화되지 않은 쿠키가 특정 값을 가지고 있는지 확인합니다:

$browser->assertPlainCookieValue($name, $value);

assertSee

페이지에 주어진 텍스트가 있는지 확인하세요:

$browser->assertSee($text);

assertDontSee

주어진 텍스트가 페이지에 존재하지 않음을 확인합니다:

$browser->assertDontSee($text);

assertSeeIn

지정된 텍스트가 선택자 안에 있는지 확인합니다:

$browser->assertSeeIn($selector, $text);

assertDontSeeIn

지정된 텍스트가 선택자 내에 존재하지 않음을 확인합니다:

$browser->assertDontSeeIn($selector, $text);

assertSeeAnythingIn

선택자 내에 어떤 텍스트가 있는지 확인합니다:

$browser->assertSeeAnythingIn($selector);

assertSeeNothingIn

선택자 내에 텍스트가 존재하지 않음을 확인합니다:

$browser->assertSeeNothingIn($selector);

assertCount

주어진 선택자와 일치하는 요소가 지정된 횟수만큼 나타나는지 확인합니다:

$browser->assertCount($selector, $count);

assertScript

주어진 JavaScript 표현식이 주어진 값으로 평가되는지 확인하십시오:

$browser->assertScript('window.isLoaded')
    ->assertScript('document.readyState', 'complete');

assertSourceHas

주어진 소스 코드가 페이지에 존재하는지 확인하세요:

$browser->assertSourceHas($code);

assertSourceMissing

주어진 소스 코드가 페이지에 존재하지 않음을 확인하십시오:

$browser->assertSourceMissing($code);

assertSeeLink

주어진 링크가 페이지에 있는지 확인하세요:

$browser->assertSeeLink($linkText);

assertDontSeeLink

주어진 링크가 페이지에 존재하지 않음을 확인합니다:

$browser->assertDontSeeLink($linkText);

assertInputValue

주어진 입력 필드가 주어진 값을 가지고 있는지 확인합니다:

$browser->assertInputValue($field, $value);

assertInputValueIsNot

주어진 입력 필드가 주어진 값을 가지지 않음을 확인합니다:

$browser->assertInputValueIsNot($field, $value);

assertChecked

주어진 체크박스가 선택되어 있는지 확인하세요:

$browser->assertChecked($field);

assertNotChecked

주어진 체크박스가 선택되지 않았음을 확인하세요:

$browser->assertNotChecked($field);

assertIndeterminate

주어진 체크박스가 불확정(indeterminate) 상태에 있는지 확인하십시오:

$browser->assertIndeterminate($field);

assertRadioSelected

주어진 라디오 필드가 선택되었는지 확인합니다:

$browser->assertRadioSelected($field, $value);

assertRadioNotSelected

주어진 라디오 필드가 선택되지 않았음을 확인합니다:

$browser->assertRadioNotSelected($field, $value);

assertSelected

주어진 드롭다운에 주어진 값이 선택되어 있는지 확인합니다:

$browser->assertSelected($field, $value);

assertNotSelected

주어진 드롭다운에서 지정된 값이 선택되지 않았음을 확인합니다:

$browser->assertNotSelected($field, $value);

assertSelectHasOptions

주어진 값 배열이 선택 가능함을 확인합니다:

$browser->assertSelectHasOptions($field, $values);

assertSelectMissingOptions

주어진 값 배열이 선택할 수 없음을 확인하십시오:

$browser->assertSelectMissingOptions($field, $values);

assertSelectHasOption

주어진 값이 지정된 필드에서 선택할 수 있는지 확인합니다:

$browser->assertSelectHasOption($field, $value);

assertSelectMissingOption

주어진 값이 선택 가능한 목록에 없는지 확인합니다:

$browser->assertSelectMissingOption($field, $value);

assertValue

지정된 선택자와 일치하는 요소가 주어진 값을 가지고 있는지 확인합니다:

$browser->assertValue($selector, $value);

assertValueIsNot

주어진 선택자와 일치하는 요소가 주어진 값을 가지지 않았음을 확인합니다:

$browser->assertValueIsNot($selector, $value);

assertAttribute

주어진 선택자와 일치하는 요소가 제공된 속성에서 주어진 값을 가지고 있는지 확인합니다:

$browser->assertAttribute($selector, $attribute, $value);

assertAttributeMissing

주어진 셀렉터와 일치하는 요소가 제공된 속성을 가지고 있지 않은지 확인합니다:

$browser->assertAttributeMissing($selector, $attribute);

assertAttributeContains

주어진 선택자와 일치하는 요소가 제공된 속성에 주어진 값을 포함하고 있는지 확인합니다:

$browser->assertAttributeContains($selector, $attribute, $value);

assertAttributeDoesntContain

주어진 선택자와 일치하는 요소가 제공된 속성에서 주어진 값을 포함하지 않는지 확인합니다:

$browser->assertAttributeDoesntContain($selector, $attribute, $value);

assertAriaAttribute

주어진 선택자와 일치하는 요소가 제공된 aria 속성에서 지정된 값을 가지고 있는지 확인합니다:

$browser->assertAriaAttribute($selector, $attribute, $value);

예를 들어, 마크업 <button aria-label="Add"></button>가 주어지면 다음과 같이 aria-label 속성에 대해 주장할 수 있습니다:

$browser->assertAriaAttribute('button', 'label', 'Add');

assertDataAttribute

주어진 선택자와 일치하는 요소가 제공된 데이터 속성에 지정된 값을 가지고 있는지 확인합니다:

$browser->assertDataAttribute($selector, $attribute, $value);

예를 들어, 마크업 <tr id="row-1" data-content="attendees"></tr>가 주어지면 다음과 같이 data-content 속성에 대해 주장할 수 있습니다:

$browser->assertDataAttribute('#row-1', 'content', 'attendees');

assertVisible

주어진 선택자와 일치하는 요소가 보이는지 확인하세요:

$browser->assertVisible($selector);

assertPresent

주어진 선택자와 일치하는 요소가 소스에 존재하는지 확인하십시오:

$browser->assertPresent($selector);

assertNotPresent

주어진 선택자와 일치하는 요소가 소스에 존재하지 않는지 확인합니다:

$browser->assertNotPresent($selector);

assertMissing

주어진 선택자와 일치하는 요소가 보이지 않는지 확인합니다:

$browser->assertMissing($selector);

assertInputPresent

지정된 이름을 가진 입력이 존재하는지 확인하세요:

$browser->assertInputPresent($name);

assertInputMissing

주어진 이름의 입력이 소스에 존재하지 않음을 확인하십시오:

$browser->assertInputMissing($name);

assertDialogOpened

주어진 메시지를 가진 JavaScript 대화 상자가 열렸는지 확인합니다:

$browser->assertDialogOpened($message);

assertEnabled

주어진 필드가 활성화되어 있는지 확인합니다:

$browser->assertEnabled($field);

assertDisabled

주어진 필드가 비활성화되어 있는지 확인하세요:

$browser->assertDisabled($field);

assertButtonEnabled

주어진 버튼이 활성화되어 있는지 확인합니다:

$browser->assertButtonEnabled($button);

assertButtonDisabled

주어진 버튼이 비활성화되었는지 확인합니다:

$browser->assertButtonDisabled($button);

assertFocused

주어진 필드가 포커스되어 있는지 확인합니다:

$browser->assertFocused($field);

assertNotFocused

주어진 필드가 포커스되지 않았음을 확인합니다:

$browser->assertNotFocused($field);

assertAuthenticated

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

$browser->assertAuthenticated();

assertGuest

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

$browser->assertGuest();

assertAuthenticatedAs

사용자가 주어진 사용자로 인증되었는지 확인합니다:

$browser->assertAuthenticatedAs($user);

assertVue

Dusk는 Vue 컴포넌트 데이터의 상태에 대해 assertions를 수행할 수 있도록 해줍니다. 예를 들어, 여러분의 애플리케이션에 다음과 같은 Vue 컴포넌트가 포함되어 있다고 가정해봅시다:

// HTML…

// 컴포넌트 정의…

Vue.component(‘profile’, { template: ‘<div>{{ user.name }}</div>’,

data: function () { return { user: { name: ‘Taylor’ } }; } });

다음과 같이 Vue 컴포넌트의 상태에 대해 assertions를 할 수 있습니다:```php tab=Pest test(‘vue’, function () { $this->browse(function (Browser $browser) { $browser->visit(‘/’) ->assertVue(‘user.name’, ‘Taylor’, ‘@profile-component’); }); });

```php tab=PHPUnit
/**
 * A basic Vue test example.
 */
public function test_vue(): void
{
    $this->browse(function (Browser $browser) {
        $browser->visit('/')
            ->assertVue('user.name', 'Taylor', '@profile-component');
    });
}

assertVueIsNot

주어진 Vue 컴포넌트 데이터 속성이 주어진 값과 일치하지 않음을 확인합니다:

$browser->assertVueIsNot($property, $value, $componentSelector = null);

assertVueContains

주어진 Vue 컴포넌트 데이터 속성이 배열이며 지정된 값을 포함하고 있는지 확인합니다:

$browser->assertVueContains($property, $value, $componentSelector = null);

assertVueDoesntContain

주어진 Vue 컴포넌트 데이터 속성이 배열인지 확인하고 주어진 값을 포함하지 않는지 검증합니다:

$browser->assertVueDoesntContain($property, $value, $componentSelector = null);

페이지

때때로 테스트에서는 여러 복잡한 동작을 순차적으로 수행해야 할 때가 있습니다. 이는 테스트를 읽고 이해하기 어렵게 만들 수 있습니다. Dusk 페이지를 사용하면 단일 메서드를 통해 수행할 수 있는 표현력 있는 동작을 정의할 수 있습니다. 또한 페이지를 사용하면 애플리케이션 전체나 단일 페이지에 대해 자주 사용하는 선택자에 대한 바로 가기를 정의할 수 있습니다.

페이지 생성

페이지 객체를 생성하려면 dusk:page Artisan 명령어를 실행하십시오. 모든 페이지 객체는 애플리케이션의 tests/Browser/Pages 디렉터리에 배치됩니다.

php artisan dusk:page Login

페이지 구성하기

기본적으로, 페이지에는 세 가지 메서드가 있습니다: url, assert, 그리고 elements. 이제 url와 assert 메서드에 대해 논의하겠습니다. elements 메서드는 아래에서 더 자세히 논의됩니다.

`url` 메서드

url 메서드는 페이지를 나타내는 URL의 경로를 반환해야 합니다. Dusk는 브라우저에서 페이지로 이동할 때 이 URL을 사용합니다:

/**
 * Get the URL for the page.
 */
public function url(): string
{
    return '/login';
}

`assert` 방법

assert 방법은 브라우저가 실제로 지정된 페이지에 있는지 확인하기 위해 필요한 모든 주장을 할 수 있습니다. 실제로 이 방법 안에 아무 것도 넣을 필요는 없지만, 원한다면 이러한 주장을 자유롭게 할 수 있습니다. 이 주장들은 페이지로 이동할 때 자동으로 실행됩니다:

/**
 * Assert that the browser is on the page.
 */
public function assert(Browser $browser): void
{
    $browser->assertPathIs($this->url());
}

페이지로 이동하기

페이지가 정의되면 visit 방법을 사용하여 해당 페이지로 이동할 수 있습니다:

use Tests\Browser\Pages\Login;

$browser->visit(new Login);

때때로 당신은 이미 특정 페이지에 있을 수 있으며, 그 페이지의 셀렉터와 메서드를 현재 테스트 컨텍스트로 ‘로드’해야 할 필요가 있습니다. 이는 버튼을 누른 후 명시적으로 페이지를 이동하지 않고 특정 페이지로 리디렉션되는 경우에 일반적입니다. 이러한 상황에서는 페이지를 로드하기 위해 on 메서드를 사용할 수 있습니다:

use Tests\Browser\Pages\CreatePlaylist;

$browser->visit('/dashboard')
    ->clickLink('Create Playlist')
    ->on(new CreatePlaylist)
    ->assertSee('@create');

단축 선택자

페이지 클래스 내의 elements 메서드를 사용하면 페이지의 모든 CSS 선택자에 대해 빠르고 기억하기 쉬운 단축키를 정의할 수 있습니다. 예를 들어, 애플리케이션 로그인 페이지의 “이메일” 입력 필드에 대한 단축키를 정의해 보겠습니다:

/**
 * Get the element shortcuts for the page.
 *
 * @return array<string, string>
 */
public function elements(): array
{
    return [
        '@email' => 'input[name=email]',
    ];
}

바로가기가 정의되면 일반적으로 전체 CSS 선택자를 사용하는 곳 어디에서나 약식 선택자를 사용할 수 있습니다:

$browser->type('@email', 'taylor@laravel.com');

전역 축약 선택자

Dusk를 설치한 후, 기본 Page 클래스가 귀하의 tests/Browser/Pages 디렉토리에 배치됩니다. 이 클래스에는 siteElements 메서드가 포함되어 있으며, 이는 응용 프로그램 전체의 모든 페이지에서 사용 가능한 전역 축약 선택자를 정의하는 데 사용할 수 있습니다:

/**
 * Get the global element shortcuts for the site.
 *
 * @return array<string, string>
 */
public static function siteElements(): array
{
    return [
        '@element' => '#selector',
    ];
}

페이지 메서드

페이지에 정의된 기본 메서드 외에도, 테스트 전반에서 사용할 수 있는 추가 메서드를 정의할 수 있습니다. 예를 들어, 음악 관리 애플리케이션을 만들고 있다고 가정해 봅시다. 애플리케이션의 한 페이지에서 흔히 수행하는 작업은 재생 목록을 만드는 것일 수 있습니다. 각 테스트에서 재생 목록을 만드는 로직을 다시 작성하는 대신, 페이지 클래스에 createPlaylist 메서드를 정의할 수 있습니다:

<?php

namespace Tests\Browser\Pages;

use Laravel\Dusk\Browser;
use Laravel\Dusk\Page;

class Dashboard extends Page
{
    // Other page methods...

    /**
     * Create a new playlist.
     */
    public function createPlaylist(Browser $browser, string $name): void
    {
        $browser->type('name', $name)
            ->check('share')
            ->press('Create Playlist');
    }
}

메서드가 정의되면 해당 페이지를 사용하는 모든 테스트에서 이를 사용할 수 있습니다. 브라우저 인스턴스는 커스텀 페이지 메서드의 첫 번째 인수로 자동으로 전달됩니다:

use Tests\Browser\Pages\Dashboard;

$browser->visit(new Dashboard)
    ->createPlaylist('My Playlist')
    ->assertSee('My Playlist');

구성 요소

구성 요소는 Dusk의 “페이지 객체”와 유사하지만, 애플리케이션 전체에서 재사용되는 UI 및 기능 조각(예: 내비게이션 바나 알림 창)용으로 설계되었습니다. 따라서 구성 요소는 특정 URL에 제한되지 않습니다.

구성 요소 생성

구성 요소를 생성하려면 dusk:component Artisan 명령어를 실행하세요. 새 구성 요소는 tests/Browser/Components 디렉토리에 생성됩니다:

php artisan dusk:component DatePicker

위에서 보인 것처럼, ‘데이트 피커’는 애플리케이션의 다양한 페이지에 존재할 수 있는 컴포넌트의 예입니다. 테스트 스위트 전체에서 수십 개의 테스트에서 날짜를 선택하는 브라우저 자동화 로직을 수동으로 작성하는 것은 번거로울 수 있습니다. 대신, 우리는 데이트 피커를 나타내는 Dusk 컴포넌트를 정의하여 해당 로직을 컴포넌트 내에 캡슐화할 수 있습니다:

<?php

namespace Tests\Browser\Components;

use Laravel\Dusk\Browser;
use Laravel\Dusk\Component as BaseComponent;

class DatePicker extends BaseComponent
{
    /**
     * Get the root selector for the component.
     */
    public function selector(): string
    {
        return '.date-picker';
    }

    /**
     * Assert that the browser page contains the component.
     */
    public function assert(Browser $browser): void
    {
        $browser->assertVisible($this->selector());
    }

    /**
     * Get the element shortcuts for the component.
     *
     * @return array<string, string>
     */
    public function elements(): array
    {
        return [
            '@date-field' => 'input.datepicker-input',
            '@year-list' => 'div > div.datepicker-years',
            '@month-list' => 'div > div.datepicker-months',
            '@day-list' => 'div > div.datepicker-days',
        ];
    }

    /**
     * Select the given date.
     */
    public function selectDate(Browser $browser, int $year, int $month, int $day): void
    {
        $browser->click('@date-field')
            ->within('@year-list', function (Browser $browser) use ($year) {
                $browser->click($year);
            })
            ->within('@month-list', function (Browser $browser) use ($month) {
                $browser->click($month);
            })
            ->within('@day-list', function (Browser $browser) use ($day) {
                $browser->click($day);
            });
    }
}

컴포넌트 사용

컴포넌트를 정의한 후에는 어떤 테스트에서도 날짜 선택기에서 쉽게 날짜를 선택할 수 있습니다. 그리고 날짜 선택에 필요한 로직이 변경되면, 컴포넌트만 업데이트하면 됩니다:```php tab=Pest <?php

use Illuminate\Foundation\Testing\DatabaseMigrations; use Tests\Browser\Components\DatePicker;

pest()->use(DatabaseMigrations::class);

test(‘basic example’, function () { $this->browse(function (Browser $browser) { $browser->visit(‘/’) ->within(new DatePicker, function (Browser $browser) { $browser->selectDate(2019, 1, 30); }) ->assertSee(‘January’); }); });

```php tab=PHPUnit
<?php

namespace Tests\Browser;

use Illuminate\Foundation\Testing\DatabaseMigrations;
use Laravel\Dusk\Browser;
use Tests\Browser\Components\DatePicker;
use Tests\DuskTestCase;

class ExampleTest extends DuskTestCase
{
    /**
     * A basic component test example.
     */
    public function test_basic_example(): void
    {
        $this->browse(function (Browser $browser) {
            $browser->visit('/')
                ->within(new DatePicker, function (Browser $browser) {
                    $browser->selectDate(2019, 1, 30);
                })
                ->assertSee('January');
        });
    }
}

component 방법은 지정된 구성 요소에 범위가 있는 브라우저 인스턴스를 검색하는 데 사용할 수 있습니다:

$datePicker = $browser->component(new DatePickerComponent);

$datePicker->selectDate(2019, 1, 30);

$datePicker->assertSee('January');

지속적 통합

[!WARNING] 대부분의 Dusk 지속적 통합 구성은 Laravel 애플리케이션이 8000번 포트에서 내장 PHP 개발 서버를 사용하여 제공되기를 기대합니다. 따라서 계속하기 전에 지속적 통합 환경에 APP_URL 환경 변수 값이 http://127.0.0.1:8000로 설정되어 있는지 확인해야 합니다.

Heroku CI

Heroku CI에서 Dusk 테스트를 실행하려면, 다음 Google Chrome 빌드팩과 스크립트를 Heroku app.json 파일에 추가하십시오:

{
  "environments": {
    "test": {
      "buildpacks": [
        { "url": "heroku/php" },
        { "url": "https://github.com/heroku/heroku-buildpack-chrome-for-testing" }
      ],
      "scripts": {
        "test-setup": "cp .env.testing .env",
        "test": "nohup bash -c './vendor/laravel/dusk/bin/chromedriver-linux --port=9515 > /dev/null 2>&1 &' && nohup bash -c 'php artisan serve --no-reload > /dev/null 2>&1 &' && php artisan dusk"
      }
    }
  }
}

Travis CI

Travis CI에서 Dusk 테스트를 실행하려면 다음 .travis.yml 구성을 사용하세요. Travis CI는 그래픽 환경이 아니므로 Chrome 브라우저를 실행하기 위해 몇 가지 추가 단계를 수행해야 합니다. 또한 PHP의 내장 웹 서버를 실행하기 위해 php artisan serve을 사용할 것입니다:

language: php

php:
  - 8.2

addons:
  chrome: stable

install:
  - cp .env.testing .env
  - travis_retry composer install --no-interaction --prefer-dist
  - php artisan key:generate
  - php artisan dusk:chrome-driver

before_script:
  - google-chrome-stable --headless --disable-gpu --remote-debugging-port=9222 http://localhost &
  - php artisan serve --no-reload &

script:
  - php artisan dusk

GitHub Actions

Dusk 테스트를 실행하기 위해 GitHub Actions를 사용하는 경우, 다음 구성 파일을 시작점으로 사용할 수 있습니다. TravisCI와 마찬가지로, PHP 내장 웹 서버를 시작하기 위해 php artisan serve 명령어를 사용할 것입니다:

name: CI
on: [push]
jobs:

  dusk-php:
    runs-on: ubuntu-latest
    env:
      APP_URL: "http://127.0.0.1:8000"
      DB_USERNAME: root
      DB_PASSWORD: root
      MAIL_MAILER: log
    steps:
      - uses: actions/checkout@v5
      - name: Prepare The Environment
        run: cp .env.example .env
      - name: Create Database
        run: |
          sudo systemctl start mysql
          mysql --user="root" --password="root" -e "CREATE DATABASE \`my-database\` character set UTF8mb4 collate utf8mb4_bin;"
      - name: Install Composer Dependencies
        run: composer install --no-progress --prefer-dist --optimize-autoloader
      - name: Generate Application Key
        run: php artisan key:generate
      - name: Upgrade Chrome Driver
        run: php artisan dusk:chrome-driver --detect
      - name: Start Chrome Driver
        run: ./vendor/laravel/dusk/bin/chromedriver-linux --port=9515 &
      - name: Run Laravel Server
        run: php artisan serve --no-reload &
      - name: Run Dusk Tests
        run: php artisan dusk
      - name: Upload Screenshots
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: screenshots
          path: tests/Browser/screenshots
      - name: Upload Console Logs
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: console
          path: tests/Browser/console

Chipper CI

Dusk 테스트를 실행하기 위해 Chipper CI를 사용하고 있다면, 다음 구성 파일을 시작점으로 사용할 수 있습니다. 요청을 수신할 수 있도록 PHP의 내장 서버를 사용하여 Laravel을 실행할 것입니다:

# file .chipperci.yml
version: 1

environment:
  php: 8.2
  node: 16

# Include Chrome in the build environment
services:
  - dusk

# Build all commits
on:
   push:
      branches: .*

pipeline:
  - name: Setup
    cmd: |
      cp -v .env.example .env
      composer install --no-interaction --prefer-dist --optimize-autoloader
      php artisan key:generate

      # Create a dusk env file, ensuring APP_URL uses BUILD_HOST
      cp -v .env .env.dusk.ci
      sed -i "s@APP_URL=.*@APP_URL=http://$BUILD_HOST:8000@g" .env.dusk.ci

  - name: Compile Assets
    cmd: |
      npm ci --no-audit
      npm run build

  - name: Browser Tests
    cmd: |
      php -S [::0]:8000 -t public 2>server.log &
      sleep 2
      php artisan dusk:chrome-driver $CHROME_DRIVER
      php artisan dusk --env=ci

데이터베이스 사용 방법을 포함하여 Chipper CI에서 Dusk 테스트를 실행하는 방법에 대해 자세히 알아보려면 공식 Chipper CI 문서를 참조하세요.

서브목차