Laravel Husk
Larvel Husk is a thin and light scaffolded Laravel Dusk environment.
It allows you to test your JavaScript applications with PHP using Pest, without having to scaffold an entire Laravel application.
Examples
| JS Framework | Tests |
|---|---|
| NuxtJS |  |
| NextJS |  |
| Svelte |  |
| Gatsby |  |
| Gridsome |  |
| Showcode (NuxtJS) |  |
Installation
Inside of your JavaScript application folder, run the below command to scaffold the Laravel Husk environment:
Note: This will create the folder named
browserwhich will contain your Laravel Husk test environment.
composer create-project stevebauman/laravel-husk browser
After scaffolding the test environment, you should have the below folder structure;
javascript-app/
├── ...
└── browser/
├── bootstrap/
├── config/
├── storage/
│ ├── log/
│ ├── screenshots/
│ └── source/
└── tests/
├── ...
├── ExampleTest.php
├── DuskTestCase.php
└── Pages/
└── ExamplePage.php
Then, navigate into the browser directory and install the Chrome driver by running the below command:
php application dusk:chrome-driver
Usage
Before running your dusk tests, be sure to set the proper base URL to where your JavaScript application will be served from:
// tests/DuskTestCase.php
protected function setUp(): void
{
parent::setUp();
$this->setupBrowser('http://localhost:3000');
}
After setting the base URL, serve your JavaScript application:
npm run dev
Then, inside of another terminal, navigate into the browser directory:
cd browser
And run the below command:
Important: Make sure you've installed the Chrome driver first, via
php application dusk:chrome-driver
php application pest:dusk
GitHub Actions
You may use the below GitHub action as a template to run your Laravel Dusk tests:
name: run-tests
on:
push:
pull_request:
schedule:
- cron: "0 0 * * *"
jobs:
run-tests:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-node@v2
with:
cache: "npm"
- name: Install Javascript Dependencies
run: npm install
- name: Start JavaScript Application
run: npm run dev &
- name: Install Composer Dependencies
working-directory: ./browser
run: composer install --no-progress --prefer-dist --optimize-autoloader
- name: Upgrade Chrome Driver
working-directory: ./browser
run: php application dusk:chrome-driver `/opt/google/chrome/chrome --version | cut -d " " -f3 | cut -d "." -f1`
- name: Run Dusk Tests
working-directory: ./browser
run: php application pest:dusk
- name: Upload Screenshots
if: failure()
uses: actions/upload-artifact@v2
with:
name: screenshots
path: browser/storage/screenshots
- name: Upload Console Logs
if: failure()
uses: actions/upload-artifact@v2
with:
name: console
path: browser/storage/console
19 Aug 29, 2022
35 Dec 19, 2022
228 Nov 11, 2022
1.7k Dec 28, 2022
3 Apr 14, 2021
15 Oct 6, 2022
3 Jul 27, 2022
6.8k Dec 26, 2022
6 Dec 30, 2022
23 Sep 29, 2022
49 Jun 22, 2022
6 Dec 17, 2022
152 Dec 15, 2022
2k Dec 20, 2022
18 Nov 29, 2022
79 Dec 29, 2022
6.9k Jan 2, 2023