> For the complete documentation index, see [llms.txt](https://simpldb.js.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://simpldb.js.org/v2.11.0/documentation/collection/fetch.md).

# .fetch()

Fetches the entries directly from the JSON file and returns the ones that match the provided filter. Fetches and returns all the entries from the collection if no filter is provided.

### fetch(filter)

| **Parameter** | **Description**                                                                                                                                                                                                                                                         |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| filter        | <p><a href="https://developer.mozilla.org/en-US/docs/Glossary/Callback_function">Callback</a> (optional)</p><p>Function to test each element of the array. Return a value that coerces to <code>true</code> to keep the element, or to <code>false</code> otherwise</p> |

| **Returns**                                                                                                                                                                                                                             | **Description**                                                                                            |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [Data](https://simpldb.gitbook.io/docs/types-and-interfaces/data) \| [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Data](https://simpldb.gitbook.io/docs/types-and-interfaces/data)> | Entries that match the filter or a single entry if the array length is equal to 1 and a filter is provided |

```javascript
// Note: Users is a collection.

Users.create({ id: 1, name: '5antos' }); // { id: 1, name: '5antos' }

Users.fetch(); // [{ id: 1, name: '5antos' }]
Users.fetch(u => u.id === 1); // { id: 1, name: '5antos' }
Users.fetch(u => u.name === 'Unnamed user'); // null
```