<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Daki de dentro on Medium]]></title>
        <description><![CDATA[Stories by Daki de dentro on Medium]]></description>
        <link>https://medium.com/@dakidedentro?source=rss-98a77cd9d068------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*I5M_OYRZQrcQ2XdVI1IB_Q.png</url>
            <title>Stories by Daki de dentro on Medium</title>
            <link>https://medium.com/@dakidedentro?source=rss-98a77cd9d068------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 01:04:40 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@dakidedentro/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Como testar a adição interna de eventos do BLoC]]></title>
            <link>https://dakidedentro.medium.com/como-testar-a-adi%C3%A7%C3%A3o-interna-de-eventos-do-bloc-49da8a01b86c?source=rss-98a77cd9d068------2</link>
            <guid isPermaLink="false">https://medium.com/p/49da8a01b86c</guid>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[daki]]></category>
            <category><![CDATA[bloc]]></category>
            <category><![CDATA[unit-testing]]></category>
            <dc:creator><![CDATA[Daki de dentro]]></dc:creator>
            <pubDate>Wed, 01 Nov 2023 12:07:05 GMT</pubDate>
            <atom:updated>2023-11-01T12:07:05.817Z</atom:updated>
            <content:encoded><![CDATA[<h3>O problema</h3><p>Dentre os mais usados <a href="https://docs.flutter.dev/development/data-and-backend/state-mgmt/intro">gerenciadores de estado</a> está o <a href="https://pub.dev/packages/flutter_bloc">BLoC</a> (<em>Business Logic of Components</em>) que resumidamente consiste na dinâmica de receber eventos e emitir estados em <em>streams</em>. Nesse texto, vamos abordar testes unitários de uma situação específica da utilização do BLoC e no decorrer da explicação vamos assumir o conhecimento básico do uso desta ferramenta (se você ainda não conhece o que é BLoC, talvez essa <a href="https://pub.dev/packages/flutter_bloc">documentação</a> te ajude).</p><p>Dentro da sua classe BLoC de uma das páginas da aplicação de tamanho médio (ou maior), você pode ter se deparado com a situação de ter três fluxos diferentes:</p><ol><li>o primeiro deles faz o carregamento de parte da tela (dado do tipo A);</li><li>o segundo faz o carregamento da outra parte da tela (dado do tipo B); e</li><li>o terceiro deve carregar a tela por inteira (dados do tipo A e B).</li></ol><p>Em cenários desse tipo, para melhor aproveitamento de código sem repetição, é comum você aproveitar os fluxos do evento 1 e 2 para montar o fluxo 3. Algo como:</p><pre>FutureOr&lt;void&gt; _onLoadA(LoadAEvent event, Emitter&lt;State&gt; emit) { <br>  //...<br>}<br><br>FutureOr&lt;void&gt; _onLoadB(LoadBEvent event, Emitter&lt;State&gt; emit) { <br>  //...<br>}<br><br>FutureOr&lt;void&gt; _onLoadEverything(<br>  LoadEverythingEvent event, <br>  Emitter&lt;State&gt; emit,<br>) {<br> add(LoadAEvent());<br> add(LoadBEvent());<br>}</pre><p>Para testar o consumo de cada evento desse BLoC teríamos que conferir se cada estado é emitido usando o blocTest desse jeito:</p><pre>blocTest(<br>  &quot;when LoadAEvent is added, &quot;<br>  &quot;then expect loaded states&quot;,<br>  build: build,<br>  act: (bloc) =&gt; bloc.add(LoadAEvent()),<br>  expect: () =&gt; [<br>    //state 0 emitted after add LoadAEvent<br>    //state 1 emitted after add LoadAEvent<br>    //state 2 emitted after add LoadAEvent<br>  ],<br>);<br><br>blocTest(<br>  &quot;when LoadBEvent is added, &quot;<br>  &quot;then expect loaded states&quot;,<br>  build: build,<br>  act: (bloc) =&gt; bloc.add(LoadBEvent()),<br>  expect: () =&gt; [<br>    //state 0 emitted after add LoadBEvent<br>    //state 1 emitted after add LoadBEvent<br>    //state 2 emitted after add LoadBEvent<br>  ],<br>);<br><br>blocTest(<br>  &quot;when LoadEverythingEvent is added, &quot;<br>  &quot;then expect loaded states&quot;,<br>  build: build,<br>  act: (bloc) =&gt; bloc.add(LoadEverythingEvent()),<br>  expect: () =&gt; [<br>    //state 0 emitted after add LoadAEvent<br>    //state 1 emitted after add LoadAEvent<br>    //state 2 emitted after add LoadAEvent<br>    //state 0 emitted after add LoadBEvent<br>    //state 1 emitted after add LoadBEvent<br>    //state 2 emitted after add LoadBEvent<br>  ],<br>);</pre><p>Portanto, ao testar o LoadEverythingEvent, é necessário passar ao expect todos os estados que são emitidos pelo LoadAEvent e LoadBEvent. Então, se cada um emite 3 estados, a lista expect do LoadEverythingEvent tem que conter 6 estados (caso não haja uma intersecção entre os estados).</p><p>Então nessa abordagem mais “tradicional”, temos as seguintes desvantagens:</p><ul><li>o teste do LoadEverythingEvent fica bem verboso para listar todos os estados emitidos um a um;</li><li>se o LoadBEvent passar a emitir de forma diferente os estados, por exemplo, o teste do LoadEverythingEvent também deve ser alterado (efeitos da replicação de código);</li><li>o consumo dos eventos adicionados um depois do outro desse jeito acontece concorrentemente, e por isso, não há garantia que os estados emitidos pelo LoadAEvent virão antes do LoadBEvent. Portanto, isso dificulta um pouco prever qual a ordem que os estados devem ser colocados no expect do teste do LoadEverythingEvent;</li></ul><h3>Uma solução</h3><p>Seria ótimo se no teste do LoadEverythingEvent pudéssemos apenas usar o verify para conferir se a adição desse evento resultou na adição de mais dois eventos. Algo assim:</p><pre>blocTest(<br>  &quot;when LoadEverythingEvent is added, &quot;<br>  &quot;then verify addition of LoadAEvent and LoadBEvent&quot;,<br>  build: build,<br>  act: (bloc) =&gt; bloc.add(LoadEverythingEvent()),<br>  verify: (bloc) {<br>    verify(<br>      () =&gt; bloc.add(LoadAEvent()),<br>    ).called(1);<br>  verify(<br>      () =&gt; bloc.add(LoadBEvent()),<br>    ).called(1);<br>  },<br>);</pre><p>Porém, o BLoC é o nosso objeto de teste e por isso, não é um objeto mockado que podemos usar as funções de when ou verify.</p><p>E se pudéssemos receber a informação em algum lugar de que um determinado evento foi adicionado ao BLoC? Algo como um listener ou callback, comum em tantos outros casos?</p><h3>BlocObserver</h3><p>Dando uma olhada na implementação da classe Bloc, podemos ver que logo abaixo da declaração do construtor temos uma propriedade estática chamada observer do tipo BlocObserver:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zSRVEWYtRAKKqFku4Gq6LQ.png" /></figure><p>E dando uma olhada na classe BlocObserver contém exatamente o que precisamos: é uma classe abstrata que tem métodos que são chamados a cada momento diferente de todos os BLoCs da aplicação, incluindo, o método onEvent (chamado a cada vez que algum evento é adicionado à algum BLoC). Portanto, é uma ferramenta muito poderosa para logs, debugs e que pode ser utilizada para resolver problemas como esse que estamos lidando nos testes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pReXU_D35XT6nW1fpZq_6w.png" /></figure><p>A maneira mais fácil de utilizar o BlocObserver a nosso favor seria criando uma classe mock, instanciar e utilizar o verify:</p><pre>class _MockBlocObserver extends Mock implements BlocObserver {}<br><br>final blocObserver = _MockBlocObserver();<br>Bloc.observer = blocObserver;<br><br>//...<br><br>blocTest(<br>  &quot;when LoadEverythingEvent is added, &quot;<br>  &quot;then verify addition of LoadAEvent and LoadBEvent&quot;,<br>  build: build,<br>  act: (bloc) =&gt; bloc.add(LoadEverythingEvent()),<br>  verify: (bloc) {<br>    verify(<br>      () =&gt; blocObserver.onEvent(bloc, LoadAEvent()),<br>    ).called(1);<br>  verify(<br>      () =&gt; blocObserver.onEvent(bloc, LoadBEvent()),<br>    ).called(1);<br>  },<br>);</pre><p>Uma abordagem bem rápida, porém, os métodos abstratos do BlocObserver são anotados com @protected, portanto, na prática, toda vez que um verify for utilizado, um <em>warning</em> vai ser mapeado no seu projeto (a menos que se utilize a supressão do <em>warning</em> em cada linha).</p><p>Dito isso, escolhemos seguir por uma abordagem menos rápida inicialmente, mas que não resulta numa maior verbosidade nos testes.</p><h3>TestBlocObserver</h3><p>Para seguirmos em frente sem os acessar os métodos protegidos, podemos escolher implementar uma classe que extende ou implementa a classe BlocObserver . Por esse caminho, há diversas maneiras de seguir a partir daí, e um deles pode ser esse: criar uma classe que sobrescreve o método BlocObserver.onEvent e guarda cada um dos eventos que são adicionados aos BLoCs:</p><pre>import &#39;package:flutter_bloc/flutter_bloc.dart&#39;;<br><br>class TestBlocObserver extends BlocObserver {<br>  final Map&lt;Bloc, List&gt; _blocEventsMap = {};<br><br>  @override<br>  void onEvent(Bloc bloc, Object? event) {<br>    super.onEvent(bloc, event);<br>    final events = _blocEventsMap[bloc];<br>    if (events == null) _blocEventsMap[bloc] = List.empty(growable: true);<br>    _blocEventsMap[bloc]?.add(event);<br>  }<br><br>  bool has(Bloc bloc, Object event) {<br>    return _blocEventsMap[bloc]?.contains(event) == true;<br>  }<br>}</pre><p>Dessa forma, utilizando o método blocObserver.has(), podemos escrever nosso teste dessa maneira:</p><pre>final blocObserver = TestBlocObserver();<br>Bloc.observer = blocObserver;<br><br>//...<br><br>blocTest(<br>  &quot;when LoadEverythingEvent is added, &quot;<br>  &quot;then expect BlocObserver has LoadAEvent and LoadBEvent&quot;,<br>  build: build,<br>  act: (bloc) =&gt; bloc.add(LoadEverythingEvent()),<br>  verify: (bloc) {<br>  expect(blocObserver.has(bloc, LoadAEvent()), isTrue);<br>  expect(blocObserver.has(bloc, LoadBEvent()), isTrue);<br>  },<br>);</pre><p>Author: <a href="https://medium.com/u/a653200c67f6">Luís Felipe Almeida Silva</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=49da8a01b86c" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>