.populateAll( [query] )

Purpose

This chainable method is used between .find()/.update() and .exec() in order to retrieve records associated with the model being queried. All known associations of your model will be populated and the query will be applied to each of them.

Overview

Parameters

Description Accepted Data Types Required ?
1 Query object No

Example Usage

  2. User.find({name:'Mike'}).exec(function(e,r){
  3.   console.log(r[0].toJSON())
  4. })
  6. /* 
  7. { name: 'Mike',
  8.   age: 16,
  9.   createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  10.   updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  11.   id: 7 }
  12. */
  14. User.find({name:'Mike'}).populateAll().exec(function(e,r){
  15.   console.log(r[0].toJSON())
  16. });
  18. /*
  19. { poneys:
  20.    [ { name: 'Twinky',
  21.        color: 'brown',
  22.        id: 1,
  23.        createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  24.        updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST) } ],
  25.   pets: 
  26.    [ { name: 'Pinkie Pie',
  27.        color: 'pink',
  28.        id: 7,
  29.        createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  30.        updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST) },
  31.      { name: 'Rainbow Dash',
  32.        color: 'blue',
  33.        id: 8,
  34.        createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  35.        updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST) },
  36.      { name: 'Applejack',
  37.        color: 'orange',
  38.        id: 9,
  39.        createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  40.        updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST) } ],
  41.   name: 'Mike',
  42.   age: 16,
  43.   createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  44.   updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  45.   id: 7 }
  46. */
  48. User.find({name:'Mike'}).populateAll({color:'pink'}).exec(function(e,r){
  49.   console.log(r[0].toJSON())
  50. });
  52. /*
  53. { pets: 
  54.    [ { name: 'Pinkie Pie',
  55.        color: 'pink',
  56.        id: 7,
  57.        createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  58.        updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST) }],
  59.   name: 'Mike',
  60.   age: 16,
  61.   createdAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  62.   updatedAt: Wed Feb 12 2014 18:06:50 GMT-0600 (CST),
  63.   id: 7 }
  64. */

Notes

Any string arguments passed must be the primary key of the record.