MongoDB $isArray

En MongoDB puedes usar el $isArray operador de canalización de agregación para verificar si un valor es o no una matriz.

Acepta cualquier expresión válida y devuelve true si la expresión es una matriz, false si no lo es.

Ejemplo

Supongamos que tenemos una colección llamada test con los siguientes 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 el siguiente código para verificar los data campo para arreglos:

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 los primeros tres documentos contienen arreglos y los otros dos no.

Además, podemos ver que el primer documento contiene una matriz vacía. Eso sigue siendo una matriz, por lo que $isArray devuelve true .

Ejemplo 2

Aquí hay otro ejemplo que contiene varios campos de diferentes tipos de BSON.

Supongamos que tenemos una colección llamada types con el siguiente 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
	]
}

A los efectos de este artículo, he nombrado cada campo para reflejar su tipo BSON.

Ahora podemos usar el siguiente código para devolver true o false para cada campo, dependiendo de si el campo es o no una matriz:

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 faltante

Aplicando $isArray a un campo que no existe da como resultado false .

Supongamos que nuestra test colección contiene el siguiente documento:

{ "_id" : 6 }

Y aplicamos $isArray a ese 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 a null devuelve false .

Supongamos que nuestra test colección contiene el siguiente documento:

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

Y aplicamos $isArray a ese 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

Del mismo modo, proporcionar valores indefinidos devuelve false .

Supongamos que nuestra test colección contiene el siguiente 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 }