MongoDB $isArray

No MongoDB você pode usar o $isArray operador de pipeline de agregação para verificar se um valor é ou não uma matriz.

Ele aceita qualquer expressão válida e retorna true se a expressão for um array, false se não for.

Exemplo

Suponha que tenhamos uma coleção chamada test com os seguintes documentos:

{ "_id" : 1, "data" : [ ] }
{ "_id" : 2, "data" : [ 1, 2, 3 ] }
{ "_id" : 3, "data" : [ "XS", "M", "L" ] }
{ "_id" : 4, "data" : 123 }
{ "_id" : 5, "data" : "Homer Jay" }

Podemos usar o seguinte código para verificar os data campo para matrizes:

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 1, 2, 3, 4, 5 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

Resultado:

{ "_id" : 1, "data" : [ ], "result" : true }
{ "_id" : 2, "data" : [ 1, 2, 3 ], "result" : true }
{ "_id" : 3, "data" : [ "XS", "M", "L" ], "result" : true }
{ "_id" : 4, "data" : 123, "result" : false }
{ "_id" : 5, "data" : "Homer Jay", "result" : false }

Podemos ver que os três primeiros documentos contêm arrays e os outros dois não.

Além disso, podemos ver que o primeiro documento contém um array vazio. Isso ainda é um array, então $isArray retorna true .

Exemplo 2

Aqui está outro exemplo que contém vários campos de diferentes tipos de BSON.

Suponha que tenhamos uma coleção chamada types com o seguinte documento:

{
	"_id" : ObjectId("601738d7c8eb4369cf6ad9de"),
	"double" : 123.75,
	"string" : "123",
	"boolean" : true,
	"date" : ISODate("2020-12-31T23:30:15.123Z"),
	"integer" : 123,
	"long" : NumberLong(123),
	"decimal" : NumberDecimal("123.75"),
	"object" : {
		"a" : 1
	},
	"array" : [
		1,
		2,
		3
	]
}

Para os propósitos deste artigo, nomeei cada campo para refletir seu tipo BSON.

Agora podemos usar o seguinte código para retornar true ou false para cada campo, dependendo se o campo é ou não um array:

db.types.aggregate(
  [
    {
      $project:
        { 
          _id: { $isArray: "$_id" },
          double: { $isArray: "$double" },
          string: { $isArray: "$string" },
          boolean: { $isArray: "$boolean" },
          date: { $isArray: "$date" },
          integer: { $isArray: "$integer" },
          long: { $isArray: "$long" },
          decimal: { $isArray: "$decimal" },
          object: { $isArray: "$object" },
          array: { $isArray: "$array" }
        }
    }
  ]
).pretty()

Resultado:

{
	"_id" : false,
	"double" : false,
	"string" : false,
	"boolean" : false,
	"date" : false,
	"integer" : false,
	"long" : false,
	"decimal" : false,
	"object" : false,
	"array" : true
}

Campo ausente

Aplicando $isArray para um campo que não existe resulta em false .

Suponha que nosso test A coleção contém o seguinte documento:

{ "_id" : 6 }

E aplicamos $isArray a esse documento:

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 6 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

Resultado:

{ "_id" : 6, "result" : false }

Valores nulos

Aplicando $isArray para null retorna false .

Suponha que nosso test A coleção contém o seguinte documento:

{ "_id" : 7, "data" : null }

E aplicamos $isArray a esse documento:

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 7 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

Resultado:

{ "_id" : 7, "data" : null, "result" : false }

Valores indefinidos

Da mesma forma, fornecer valores indefinidos retorna false .

Suponha que nosso test A coleção contém o seguinte documento:

{ "_id" : 8, "data" : undefined }

Aplicar $isArray :

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 8 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

Resultado:

{ "_id" : 8, "data" : undefined, "result" : false }