Download laravel tag assertions - download de código-fonte laravel tag assertions

laravel tag assertions

Pitão

v2.0.2

Baixar

Asserções de tags Laravel

O Laravel vem com uma série de recursos incríveis, mas um dos meus favoritos é como ele facilita o teste do seu aplicativo.

Laravel Tag Assertions tem como objetivo tornar a incrível funcionalidade de testes HTTP que o Laravel oferece ainda mais poderosa, adicionando asserções úteis para tags HTML.

Motivações

Freqüentemente, eu queria afirmar que uma resposta contém certos elementos (ou seja: componente Vue com determinados adereços), mas não queria que novas linhas e outros espaços em branco fossem importantes. Usar métodos como $response->assertSee(...) não é ideal para este caso de uso específico. Laravel Dusk também não era uma opção desejável porque pode ser lento e às vezes frágil.

Instalação

 composer require --dev mikerogne/laravel-tag-assertions

Depois de instaladas, suas instâncias TestResponse agora terão acesso a novas asserções. Veja abaixo uso e exemplos.

Uso

TestResponse::assertSeeTag(string $seletor, array $atributos)

$selector é o nome de uma tag que você deseja corresponder. Você pode ser tão específico quanto desejar. $attributes é uma matriz de atributos que a tag deve ter.

Simples	Mais específico
botão	botão.btn.btn-default
um	uma[função=guia]

TestResponse::assertSeeTag(string $seletor, $callback)

Se você especificar um retorno de chamada, três parâmetros serão passados para ele:

$tag : Este é o nome da própria tag, ou seja: button ou a .
$attributes : Este é um array de atributos para a tag, ou seja: ["class" => "btn btn-default"] .
$content : Esta é uma string que representa o conteúdo (innerHtml). Espaço em branco está incluído.

TestResponse::assertSeeTagContent(string $seletor, string $conteúdo)

Às vezes só nos importamos que uma tag com conteúdo específico esteja na página. Um caso de uso comum para isso é um campo textarea.

 $response->assertSeeTagContent('textarea[name=about]', $user->about);

Exemplos

Validação de formulário

 < body >
    < h1 > Contrived Example  h1 >
    
    < form >
        < p >
            < label > First Name  label >
            < input type =" text " name =" first_name " value =" {{ old('first_name') }} " >
         p >
        < p >
            < label > Last Name  label >
            < input type =" text " name =" last_name " value =" {{ old('last_name') }} " >
         p >
        < p >
            < label > Email  label >
            < input type =" text " name =" email " value =" {{ old('email') }} " >
         p >
        < p >
            < button type =" submit " > Register  button >
         p >
     form >
 body >

 

namespace Tests  Feature ;

class ExampleTest extends TestCase
{
    / * * @ test * /
    public function uses_old_input_when_validation_fails ()
    {
        $ data = [
            ' first_name ' => ' John ' ,
            ' last_name ' => ' Doe ' ,
            ' email ' => '' , // oops !
        ];
        
        $ response = $ this -> post ( ' /register ' , $ data );
        
        $ response -> assertSeeTag ( ' input[name=first_name] ' , [
            ' value ' => $ data [ ' first_name ' ],
        ]);
        
        $ response -> assertSeeTag ( ' input[name=last_name] ' , [
            ' value ' => $ data [ ' last_name ' ],
        ]);
    }
}

Componente Vue

 < body >
    < h1 > Another Contrived Example  h1 >
    
    < blog-posts
        :posts =" {{ $posts->toJson() }} "
    >  blog-posts >
 body >

 

namespace Tests  Feature ;

class VueTest extends TestCase
{
    / * * @ test * /
    public function lists_blog_posts ()
    {
        $ posts = factory ( App Post::class, 5 )-> create ();
        
        $ response = $ this -> get ( ' / ' , $ data );
        
        $ response -> assertSeeTagContent ( ' h1 ' , ' Another Contrived Example ' );
        
        $ response -> assertSeeTag ( ' blog-posts ' , [
            ' :posts ' => e ( $ posts -> toJson ()),
        ]);
    }
}

Exemplo de retorno de chamada

 < body >
    < h1 > Callback Example  h1 >

    
    < h2 class =" section-title " data-foobar =" bazburk " >
        Product Review
     h2 >
    < p class =" summary " > Lorem ipsum dolor sit amet, consectetur adipiscing elit.  p >
    
 body >

 

namespace Tests  Feature ;

class CallbackTest extends TestCase
{
    / * * @ test * /
    public function shows_product_review ()
    {
        $ response = $ this -> get ( ' / ' , $ data );
        
        $ response -> assertSeeTag ( ' h2 ' , function ( $ tag , $ attributes , $ content ) {
            // $ tag - > "h2"
            // $ attributes - > [ 'class' = > 'section-title' , 'data-foobar' = > 'bazburk' ]
            // $ content - > Product Review ( but including the whitespace !)
            
            return  Illuminate  Support Str:: contains ( $ content , ' Product Review ' );
        });
        
        $ response -> assertSeeTagContent ( ' p.summary ' , ' Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' );
    }
}