Home Reference Source RepositoryJoin us on Slack
public class | 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
public

Public Methods

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

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

Params:

NameTypeAttributeDescription
values Object
  • optional
options Object
  • optional

Options passed to target.create and setAssociation.

Return:

Promise

See:

  • Model#create for a full explanation of options

public get(options: Object): Promise<Model> source

Get the associated instance.

Params:

NameTypeAttributeDescription
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:

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

Set the associated model.

Params:

NameTypeAttributeDescription
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