EntrySelector <D>

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

You can use an EntrySelector by accessing ModelInstance.entries.

Index

Methods

• get
• list

Methods

get

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

• Returns a StarlightItemResponse with a single Entry. Supports revision previewing by passing a preview parameter.

  @example

  Requesting information from an entry “hello-world” from a model of slug “posts”.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.posts.entries.get('hello-world')

  @example

  Passing a preview token on the last example.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.posts.entries.get('hello-world', {
    preview: 'CDfkvt1zTF5XhxWzi2Lejgo1'
  })

  ---

  Parameters

  • slug: string

    The entry slug.

  • optionalparams: GetEntryParams

    An optional object of request parameters. See GetEntryParams for all available options.

  • 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<Entry<D>>>

list

• list(params?: ListEntriesParams & QueryableFields<D>, options?: RequestInit): Promise<StarlightListResponse<Entry<D>>>

• Returns a StarlightListResponse with a list of Entries.

  @example

  Requesting all entries from a model of slug “recipes”.

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

  @example

  Paginating and searching on the last example.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.recipes.entries.list({
    page: 2,
    query: 'gravy',
    'field:is_vegan': true,
  })

  @example

  Ordering entries by number of views.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.recipes.entries.list({
    order: 'views:desc'
  })

  ---

  Parameters

  • optionalparams: ListEntriesParams & QueryableFields<D>

    An optional object of request parameters. See ListEntriesParams for all available parameters. field:foo syntax is also supported, see QueryableFields for more info.

  • 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<Entry<D>>>