SingletonSelector

A Selector that provide methods to list and request information on Singletons.

You can use an SingletonSelector by accessing ModelInstance.singletons.

Index

Methods

• get
• list

Methods

get

• get<D>(slug: string, params?: BaseRequestParameters, options?: RequestInit): Promise<StarlightItemResponse<Singleton<D>>>

• Returns a StarlightItemResponse with a single Singleton. This methods supports typing the returned Singleton by passing its data type as the generic type <D>.

  @example

  Requesting information from a singleton of slug “home”.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.singletons.get('home')

  @example

  Typing last example’s response.

  import Starlight, { StringField, MediaField, VisualField } from '@starlightcms/js-sdk'
  
  type HomeFields = {
    title: StringField
    subtitle: StringField
    hero_image: MediaField
    hero_content: VisualField
  }
  
  // `response.data` will be of type Singleton<HomeFields>
  const response = await Starlight.singletons.get<HomeFields>('home')

  ---

  Type parameters

  • D: SerializedData

    The type of the returned Singleton’s data property.

  Parameters

  • slug: string

    The singleton slug.

  • optionalparams: BaseRequestParameters

    An optional object of request parameters.

  • optionaloptions: RequestInit

    An optional object of fetch options. See https://developer.mozilla.org/en-US/docs/Web/API/RequestInit for more info.

  Returns Promise<StarlightItemResponse<Singleton<D>>>

list

• list(params?: BaseRequestParameters, options?: RequestInit): Promise<StarlightListResponse<Singleton<Record<string, unknown>>>>

• Returns a StarlightListResponse with a list of Singletons.

  @example

  Requesting all workspace singletons.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.singletons.list()

  ---

  Parameters

  • optionalparams: BaseRequestParameters

    An optional object of request parameters.

  • optionaloptions: RequestInit

    An optional object of fetch options. See https://developer.mozilla.org/en-US/docs/Web/API/RequestInit for more info.

  Returns Promise<StarlightListResponse<Singleton<Record<string, unknown>>>>