Browser testing with Dusk in Laravel - Step-by-Step Execution

Concept Flow - Browser testing with Dusk

Start Test

↓

Launch Browser

↓

Navigate to URL

↓

Perform Actions

↓

Check Assertions

↓

Close Browser

↓

End Test

This flow shows how a Dusk test starts by opening a browser, navigating, performing actions, checking results, and then closing the browser.

Execution Sample

Laravel

public function testLogin()
{
    $this->browse(function (Browser $browser) {
        $browser->visit('/login')
                ->type('email', '[e-mail]')
                ->type('password', 'secret')
                ->press('Login')
                ->assertPathIs('/home');
    });
}

This test opens the login page, fills in email and password, clicks login, and checks if redirected to home.

Execution Table

Step	Action	Browser State	Result	Notes
1	Launch browser	Browser opened, blank page	Success	Browser window opens ready for commands
2	Visit '/login'	Page loads login form	Success	Login page is displayed
3	Type 'email' field	Email input filled with '[e-mail]'	Success	Email typed into form
4	Type 'password' field	Password input filled with 'secret'	Success	Password typed into form
5	Press 'Login' button	Form submitted	Success	Login form submitted
6	Assert path is '/home'	Current URL is '/home'	Pass	User redirected to home page
7	Close browser	Browser closed	Success	Test ends, browser closes

💡 Test ends after browser closes following successful assertion or failure

Variable Tracker

Variable	Start	After Step 3	After Step 4	After Step 5	Final
email input	empty	[e-mail]	[e-mail]	[e-mail]	[e-mail]
password input	empty	empty	secret	secret	secret
current URL	about:blank	/login	/login	/home	/home
browser state	closed	open	open	open	closed

Key Moments - 3 Insights

Why does the test fail if the assertion 'assertPathIs' does not match?

Because the test expects the browser URL to be '/home' after login. If it is different, the assertion fails, stopping the test as shown in step 6 of the execution_table.

What happens if the 'press' method is called before filling the inputs?

The form submits empty fields, likely causing a failed login and assertion failure at step 6, as the URL won't change to '/home'.

Does the browser stay open after the test finishes?

No, the browser closes at the last step (step 7), ensuring no leftover browser windows remain after tests.

Visual Quiz - 3 Questions

Look at the execution_table, what is the browser state after step 4?

A Browser open with email and password typed

B Browser closed

C Browser open but no inputs typed

D Browser crashed

💡 Hint

Check the 'Browser State' column at step 4 in the execution_table

At which step does the test check if the user is redirected to '/home'?

A Step 5

B Step 6

C Step 3

D Step 7

💡 Hint

Look for the 'Assert path is' action in the execution_table

If the 'type' method for password is skipped, what likely happens?

A Test passes normally

B Browser closes early

C Test fails at assertion step

D Login button is disabled

💡 Hint

Refer to key_moments about missing input causing assertion failure

Concept Snapshot

Browser testing with Dusk:
- Use $this->browse() with a closure
- Chain browser actions: visit(), type(), press()
- Use assertions like assertPathIs() to check results
- Browser opens, runs commands, then closes
- Tests simulate real user actions in a browser

Full Transcript

Browser testing with Laravel Dusk involves opening a browser window, navigating to a web page, performing user actions like typing and clicking, then checking if the expected page or element appears. The test starts by launching the browser, visiting the login page, typing the email and password, pressing the login button, and asserting the URL changes to '/home'. If the assertion passes, the browser closes and the test ends successfully. If any step fails, the test stops and reports failure. Variables like input fields and current URL change as the test runs. This process helps ensure the website works correctly from a user's perspective.