lean()

Mongoose 🟡 Mid

Définition

Méthode qui retourne des objets JavaScript bruts au lieu d'instances Mongoose. 2 a 5x plus rapide car elle saute l'hydratation, les getters et les virtuals. Mongoose 9 (dernière version stable 9.10.2) s'appuie sur le driver MongoDB Node.js 7.6 ; le comportement de lean() reste identique, y compris combine a un curseur en streaming via cursor().

Analogie

Commander un plat a emporter sans assiette ni couverts : plus léger et plus rapide a servir.

Exemple de code

const users = await User
  .find({ status: 'active' })
  .lean();
// users[0].save() -> Error (pas un doc Mongoose)

Cas d'usage

API en lecture seule ou les données sont serialisees en JSON sans modification.

Anti-pattern

Utiliser lean() puis essayer d'appeler .save() ou des méthodes d'instance Mongoose.

Termes liés

#sgbd#interview#database#mongoose

Sources

npmjs.com/package/mongoose

Fiche mise à jour le 2026-09-27