$push (Acrescentar ao Array)

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

$push (Acrescentar ao Array)

$push acrescenta um ou mais elementos ao fim de um array. `{ $push: { items: 'pen' } }`; para vários valores de uma vez, combine com $each. Ele também compõe com $position (ponto de inserção), $slice (limite de tamanho) e $sort (ordenação) para manutenção avançada de arrays. É o operador de atualização de array mais usado.

📝 Sintaxe

{ $push: { <campo de array>: <valor> } }

⚙️ Parâmetros

Retorno：O resultado da atualização

▶ Exemplo

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

// $push: acrescenta um elemento
// Duplicatas são permitidas
db.carts.updateOne(
  { _id: 1 },
  { $push: { items: 'pen' } }
)

// Acrescenta vários de uma vez
// Exige $each
db.carts.updateOne(
  { _id: 1 },
  { $push: { items: { $each: ['book', 'ruler'] } } }
)

Saída：

// items ganha pen, depois book e ruler; duplicatas permitidas

📌 Notas

• Acrescenta no fim por padrão; use $addToSet para deduplicação
• Acréscimos em lote exigem $each
• Combine $position/$slice/$sort para controlar posição e tamanho

🏷️ 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