populate()

Définition

Méthode qui remplace les ObjectId références par les documents complets de la collection liée. Équivalent d'un JOIN automatique gère par Mongoose. L'option options.session permet d'inclure un populate() a l'intérieur d'une transaction MongoDB, et match filtre les documents références sans filtrer le document parent.

Analogie

Cliquer sur un lien hypertexte pour voir le contenu complet au lieu de juste le numéro de référence.

Exemple de code

const order = await Order
  .findById(id)
  .populate('customer', 'name email')
  .populate('products');

Cas d'usage

Charger les données liées (auteur d'un article, produits d'une commande) en une seule requête logique.

Anti-pattern

Termes liés

Sources

• mongoosejs.com/docs/populate.html