assertNotChecked

Bestätigen, dass das angegebene Kontrollkästchen nicht aktiviert ist:

$browser->assertNotChecked($field);

assertRadioSelected

Stellen Sie sicher, dass das angegebene Optionsfeld ausgewählt ist:

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

assertRadioNotSelected

Stellen Sie sicher, dass das angegebene Optionsfeld nicht ausgewählt ist:

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

asse rtSelected

Bestätigt, dass das Dropdown-Feld mit dem angegebenen Wert ausgewählt ist:

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

assertNotSelected

Stellen Sie sicher, dass das Dropdown-Feld den angegebenen Wert nicht auswählt:

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

assertSelectHasOptions

Assert optional zu Geben Sie die Werte im Array an:

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

assertSelectMis singOptions

Bestätigt, dass der ausgewählte Wert kein Wert im angegebenen Array ist:

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

assertSelectHasOption

Setzen Sie diesen optionalen Wert auf den angegebenen Wert:

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

assertValue

Aktiviert Elemente innerhalb des Selektorbereichs Der angegebene Wert existiert:

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

assertVisible

Stellen Sie sicher, dass Elemente innerhalb des Auswahlbereichs sichtbar sind:

$browser->assertVisible($selector);

assert Present

bestätigt, dass das Element innerhalb des Selektorbereichs existiert:

$browser->assertPresent($selector);

assertMissing

Stellen Sie sicher, dass das Element innerhalb des Selektorbereichs nicht existiert:

$browser->assertMissing($selector);

assertDialogOpened

Assert, das die angegebene Nachricht enthält JavaScript Das Dialogfeld wurde geöffnet:

$browser->assertDialogOpened($message);

assertEnabled

Bestätigen Sie, dass das angegebene Feld aktiviert ist:

$browser->assertEnabled($field);

assertDisabled

Bestätigt, dass das angegebene Feld deaktiviert ist:

$browser->assertDisabled($field);

assertFocused

Bestätigt, dass der Fokus auf dem angegebenen Feld liegt:

$browser->assertFocused($field);

asser tNotFocused

gibt an, dass der Fokus nicht auf dem angegebenen Feld liegt:

$browser->assertNotFocused($field);

assertVue

behaupten Die Eigenschaften der Vue-Komponentendaten stimmen mit dem angegebenen Wert überein:

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

assertVueIsNot

Stellen Sie sicher, dass die Eigenschaften der Vue-Komponentendaten nicht mit dem angegebenen Wert übereinstimmen:

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

assertVueContains

Assert Vue Die Eigenschaft der Komponentendaten ist ein Array, und das Array enthält den angegebenen Wert:

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

assertVueDoesNotContain

Behaupten Sie Vue Die Eigenschaft von Komponentendaten ist ein Array, und das Array enthält nicht den angegebenen Wert:

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

Seite

hat Manchmal muss eine komplexe Reihe von Aktionen getestet werden, was das Lesen und Verstehen des Testcodes erschweren kann. Semantische Aktionen können über die Seite definiert werden und dann kann eine einzelne Methode auf der angegebenen Seite verwendet werden. Seiten können auch Verknüpfungen zu universellen Selektoren für Anwendungen oder einzelne Seiten definieren.

Seite generieren

dusk:page Der Artisan-Befehl kann Seitenobjekte generieren. Alle Seitenobjekte befinden sich im Verzeichnis tests/Browser/Pages:

php artisan dusk:page Login

Konfigurationsseite

Die Seite verfügt über 3 Methoden Standardmäßig: url, assert und elements. Hier beschreiben wir zunächst die Methoden url und assert. Die Methode elements wird in der Abkürzung Selektor detailliert beschrieben.

url Methoden Die Methode

url sollte einen Pfad zurückgeben, der die URL der Seite darstellt. Dusk verwendet diese URL im Browser, um zu der spezifischen Seite zu navigieren:

/**
 * 获得页面 URL 路径。
 *
 * @return string
 */
 public function url(){   
  return '/login';
 }

assert-Methode Die

assert-Methode kann jede Behauptung zur Überprüfung aufstellen Durchsuchen Sie, ob sich der Browser auf der angegebenen Seite befindet. Diese Methode ist nicht erforderlich. Sie können diese Aussagen basierend auf Ihren eigenen Bedürfnissen treffen. Diese Behauptungen werden automatisch ausgeführt, wenn Sie zu dieser Seite navigieren:

/**
 * 断言浏览器当前处于指定页面。
 *
 * @return void
 */
 public function assert(Browser $browser){ 
    $browser->assertPathIs($this->url());
   }

Navigiere zur Seite

Sobald die Seite danach geöffnet ist Konfiguration können Sie visit verwenden Methode zum Navigieren zur Seite:

