Back to Sequelize

HasOne

static/v4/class/lib/associations/has-one.js~HasOne.html

latest3.6 KB
Original Source

publicclass| source

HasOne

Extends:

Association → HasOne

One-to-one association

In the API reference below, add the name of the association to the method, e.g. for User.hasOne(Project) the getter will be user.getProject(). This is almost the same as belongsTo with one exception - The foreign key will be defined on the target model.

See:

Method Summary

| Public Methods | | public |

create(values: Object, options: Object): Promise

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

| | | public |

get(options: Object): Promise<Model>

Get the associated instance.

| | | public |

set(newAssociation: Model | String | Number, options: Object): Promise

Set the associated model.

| |

Inherited Summary

| From class Association | | public |

associationType: string

The type of the association.

| | | public |

source: Model

| | | public |

target: Model

| |

Public Methods

publiccreate(values: Object, options: Object): Promise source

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

Params:

| Name | Type | Attribute | Description | | values | Object |

  • optional

| | | options | Object |

  • optional

|

Options passed to target.create and setAssociation.

|

Return:

| Promise |

See:

  • Model#create for a full explanation of options

publicget(options: Object): Promise<Model> source

Get the associated instance.

Params:

| Name | Type | Attribute | Description | | options | Object |

  • optional

| | | options.scope | String | Boolean |

  • optional

|

Apply a scope on the related model, or remove its default scope by passing false

| | options.schema | String |

  • optional

|

Apply a schema on the related model

|

Return:

| Promise<Model> |

See:

publicset(newAssociation: Model | String | Number, options: Object): Promise source

Set the associated model.

Params:

| Name | Type | Attribute | Description | | newAssociation | Model | String | Number |

  • optional

|

An persisted instance or the primary key of a persisted instance to associate with this. Pass null or undefined to remove the association.

| | options | Object |

  • optional

|

Options passed to getAssociation and target.save

|

Return:

| Promise |