Use uma combinação com o arrayContaining
dentro do toEqual
:
const array = [{ name: 'Bob' }, { name: 'Alice' }]
expect(array).toEqual(
expect.arrayContaining([{ name: 'Alice' }, { name: 'Bob' }])
)
Ele ignoraria a ordem do array nesse caso.
Ou talvez tentar ordenar ambos os arrays antes de comparar com o toEqual
.
Alguns detalhes
Como descrito na documentação sobre arrayContaining
:
expect.arrayContaining(array)
corresponde a um array recebido que contém todos os elementos no array esperado. Ou seja, o array esperado é um subconjunto do array recebido. Portanto, combina com um array recebido que contém elementos que não estão no array esperado.
"Ou seja, o array esperado é um subconjunto do array recebido" - Isto implica dizer que basta que o array esperado tenha determinados valores do array testado para o teste passar. Esse comportamento é semelhante ao expect.objectContaining
onde não precisa que todas as chaves estejam presentes no objeto, apenas algumas verificadas no teste já são o suficiente para passar. Mas e para o caso onde o array seja o mesmo, ou seja, mesmo tamanho, mas desordenado? Um teste como o abaixo passaria sem problemas:
it.only('array test', () => {
const array = [{ name: 'Bob' }, { name: 'Alice' }, { name: 'Foo' }]
expect(array).toEqual(
expect.arrayContaining([{ name: 'Alice' }, { name: 'Bob' }])
)
})
Repare que
[{ name: 'Alice' }, { name: 'Bob' }]
é um subconjunto de
[{ name: 'Bob' }, { name: 'Alice' }, { name: 'Foo' }]
Este teste deveria falhar pois estaria faltando { name: 'Foo' }
no expect.arrayContaining
.
Como resolver
Do modo mais imperativo e simples, comparar o tamanho dos arrays usando toHaveLength()
antes de verificar com o expect.arrayContaining
:
// funcao utilitária para reuso em todos os testes
function checkArraysInAnyOrder (array: any[], expected: any[]) {
expect(array).toHaveLength(expected.length)
expect(array).toEqual(expect.arrayContaining(expected))
}
Sucesso:
it('array test', () => {
const array = [{ name: 'Bob' }, { name: 'Alice' }]
const expected = [{ name: 'Alice' }, { name: 'Bob' }]
checkArraysInAnyOrder(array, expected) // sucesso
})
Falha:
it('array test', () => {
const array = [{ name: 'Bob' }, { name: 'Alice' }, { name: 'Foo' }]
const expected = [{ name: 'Alice' }, { name: 'Bob' }]
checkArraysInAnyOrder(array, expected) // falha
})
Como discutido nos comentários, checkArraysInAnyOrder
poderia ser um matcher customizado, mas creio que o esforço e complexidade não valeria a pena. Usar bibliotecas da comunidade que estendem os recursos do Jest como jest-extended, poderiam ajudar a chegar no objetivo. Esta, inclusive, possui o método toIncludeSameMembers
que poderia ser usado para cumprir o objetivo:
Use .toIncludeSameMembers
when checking if two arrays contain equal values, in any order.
test('passes when arrays match in a different order', () => {
expect([1, 2, 3]).toIncludeSameMembers([3, 1, 2]);
expect([{ foo: 'bar' }, { baz: 'qux' }]).toIncludeSameMembers([{ baz: 'qux' }, { foo: 'bar' }]);
});
Claro que cabe a discussão e análise se vale a pena adicionar um biblioteca inteira apenas para uso de uma funcionalidade específica. Ainda falando sobre essa biblioteca, você poderia se basear, ou copiar, o código fonte que implementa o toIncludeSameMembers
e criar seu próprio match.