use Tests\Browser\Pages\Login;$browser->visit(new Login);

Manchmal befinden Sie sich möglicherweise bereits auf der angegebenen Seite und müssen lediglich den Selektor und die Methode der aktuellen Seite in den aktuellen Test „laden“. Gängige Beispiele sind: Wenn Sie eine Schaltfläche drücken, werden Sie zur angegebenen Seite weitergeleitet, anstatt direkt zur angegebenen Seite zu navigieren. In diesem Fall müssen Sie die Methode on verwenden, um die Seite zu laden:

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

Selector Shorthand

elements können Sie eine einfache und leicht zu merkende Kurzschrift für jeden CSS-Selektor auf der Seite definieren. Definieren wir beispielsweise eine Abkürzung für das Eingabefeld email auf der Anmeldeseite der App:

/**
 * 获取页面的元素简写。
 *
 * @return array
 */
 public function elements(){ 
    return [  
          '@email' => 'input[name=email]',   
         ];
       }

Jetzt können Sie diese Abkürzung anstelle des vollständigen CSS-Selektors verwenden, den Sie zuvor auf der Seite verwendet haben:

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

Abkürzung für globale Selektoren

Nach der Installation von Dusk, Page Basisklassen werden in Ihrem Verzeichnis tests/Browser/Pages gespeichert. Diese Klasse enthält ein siteElements Methode: Mit dieser Methode können globale Selektorabkürzungen definiert werden, sodass jede Seite in Ihrer Anwendung diese globalen Selektorabkürzungen verwenden kann:

/**
 * 获取站点全局的选择器简写。
 *
 * @return array
 */
 public static function siteElements(){
     return [    
         '@element' => '#selector',   
          ];
        }

Seitenmethoden

Zusätzlich zu den bereits auf der Seite definierten Standardmethoden können Sie auch andere Methoden definieren, die während des gesamten Testprozesses verwendet werden. Angenommen, wir entwickeln eine Musikverwaltungsanwendung. In der Anwendung benötigen wir möglicherweise eine öffentliche Methode zum Erstellen einer Liste, anstatt die Logik zum Erstellen einer Wiedergabeliste auf jeder Seite und in jeder Testklasse neu zu schreiben createPlaylist-Methode in Ihrer Seitenklasse: Nachdem die

<?php
    namespace Tests\Browser\Pages;
    use Laravel\Dusk\Browser;
    class Dashboard extends Page{  
      // 其他页面方法...  
      /**
     * 创建一个新的播放列表。
     *
     * @param  \Laravel\Dusk\Browser  $browser
     * @param  string  $name
     * @return void
     */  
      public function createPlaylist(Browser $browser, $name) 
         {     
            $browser->type('name', $name)            
                ->check('share')                
                ->press('Create Playlist');   
           }
       }

-Methode definiert wurde, können Sie diese Methode in jedem Test verwenden, der die Seite verwendet. Die Browserinstanz übergibt automatisch die Seitenmethode:

use Tests\Browser\Pages\Dashboard;$browser->visit(new Dashboard)    
    ->createPlaylist('My Playlist')        
    ->assertSee('My Playlist');

Komponente

Die Komponente ähnelt dem „Page Object“ von Dusk „“, aber es handelt sich eher um eine Benutzeroberfläche und ein Funktionsfragment, das häufig in der gesamten Anwendung wiederverwendet wird, z. B. in einer Navigationsleiste oder einem Popup-Fenster für Informationsbenachrichtigungen. Daher ist die Komponente nicht an eine explizite URL gebunden.

Generierung von Komponenten

Um eine Komponente zu generieren, verwenden Sie den Artisan-Befehl dusk:component, um die Komponente zu generieren. Die neu generierte Komponente befindet sich im Verzeichnis test/Browser/Components:

php artisan dusk:component DatePicker

Wie oben gezeigt, ist dies ein Beispiel für die Generierung einer „Datumsauswahl“-Komponente, die in Ihrer gesamten Anwendung auf vielen Seiten verwendet werden kann. Das manuelle Schreiben einer Browser-Automatisierungslogik für die Datumsauswahl für eine große Anzahl von Testseiten in einer Testsuite wäre umständlich. Eine bequemere Alternative besteht darin, eine Abenddämmerung zu definieren, die eine Datumsauswahl darstellt Komponente und kapseln Sie dann die Automatisierungslogik in der Komponente:

