$anyElementTrue (Verificar se Algum Elemento É Verdadeiro)

Última atualização: 2026-10-09

$anyElementTrue (Verificar se Algum Elemento É Verdadeiro)

$anyElementTrue retorna true quando ao menos um elemento de um array é verdadeiro. Um array vazio retorna false. Usos típicos: verificar se um usuário tem algum endereço de entrega ou se um pedido tem algum desconto ativo. É o dual de $allElementsTrue — true se algum elemento for verdadeiro. A veracidade segue as mesmas regras (0, string vazia, null e false são falsos).

CategoriaConjunto, Condição e Conversão
Versão do MongoDB1.0+
Idioma do Exemplomongosh (Shell)

📝 Sintaxe

{ $anyElementTrue: [ <array> ] }

⚙️ Parâmetros

arrayA matriz a verificar.

Retorno:true quando qualquer elemento é verdadeiro; uma matriz vazia retorna false

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $anyElementTrue: alguma flag VIP está ativa
db.users.aggregate([
  { $project: {
      isVip: { $anyElementTrue: ['$vipFlags'] }
  } }
])

Saída:

{ '_id': 1, 'isVip': true }
{ '_id': 2, 'isVip': false }

📌 Notas

Mais casos práticos em breve.

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

QO que um array vazio retorna?
ARetorna false, o oposto de $allElementsTrue.
QComo se relaciona com $allElementsTrue?
AEles são duais: um é true se algum elemento for verdadeiro, o outro apenas se todos forem.
QPosso passar um array de campos booleanos?
ASim para arrays de booleanos; mapeie o campo primeiro para arrays de objetos.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%