Files
freeCodeCamp/curriculum/challenges/english/05-apis-and-microservices/mongodb-and-mongoose/use-model.find-to-search-your-database.md
Shaun Hamilton e1bae44036 feat(learn): migrate mongodb-mongoose instructions to learn (#39970)
* feat(learn): migrate mongodb-mongoose instructions to learn

* remove extraneous quotation mark

* update with boilerplate change

* grammar changes on instructions

Co-authored-by: Randell Dawson <5313213+RandellDawson@users.noreply.github.com>

Co-authored-by: Randell Dawson <5313213+RandellDawson@users.noreply.github.com>
2020-11-03 08:22:55 -06:00

62 lines
1.5 KiB
Markdown

---
id: 587d7fb7367417b2b2512c0b
title: Use model.find() to Search Your Database
challengeType: 2
forumTopicId: 301543
---
## Description
<section id='description'>
In its simplest usage, `Model.find()` accepts a query document (a JSON object) as the first argument, then a callback. It returns an array of matches. It supports an extremely wide range of search options. Read more in the docs.
</section>
## Instructions
<section id='instructions'>
Modify the `findPeopleByName` function to find all the people having a given name, using `Model.find() -> [Person]`
Use the function argument `personName` as the search key.
</section>
## Tests
<section id='tests'>
```yml
tests:
- text: Find all items corresponding to a criteria should succeed
testString: |
getUserInput => $.post(getUserInput('url') + '/_api/find-all-by-name', {name: 'r@nd0mN4m3', age: 24, favoriteFoods: ['pizza']}).then(data => {
assert.isArray(data, 'the response should be an Array');
assert.equal(data[0].name, 'r@nd0mN4m3', 'item.name is not what expected');
assert.equal(data[0].__v, 0, 'The item should be not previously edited');
}, xhr => { throw new Error(xhr.responseText); })
```
</section>
## Challenge Seed
<section id='challengeSeed'>
</section>
## Solution
<section id='solution'>
```js
/**
Backend challenges don't need solutions,
because they would need to be tested against a full working project.
Please check our contributing guidelines to learn more.
*/
```
</section>