store.queryRecord()

Fetches a single record matching server-side query parameters.

Since Ember 4/5 (Octane) Spec ↗

Syntax

store.queryRecord(type, params): Promise<Model | null>

Parameters

NameTypeRequiredDescription
type string No The model name.
params object No Query parameters that should resolve to one record.

Returns

Promise<Model | null> — Resolves to the single matched record.

Examples

import Service from '@ember/service';
import { service } from '@ember/service';

export default class SessionService extends Service {
  @service store;

  loadCurrentUser() {
    return this.store.queryRecord('user', { me: true });
  }
}

Notes

Use when the API returns one resource for the given query (e.g. "current user"). The adapter should return a single primary record; queryRecord always performs a network request.