Assert, assertEquals e assertNotEquals: Quando e Como Usá-los em Testes de Unidade

Entendendo LightningElement, track, api e wire no LWC: Implementações Avançadas e Melhores Práticas

Exemplos de Métodos para serem Utilizados nos Utils do seu Projeto Salesforce

<h2>Introdução</h2>
Quando se trata de desenvolver testes unitários em Apex, é fundamental garantir que nossos testes sejam confiáveis e eficazes. Uma das ferramentas mais poderosas para essa tarefa são as assertivas. No Apex, as assertivas são utilizadas para verificar se as condições esperadas são atendidas durante a execução de um teste. Neste artigo, vamos explorar as diferenças entre as três principais assertivas em Apex: <code>System.assert</code>, <code>System.assertEquals</code> e <code>System.assertNotEquals</code>.
<h2>Desenvolvimento</h2>
<h3>Entendendo as assertivas em Apex</h3>
As assertivas em Apex são utilizadas para verificar se as condições esperadas são atendidas durante a execução de um teste. Se a condição não for atendida, o teste falhará e uma mensagem de erro será exibida.
<h4>System.assert</h4>
A assertiva <code>System.assert</code> é a mais genérica das três. Ela verifica se a condição passada como parâmetro é verdadeira. Se a condição for falsa, o teste falhará.
Exemplo de implementação:
<figure data-rehype-pretty-code-figure=""><pre style="background-color:#24292e;color:#e1e4e8" tabindex="0" data-language="apex" data-theme="github-dark"><code data-language="apex" data-theme="github-dark" style="display: grid;">@isTest
public class MeuTeste {
 @isTest
 public static void meuTeste() {
 Boolean minhaVariavel = true;
 System.assert(minhaVariavel, 'Minha variável deve ser verdadeira');
 }
}</code></pre></figure>
No exemplo acima, o teste falhará se a variável <code>minhaVariavel</code> for falsa.
<h3>System.assertEquals</h3>
A assertiva <code>System.assertEquals</code> é utilizada para verificar se dois valores são iguais. Ela é mais específica do que a <code>System.assert</code>, pois verifica a igualdade entre dois valores.
Exemplo de implementação:
<figure data-rehype-pretty-code-figure=""><pre style="background-color:#24292e;color:#e1e4e8" tabindex="0" data-language="apex" data-theme="github-dark"><code data-language="apex" data-theme="github-dark" style="display: grid;">@isTest
public class MeuTeste {
 @isTest
 public static void meuTeste() {
 Integer meuValor = 5;
 System.assertEquals(meuValor, 5, 'Meu valor deve ser 5');
 }
}</code></pre></figure>
No exemplo acima, o teste falhará se o valor de <code>meuValor</code> não for igual a 5.
<h3>System.assertNotEquals</h3>
A assertiva <code>System.assertNotEquals</code> é o oposto da <code>System.assertEquals</code>. Ela verifica se dois valores não são iguais.
Exemplo de implementação:
<figure data-rehype-pretty-code-figure=""><pre style="background-color:#24292e;color:#e1e4e8" tabindex="0" data-language="apex" data-theme="github-dark"><code data-language="apex" data-theme="github-dark" style="display: grid;">@isTest
public class MeuTeste {
 @isTest
 public static void meuTeste() {
 Integer meuValor = 5;
 System.assertNotEquals(meuValor, 10, 'Meu valor não deve ser 10');
 }
}</code></pre></figure>
No exemplo acima, o teste falhará se o valor de <code>meuValor</code> for igual a 10.
<h4>Quando utilizar cada uma?</h4>
<ul>
<li>Utilize <code>System.assert</code> quando precisar verificar se uma condição geral é verdadeira.</li>
<li>Utilize <code>System.assertEquals</code> quando precisar verificar se dois valores são iguais.</li>
<li>Utilize <code>System.assertNotEquals</code> quando precisar verificar se dois valores não são iguais.</li>
</ul>
<h4>Exemplos práticos</h4>
Agora que conhecemos as diferenças entre as assertivas, vamos explorar alguns exemplos práticos de como utilizá-las em diferentes cenários.
<h5>Verificando se um método retorna um valor esperado</h5>
<figure data-rehype-pretty-code-figure=""><pre style="background-color:#24292e;color:#e1e4e8" tabindex="0" data-language="apex" data-theme="github-dark"><code data-language="apex" data-theme="github-dark" style="display: grid;">@isTest
public class MeuTeste {
 @isTest
 public static void meuTeste() {
 MyClass minhaClasse = new MyClass();
 String resultado = minhaClasse.meuMetodo();
 System.assertEquals(resultado, 'Valor Esperado', 'O método deve retornar o valor esperado');
 }
}</code></pre></figure>
<h5>Verificando se uma exceção é lançada</h5>
<figure data-rehype-pretty-code-figure=""><pre style="background-color:#24292e;color:#e1e4e8" tabindex="0" data-language="apex" data-theme="github-dark"><code data-language="apex" data-theme="github-dark" style="display: grid;">@isTest
public class MeuTeste {
 @isTest
 public static void meuTeste() {
 try {
 minhaClasse.meuMetodo();
 System.assert(false, 'Uma exceção deve ser lançada');
 } catch (DmlException e) {
 System.assertEquals(e.getMessage(), 'Mensagem de erro esperada');
 }
 }
}</code></pre></figure>
<h5>Verificando se uma variável não é nula</h5>
<figure data-rehype-pretty-code-figure=""><pre style="background-color:#24292e;color:#e1e4e8" tabindex="0" data-language="apex" data-theme="github-dark"><code data-language="apex" data-theme="github-dark" style="display: grid;">@isTest
public class MeuTeste {
 @isTest
 public static void meuTeste() {
 MyClass minhaClasse = new MyClass();
 Object minhaVariavel = minhaClasse.minhaPropriedade;
 System.assertNotEquals(minhaVariavel, null, 'A variável não deve ser nula');
 }
}</code></pre></figure>
<h2>Conclusão</h2>
Neste artigo, exploramos as diferenças entre as assertivas <code>System.assert</code>, <code>System.assertEquals</code> e <code>System.assertNotEquals</code> em Apex. Apreendemos como utilizar cada uma delas em diferentes cenários e exemplos práticos. Lembre-se de que as assertivas são fundamentais para garantir a integridade dos seus testes unitários em Apex.

Code Referral.

Entendendo: System.assert, System.assertEquals e System.assertNotEquals

Compartilhe:

Categorias

Post Suggestions

Assert, assertEquals e assertNotEquals: Quando e Como Usá-los em Testes de Unidade

Entendendo LightningElement, track, api e wire no LWC: Implementações Avançadas e Melhores Práticas

Exemplos de Métodos para serem Utilizados nos Utils do seu Projeto Salesforce