<div id="readability-page-1" class="page"><article data-pagefind-body=""> <div id="contents_list" markdown="1">
<h2 id="목차">목차</h2>
<ul>
<li><a href="#%EB%AA%A9%EC%B0%A8">목차</a></li>
<li><a href="#%EA%B0%9C%EC%9A%94">개요</a></li>
<li><a href="#matcher">Matcher</a></li>
<li><a href="#%EC%9E%90%EC%A3%BC-%EC%82%AC%EC%9A%A9%EB%90%98%EB%8A%94-matcher">자주 사용되는 Matcher</a></li>
<li><a href="#%EC%99%84%EB%A3%8C">완료</a></li>
</ul>
</div>
<h2 id="개요">개요</h2>
Flutter에서 테스트 코드를 작성할 때, 여러가지 <code>Matcher</code>를 사용할 수 있습니다. 이번 블로그 포스트에서는 Flutter의 테스트 코드에서 사용 가능한 <code>Matcher</code>에 대해서 알아보고 이를 사용하는 방법에 대해서 알아보겠습니다.
<h2 id="matcher">Matcher</h2>
테스트 코드에서 Matcher는 특정 값이나 조건을 검증하는 데 사용되는 검증 도구입니다. 테스트가 실제 값과 기대하는 값 또는 상태가 일치하는지 비교할 때, Matcher를 사용하여 더 표현력 있고 읽기 쉬운 테스트 코드를 작성할 수 있습니다.
Flutter의 테스트 코드에서 Matcher는 <code>expect</code> 구문을 통해 값이 예상하는 조건에 맞는지 확인할 때 주로 사용됩니다. Matcher는 단순한 값 비교뿐 아니라, 더 복잡한 조건이나 다양한 유형의 검증을 지원합니다.
예를 들어:
<ul>
<li>equals: 값이 특정 값과 동일한지 비교할 수 있습니다.</li>
<li>isNull: 값이 널인지 확인할 수 있습니다.</li>
<li>contains: 컬렉션이나 문자열에 특정 항목이 포함되었는지 검사할 수 있습니다.</li>
<li>throwsException: 함수가 예외를 던지는지 확인할 수 있습니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>void main() {
 test('Example', () {
 var numbers = [1, 2, 3];
 expect(numbers, contains(2));
 expect(numbers, isNotEmpty);
 expect(() =&gt; throw Exception('Error'), throwsException);
 });
}</code></pre>
Matcher를 사용하면 테스트 코드가 더 직관적이고 읽기 쉽게 변해 가독성이 향상되며, 복잡한 조건이나 상태를 간결하게 처리할 수 있습니다. 또한, 여러 조건을 결합하거나 부정(Negation)할 수 있어 더 유연한 테스트 작성이 가능합니다.
<h2 id="자주-사용되는-matcher">자주 사용되는 Matcher</h2>
Flutter의 공식 문서를 확인하면 사용가능한 Matcher들을 확인할 수 있습니다.
<ul>
<li>공식 문서: <a href="https://pub.dev/documentation/matcher/latest/matcher/matcher-library.html" rel="nofollow noreferrer" target="_blank">https://pub.dev/documentation/matcher/latest/matcher/matcher-library.html</a></li>
</ul>
여기서는 자주 사용하는 Matcher들을 소개하겠습니다.
<ul>
<li>equals(expected): 주어진 값이 expected와 같은지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(actual, equals(expected));</code></pre>
<ul>
<li>isNot(matcher): 값이 주어진 매처와 일치하지 않는지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(actual, isNot(equals(5)));</code></pre>
<ul>
<li>isTrue / isFalse: 값이 true 또는 false인지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(value, isTrue);</code></pre>
<ul>
<li>contains(element): 컬렉션이나 문자열에 특정 요소가 포함되어 있는지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect([1, 2, 3], contains(2));</code></pre>
<ul>
<li>isNull / isNotNull: 값이 null인지 또는 null이 아닌지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(value, isNull);
expect(value, isNotNull);</code></pre>
<ul>
<li>greaterThan(value) / lessThan(value): 값이 주어진 값보다 큰지 또는 작은지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(number, greaterThan(10));</code></pre>
<ul>
<li>startsWith(prefix) / endsWith(suffix): 문자열이 특정 문자열로 시작하거나 끝나는지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect('Flutter', startsWith('Fl'));</code></pre>
<ul>
<li>throwsException / throwsA(matcher): 특정 예외가 발생하는지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(() =&gt; someFunction(), throwsException);</code></pre>
<ul>
<li>allOf(matcher1, matcher2, …): 주어진 매처들이 모두 일치하는지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(value, allOf(startsWith('Fl'), contains('utt')));</code></pre>
<ul>
<li>anyOf(matcher1, matcher2, …): 주어진 매처들 중 하나라도 일치하는지 확인합니다.</li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(value, anyOf(equals(1), equals(2)));</code></pre>
<ul>
<li>isA<t>(): 값이 특정 타입인지 확인합니다.</t></li>
</ul>
<pre tabindex="0" data-language="dart"><code>expect(value, isA&lt;int&gt;());</code></pre>
<h2 id="완료">완료</h2>
이것으로 Flutter의 테스트 코드에서 사용 가능한 Matcher에 대해서 알아보았습니다. Matcher를 사용하면 테스트 코드를 더 직관적이고 읽기 쉽게 작성할 수 있으며, 다양한 조건을 검증할 수 있어 유용합니다.
Flutter의 위젯 테스트에서 저는 다음과 같은 코드를 종종 사용했었습니다.
<pre tabindex="0" data-language="dart"><code>expect(titleContainer.child.runtimeType, Container);</code></pre>
이를 다음과 같이 <code>isA&lt;T&gt;()</code> Matcher를 사용하면 더 명확하게 표현할 수 있습니다.
<pre tabindex="0" data-language="dart"><code>expect(titleContainer.child, isA&lt;Container&gt;());</code></pre>
여러분도 Matcher를 사용하여 테스트 코드를 작성할 때, 더 효율적이고 읽기 쉽게 작성해보시기 바랍니다. <code> 제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다! </code> <h2>앱 홍보</h2> <div> 지금 보고 계신 블로그를 작성하는 <code>Deku</code>가 개발한 앱을 한번 사용해보세요. <code>Deku</code>가 개발한 앱은 Flutter로 개발되었습니다.관심있으신 분들은 앱을 다운로드하여 사용해 주시면 정말 감사하겠습니다. </div> <h2>책 홍보</h2> </article></div>

dev-yakuza

Flutter에서 테스트 코드에서 사용 가능한 Matcher에 대해서 알아보고 이를 사용하는 방법에 대해서 알아보겠습니다.

[Flutter] Test Matcher 사용하기

댓글