|
|
@@ -226,8 +226,8 @@ const rep = schema.getRepository('place');
|
|
|
Добавляет новый документ в коллекцию и возвращает его.
|
|
|
|
|
|
```js
|
|
|
-// вызываем метод `create` с передачей состава
|
|
|
-// нового документа первым параметром
|
|
|
+// вызываем метод `create` с передачей
|
|
|
+// нового состава первым параметром
|
|
|
const person = await rep.create({
|
|
|
name: 'Rick Sanchez',
|
|
|
dimension: 'C-137',
|
|
|
@@ -250,8 +250,8 @@ console.log(person);
|
|
|
// второй параметр принимает объект настроек
|
|
|
// возвращаемого результата (опционально)
|
|
|
const result = await rep.create(data, {
|
|
|
- // "fields" - если определено, то возвращаемый
|
|
|
- // документ будут включать только указанные поля
|
|
|
+ // "fields" - если определено, то результат
|
|
|
+ // будут включать только указанные поля
|
|
|
fields: 'name',
|
|
|
fields: ['name', 'age'],
|
|
|
|
|
|
@@ -269,8 +269,8 @@ const result = await rep.create(data, {
|
|
|
идентификатор не найден, то выбрасывает исключение.
|
|
|
|
|
|
```js
|
|
|
-// документ с идентификатором 1 имеет
|
|
|
-// следующую структуру
|
|
|
+// идентификатор 1 имеет следующую
|
|
|
+// структуру документа
|
|
|
// {
|
|
|
// id: 1,
|
|
|
// name: 'Rick Sanchez',
|
|
|
@@ -295,7 +295,7 @@ console.log(person);
|
|
|
// age: 14 <= значение обновлено
|
|
|
// }
|
|
|
// поле "dimension" удалено, так как
|
|
|
-// не содержалось в новом составе
|
|
|
+// не передавалось с новым составом
|
|
|
```
|
|
|
|
|
|
#### patchById(id, data, filter = undefined)
|
|
|
@@ -386,11 +386,11 @@ console.log(docs);
|
|
|
// ]
|
|
|
```
|
|
|
|
|
|
-Условия выборки обновляемых документов.
|
|
|
+Условия выборки (опционально).
|
|
|
|
|
|
```js
|
|
|
-// второй параметр метода `patch` принимает
|
|
|
-// условия выборки (опционально)
|
|
|
+// второй параметр метода `patch`
|
|
|
+// принимает условия выборки
|
|
|
const result = await rep.patch(data, {
|
|
|
type: 'city', // поле "type" должно иметь значение "city"
|
|
|
description: { // оператор "like" проверяет поле "description"
|
|
|
@@ -399,17 +399,17 @@ const result = await rep.patch(data, {
|
|
|
updatedAt: { // оператор "lt" проверяет значение поля
|
|
|
lt: '2023-12-02T21:00:00.000Z', // "updatedAt" на наличие более ранней даты,
|
|
|
}, // чем указана в условии
|
|
|
- // см. раздел "фильтрация" и "операторы"
|
|
|
+ // см. "Фильтрация"
|
|
|
});
|
|
|
```
|
|
|
|
|
|
#### find(filter = undefined)
|
|
|
|
|
|
-Возвращает все документы коллекции, или использует условия выборки.
|
|
|
+Возвращает все документы коллекции или согласно условию.
|
|
|
|
|
|
```js
|
|
|
// вызов метода `find` без аргументов
|
|
|
-// запрашивает все документы коллекции
|
|
|
+// возвращает всю коллекцию
|
|
|
const result = await rep.find();
|
|
|
console.log(result);
|
|
|
// [
|
|
|
@@ -428,11 +428,11 @@ console.log(result);
|
|
|
// ]
|
|
|
```
|
|
|
|
|
|
-Фильтрация результата в параметре `filter`
|
|
|
+Фильтрация результата (опционально).
|
|
|
|
|
|
```js
|
|
|
-// первый параметр принимает объект
|
|
|
-// c настройками выборки (опционально)
|
|
|
+// первый параметр может принимать
|
|
|
+// объект cо следующими настройками
|
|
|
const result = await rep.find({
|
|
|
// "where" - фильтрация выборки по условию, где
|
|
|
// указанные поля должны содержать определенные
|