$objectToArray (Converter Objeto em Array de Pares Chave-Valor)

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

$objectToArray (Converter Objeto em Array de Pares Chave-Valor)

$objectToArray converte um documento em um array de pares chave-valor, cada elemento no formato { k: 'nomeDoCampo', v: 'valorDoCampo' }. Brilha quando os nomes dos campos são dinâmicos (ex.: dimensões de pontuação por usuário), permitindo que $map/$filter processem cada campo uniformemente, e também é útil para achatar subdocumentos antes da agregação. O argumento deve ser um documento simples — um array gera erro. Combine com $arrayToObject para conversão de ida e volta.

📝 Sintaxe

{ $objectToArray: <objeto> }

⚙️ Parâmetros

Retorno：Uma matriz de pares chave-valor no formato { k: 'fieldName', v: 'value' }; null quando o argumento é null

▶ Exemplo

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

// $objectToArray: transformar um subdocumento de pontuações em um array
db.users.aggregate([
  { $project: {
      scores: { $objectToArray: '$scores' }
  } }
])

Saída：

{ '_id': 1, 'scores': [ { 'k': 'math', 'v': 90 }, { 'k': 'eng', 'v': 85 } ] }

📌 Notas

• Cada elemento do resultado tem k como o nome do campo em string e v como o valor do campo
• Apenas documentos simples convertem; arrays ou escalares geram erro
• A ordem dos campos segue a ordem de inserção; combine com $map/$filter para lidar com campos dinâmicos

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

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.

Sobre Nós