<?php
    namespace Tests\Browser\Components;
    use Laravel\Dusk\Browser;
    use Laravel\Dusk\Component as BaseComponent;
    class DatePicker extends BaseComponent{   
     /**
     * 获取组件的 root selector
     *
     * @return string
     */   
      public function selector()   
       {     
          return '.date-picker';   
        }   
    /**
     * 浏览器包含组件的断言
     *
     * @param  Browser  $browser
     * @return void
     */   
      public function assert(Browser $browser)  
        {      
          $browser->assertVisible($this->selector());  
         }    
    /**
     * 读取组件的元素快捷方式
     *
     * @return array
     */   
      public function elements()   
       {    
           return [        
               '@date-field' => 'input.datepicker-input',       
               '@month-list' => 'div > div.datepicker-months',            
               '@day-list' => 'div > div.datepicker-days',      
         ];   
      }   
     /**
     * 选择给定日期
     *
     * @param  \Laravel\Dusk\Browser  $browser
     * @param  int  $month
     * @param  int  $day
     * @return void
     */  
      public function selectDate($browser, $month, $day)  
        {    
            $browser->click('@date-field')             
               ->within('@month-list', function ($browser) use ($month) {       
                            $browser->click($month);         
                                })                
                 ->within('@day-list', function ($browser) use ($day) {       
                              $browser->click($day);           
                                   });   
          }
       }

Verwendung der Komponente

Einmal die Komponente Sobald die Definition abgeschlossen ist, können Sie auf jeder Testseite ganz einfach ein Datum in der Datumsauswahl auswählen. Und wenn Sie die Logik des ausgewählten Datums ändern müssen, ändern Sie einfach diese Komponente:

<?php
    namespace Tests\Browser;
    use Tests\DuskTestCase;
    use Laravel\Dusk\Browser;
    use Tests\Browser\Components\DatePicker;
    use Illuminate\Foundation\Testing\DatabaseMigrations;
    class ExampleTest extends DuskTestCase{  
      /**
     * 基本的组件测试示例
     *
     * @return void
     */   
      public function testBasicExample() 
         {    
             $this->browse(function (Browser $browser) {       
                  $browser->visit('/')                
                      ->within(new DatePicker, function ($browser) {                   
                           $browser->selectDate(1, 2018);               
                               })                   
                      ->assertSee('January');     
                       });   
            }
      }

Kontinuierliche Integration

CircleCI

Wenn Sie CircleCI zum Ausführen von Dusk-Tests verwenden, können Sie diese Konfigurationsdatei als Ausgangspunkt verwenden. Wie bei TravisCI starten wir den in PHP integrierten Webserver mit dem Befehl php artisan serve:

version: 2jobs:
    build:
        steps:            
            - run: sudo apt-get install -y libsqlite3-dev            
            - run: cp .env.testing .env            
            - run: composer install -n --ignore-platform-reqs            
            - run: npm install            
            - run: npm run production            
            - run: vendor/bin/phpunit            
            - run:
                name: Start Chrome Driver
                command: ./vendor/laravel/dusk/bin/chromedriver-linux
                background: true            
           - run:
                name: Run Laravel Server
                command: php artisan serve
                background: true            
           - run:
                name: Run Laravel Dusk Tests
                command: php artisan dusk

Codeship

Running Dusk im Codeship Zum Testen müssen Sie die folgenden Befehle zu Ihrem Codeship-Projekt hinzufügen. Natürlich sind diese Befehle nur Beispiele, Sie können bei Bedarf gerne weitere Befehle hinzufügen:

phpenv local 7.2
cp .env.testing .env
mkdir -p ./bootstrap/cache
composer install --no-interaction --prefer-dist
php artisan key:generate
nohup bash -c "php artisan serve 2>&1 &" && sleep 5
php artisan dusk

Heroku CI

Wenn Sie Dusk-Tests in Heroku CI ausführen, ändern Sie bitte Folgendes: Google Chrome Fügen Sie das Buildpack und das Skript zu Ihrer Heroku app.json-Datei hinzu:

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

Travis CI

in < Beim Ausführen Dämmerungstests in 🎜>Travis CI, auf die Sie sich beziehen können Konfiguration. Da es sich bei Travis CI nicht um eine grafische Umgebung handelt, müssen wir einige zusätzliche Schritte ausführen, um den Chrome-Browser zu starten. Darüber hinaus verwenden wir .travis.yml, um den in PHP integrierten Webserver zu starten: php artisan serve

language: php
php: 
 - 7.3
addons:
  chrome: stable
install:
  - cp .env.testing .env  
  - travis_retry composer install--no-interaction --prefer-dist --no-suggest  
  - php artisan key:generate
before_script:  
   - google-chrome-stable --headless --disable-gpu --remote-debugging-port=9222 http://localhost &  
   - php artisan serve &
 script:
   - php artisan dusk

den Wert von .env.testing an: APP_URL

APP_URL=http://127.0.0.1:8000