Back to Sequelize

Mixin HasMany

static/v3/api/associations/has-many/index.html

latest6.0 KB
Original Source

Mixin HasMany

View code

One-to-many association

In the API reference below, replace Association(s) with the actual name of your association, e.g. for User.hasMany(Project) the getter will be user.getProjects().


getAssociations([options]) -> Promise.<Array.<Instance>>

View code

Get everything currently associated with this, using an optional where clause.

Params:

NameTypeDescription
[options]Object
[options.where]ObjectAn optional where clause to limit the associated models
[options.scope]StringBoolean
[options.schema]StringApply a schema on the related model

setAssociations([newAssociations], [options]) -> Promise

View code

Set the associated models by passing an array of instances or their primary keys. Everything that is not in the passed array will be un-associated

Params:

NameTypeDescription
[newAssociations]Array.<InstanceString
[options]ObjectOptions passed to target.findAll and update.
[options.validate]ObjectRun validation for the join model

addAssociations([newAssociations], [options]) -> Promise

View code

Associate several instances with this.

Params:

NameTypeDescription
[newAssociations]Array.<InstanceString
[options]ObjectOptions passed to target.update.
[options.validate]ObjectRun validation for the join model.

addAssociation([newAssociation], [options]) -> Promise

View code

Associate one instance with this.

Params:

NameTypeDescription
[newAssociation]InstanceString
[options]ObjectOptions passed to target.update.
[options.validate]ObjectRun validation for the join model.

createAssociation([values], [options]) -> Promise

View code

Create a new instance of the associated model and associate it with this.

Params:

NameTypeDescription
[values]Object
[options]ObjectOptions passed to target.create.

removeAssociation([oldAssociated], [options]) -> Promise

View code

Un-associate the instance.

Params:

NameTypeDescription
[oldAssociated]InstanceString
[options]ObjectOptions passed to target.update

removeAssociations([oldAssociatedArray], [options]) -> Promise

View code

Un-associate several instances.

Params:

NameTypeDescription
[oldAssociatedArray]Array.<InstanceString
[options]ObjectOptions passed to through.destroy

hasAssociation([instance], [options]) -> Promise

View code

Check if an instance is associated with this.

Params:

NameTypeDescription
[instance]InstanceString
[options]ObjectOptions passed to getAssociations

hasAssociations([instances], [options]) -> Promise

View code

Check if all instances are associated with this.

Params:

NameTypeDescription
[instances]Array.<InstanceString
[options]ObjectOptions passed to getAssociations

countAssociations([options]) -> Promise.<Int>

View code

Count everything currently associated with this, using an optional where clause.

Params:

NameTypeDescription
[options]Object
[options.where]ObjectAn optional where clause to limit the associated models
[options.scope]StringBoolean

This document is automatically generated based on source code comments. Please do not edit it directly, as your changes will be ignored. Please write on IRC, open an issue or a create a pull request if you feel something can be improved. For help on how to write source code documentation see JSDoc and dox