HasMany

Extends:

Связь один ко многим

В справочнике API ниже добавьте имя ассоциации к методу, например, для User.hasMany(Project) получатель будет user.getProjects(). Если ассоциация алиасирована, используйте алиас вместо этого, например, User.hasMany(Project, { as: 'jobs' }) будет user.getJobs().

См.:

Model.hasMany

Краткое описание методов

Публичные методы
public	add(sourceInstance: Model, targetInstances: Model \| Model[] \| string[] \| string \| number[] \| number, options: Object): Promise Связать одну или несколько целевых строк с `this`.
public	count(instance: Model, options: Object): Promise<number> Подсчитать все, что в настоящее время связано с этим, используя необязательное условие where.
public	create(sourceInstance: Model, values: Object, options: Object): Promise Создать новую запись связанной модели и связать её с этой.
public	get(instances: Model \| Array<Model>, options: Object): Promise<Array<Model>> Получить все, что в настоящее время связано с этим, используя необязательное условие where.
public	has(sourceInstance: Model, targetInstances: Model \| Model[] \| string[] \| string \| number[] \| number, options: Object): Promise Проверить, связаны ли одна или несколько строк с `this`.
public	remove(sourceInstance: Model, targetInstances: Model \| Model[] \| string \| string[] \| number \| number[], options: Object): Promise Отвязать одну или несколько целевых строк.
public	set(sourceInstance: Model, targetInstances: Model \| Model[] \| string[] \| string \| number[] \| number, options: Object): Promise Установить связанные модели, передав массив сохранённых записей или их первичные ключи.

Наследуемое описание

От класса Association
public	associationType: string Тип ассоциации.
public	source: Model
public	target: Model

Публичные методы

public add(sourceInstance: Model, targetInstances: Model | Model[] | string[] | string | number[] | number, options: Object): Promise source

Связать одну или несколько целевых строк с this. Этот метод принимает модель/строку/число для связывания одной строки или смешанный массив моделей/строк/чисел для связывания нескольких строк.

Параметры:

Имя	Тип	Атрибут	Описание
sourceInstance	Model		источник экземпляра
targetInstances	Model \| Model[] \| string[] \| string \| number[] \| number	необязательно	Один экземпляр или первичный ключ, или смешанный массив персистированных экземпляров или первичных ключей
options	Object	необязательно	Параметры, передаваемые в `target.update`.

Возвращаемое значение:

Promise

public count(instance: Model, options: Object): Promise<number> source

Подсчитать все, что в данный момент связано с этим, используя необязательное условие where.

Параметры:

Имя	Тип	Атрибут	Описание
instance	Model		источник экземпляра
options	Object	необязательно	варианты поиска и подсчета
options.where	Object	необязательно	Необязательное условие where для ограничения связанных моделей
options.scope	string \| boolean	необязательно	Применить область действия к связанной модели или удалить ее по умолчанию, передав false

Возвращаемое значение:

Promise<number>

public create(sourceInstance: Model, values: Object, options: Object): Promise source

Создать новый экземпляр связанной модели и связать его с этим.

Параметры:

Имя	Тип	Атрибут	Описание
sourceInstance	Model		источник экземпляра
values	Object	необязательно	значения для экземпляра целевой модели
options	Object	необязательно	Параметры, передаваемые в `target.create`

Возвращаемое значение:

Promise

public get(instances: Model | Array<Model>, options: Object): Promise<Array<Model>> source

Получить все, что в данный момент связано с этим, используя необязательное условие where.

Параметры:

Имя	Тип	Атрибут	Описание
instances	Model \| Array<Model>		Исходные экземпляры.
options	Object	необязательно	Параметры поиска.
options.where	Object	необязательно	Необязательное условие where для ограничения связанных моделей.
options.scope	string \| boolean	необязательно	Применить область видимости к связанной модели или убрать её значение по умолчанию, передав false
options.schema	string	необязательно	Применить схему к связанной модели.

Возвращаемое значение:

Promise<Array<Model>>

См. также:

Model.findAll для полного объяснения параметров

public has(sourceInstance: Model, targetInstances: Model | Model[] | string[] | string | number[] | number, options: Object): Promise source

Проверить, связана ли одна или несколько строк с this.

Параметры:

Имя	Тип	Атрибут	Описание
sourceInstance	Model		Источник экземпляра.
targetInstances	Model \| Model[] \| string[] \| string \| number[] \| number	необязательно	Может быть массивом экземпляров или их первичных ключей.
options	Object	необязательно	Опции, передаваемые в getAssociations.

Возвращаемое значение:

Promise

public remove(sourceInstance: Model, targetInstances: Model | Model[] | string | string[] | number | number[], options: Object): Promise source

Отвязать одну или несколько целевых строк.

Параметры:

Имя	Тип	Атрибут	Описание
sourceInstance	Model		экземпляр для отвязки экземпляров
targetInstances	Model \| Model[] \| string \| string[] \| number \| number[]	необязательно	Может быть экземпляром или его первичным ключом, или смешанным массивом экземпляров и первичных ключей
options	Object	необязательно	Опции, передаваемые в `target.update`

Возвращаемое значение:

Promise

public set(sourceInstance: Model, targetInstances: Model | Model[] | string[] | string | number[] | number, options: Object): Promise source

Установить связанные модели, передав массив сохраненных экземпляров или их первичные ключи. Всё, что не находится в переданном массиве, будет отвязано.

Параметры:

Имя	Тип	Атрибут	Описание
sourceInstance	Model		исходный экземпляр для ассоциации с новыми экземплярами
targetInstances	Model \| Model[] \| string[] \| string \| number[] \| number	необязательно	Массив сохраненных экземпляров или первичные ключи экземпляров для ассоциации. Передайте `null` или `undefined` для удаления всех ассоциаций.
options	Object	необязательно	Опции, передаваемые в `target.findAll` и `update`.
options.validate	Object	необязательно	Выполнить валидацию для модели соединения.

Возвращаемое значение:

Promise