274

I have a document from a mongoose find that I want to extend before JSON encoding and sending out as a response. If I try adding properties to the doc it is ignored. The properties don't appear in Object.getOwnPropertyNames(doc) making a normal extend not possible. The strange thing is that JSON.parse(JSON.encode(doc)) works and returns an object with all of the correct properties. Is there a better way to do this?

1

9 Answers 9

391

Mongoose Models inherit from Documents, which have a toObject() method. I believe what you're looking for should be the result of doc.toObject().

http://mongoosejs.com/docs/api.html#document_Document-toObject

7
  • 6
    finally got it. for the ones who have toObject undefined, make sure to call on document instead of model. i.e. modelName._doc.toObject()
    – user626776
    Jun 23, 2015 at 16:55
  • 6
    This is OK but lean() is preferred. Jan 11, 2016 at 15:59
  • 3
    Does this work if you return array on Model.find({}) the docs return is an array. Can you docs.toObject?
    – jack blank
    Feb 15, 2017 at 19:46
  • 7
    @jackblank if you have an array of Models, then you should be able to map over them: var docArray = modelArray.map(function(model) { return model.toObject(); });
    – jmar777
    Feb 16, 2017 at 14:58
  • 1
    This sadly doesn't work for nested items afaik - the objects in my array are still mongoose special ones
    – Dominic
    Mar 11, 2018 at 15:34
259

Another way to do this is to tell Mongoose that all you need is a plain JavaScript version of the returned doc by using lean() in the query chain. That way Mongoose skips the step of creating the full model instance and you directly get a doc you can modify:

MyModel.findOne().lean().exec(function(err, doc) {
    doc.addedProperty = 'foobar';
    res.json(doc);
});
12
  • 26
    @Startec Using lean is generally more performant because you skip the overhead of first creating the full Mongoose document.
    – JohnnyHK
    May 4, 2015 at 4:34
  • 6
    you are a champion :) correct me if I am wrong, but you should always lean() your find()s if you do not intend to modify and save the document you just received (say, if you are just trying to access the doc and send it back to your client)
    – Amarsh
    Jun 24, 2015 at 3:49
  • 1
    @Amarsh Yes, although that's also assuming you don't need any of the instance methods or virtuals defined in the schema.
    – JohnnyHK
    Jun 24, 2015 at 4:23
  • 1
    bizzare though ... this could have been an option with find() ... its often too common to read a document from a mongodb and send it back to a web browser. i wonder if find().lean() actually means find() first and then apply a lean() of each element in the result, in which case, find().lean() combination would actually be slower than find() itself.
    – Amarsh
    Jun 24, 2015 at 8:01
  • 6
    @Amarsh No, chaining lean() on the query sets the option before the query is actually executed (by exec) so that the results are directly in their "lean" form. See this question for the positive performance impact side of calling lean.
    – JohnnyHK
    Oct 9, 2015 at 14:48
33

JohnnyHK suggestion:

In some cases as @JohnnyHK suggested, you would want to get the Object as a Plain Javascript. as described in this Mongoose Documentation there is another alternative to query the data directly as object:

const docs = await Model.find().lean();

Conditionally return Plain Object:

In addition if someone might want to conditionally turn to an object,it is also possible as an option argument, see find() docs at the third parameter:

const toObject = true;
const docs = await Model.find({},null,{lean:toObject});

its available on the functions: find(), findOne(), findById(), findOneAndUpdate(), and findByIdAndUpdate().

NOTE:

it is also worth mentioning that the _id attribute isn't a string object as if you would do JSON.parse(JSON.stringify(object)) but a ObjectId from mongoose types, so when comparing it to strings cast it to string before: String(object._id) === otherStringId

1
  • Put the toObject as a string, otherwise you'll get an error. Thank you for the solution.
    – Tal Kohavy
    Mar 12, 2022 at 7:41
30

the fast way if the property is not in the model :

document.set( key,value, { strict: false });

2
  • 7
    yes... and as suprising as it can look, I still think this could be usefull. For instance you keep all your object's primitives. Oct 21, 2014 at 9:50
  • Thanks for this answer, it was what I was looking for :)
    – datUser
    Feb 10, 2015 at 19:03
18

A better way of tackling an issue like this is using doc.toObject() like this

doc.toObject({ getters: true })

other options include:

  • getters: apply all getters (path and virtual getters)
  • virtuals: apply virtual getters (can override getters option)
  • minimize: remove empty objects (defaults to true)
  • transform: a transform function to apply to the resulting document before returning
  • depopulate: depopulate any populated paths, replacing them with their original refs (defaults to false)
  • versionKey: whether to include the version key (defaults to true)

so for example you can say

Model.findOne().exec((err, doc) => {
   if (!err) {
      doc.toObject({ getters: true })
      console.log('doc _id:', doc._id)
   }
})

and now it will work.

For reference, see: http://mongoosejs.com/docs/api.html#document_Document-toObject

8

To get plain object from Mongoose document, I used _doc property as follows

mongooseDoc._doc  //returns plain json object

I tried with toObject but it gave me functions,arguments and all other things which i don't need.

2
  • 6
    Accessing properties or methods with _ in the beginning is not the ideal solution. Using lean might solve your case. Sep 4, 2019 at 6:02
  • @ArthurBrito yes. Its not a ideal solution but its still a SOLUTION! I have used _doc property many times without facing any issue. And using lean method gives you plain object on which you can't perform mongoose model operations.
    – dd619
    Sep 5, 2019 at 7:13
7

The lean option tells Mongoose to skip hydrating the result documents. This makes queries faster and less memory intensive, but the result documents are plain old JavaScript objects (POJOs), not Mongoose documents.

const leanDoc = await MyModel.findOne().lean();

not necessary to use JSON.parse() method

0
4

You can also stringify the object and then again parse to make the normal object. For example like:-

const obj = JSON.parse(JSON.stringify(mongoObj))
4
  • 1
    this also has advantage of getting the _id as a string. Jul 19, 2021 at 5:08
  • 1
    JSON.parse is a very slow command and quite heavy on performance.
    – BertC
    Dec 8, 2021 at 12:24
  • Really how did you gauge it's speed @BertC
    – user11720628
    Feb 13, 2022 at 18:41
  • @chuklore, various articles like this one: itnext.io/…
    – BertC
    Feb 14, 2022 at 9:42
1

I have been using the toObject method on my document without success. I needed to add the flattenMap property to true to finally have a POJO.

const data = document.data.toObject({ flattenMaps: true });

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.