Skip to main content

withInitialHypermediaResource

Creates a resource in the store which gets automatically loaded when an instance of the store is created.

API​

function withInitialHypermediaResource<ResourceName extends string, TResource>(
    resourceName: ResourceName, initialValue: TResource, url: string | (() => string)): SignalStoreFeature;
  • resourceName: The name of how the resource will be declared in the store.
  • initialValue: The initial value of the resource before it is loaded from a URL.
  • url: The URL from which the resource will be loaded. Can also be a function returning a string. If a function is provided, it will be executed at the time the store is created.

State​

With this feature the following state properties are added to the interface of the store:

Resource State​

<resourceName>: DeepSignal<TResource>

A deep signal containing the data of the resource.

Resource Meta State​

<resourceName>State: DeepSignal<
    {
        url: string,
        isLoading: boolean,
        isLoaded: boolean
    }>

A deep signal containing meta information about the resource.

  • url: The URL from which the resource was last loaded.
  • isLoading: Whether the resource is currently being loaded.
  • isLoaded: Whether the resource currently in the state was loaded from the server.

Methods​

With this feature the following methods are added to the interface of the store:

Load the Resource from an URL​

load<resourceName>FromUrl(url: string | null, fromCache?: boolean): Promise<void>

Loads the resource from the provided URL.

  • url: The URL from which the resource should be loaded. If null is provided the resource is reset to its initial value.
  • fromCache: Whether to load the resource even if the the current state is loaded from the same URL. If not provided, defaults to false.
load<resourceName>FromLink(linkRoot: unknown, linkName: string): Promise<void>

Loads the resource from the provided URL.

  • linkRoot: An object containing the link to use.
  • linkName: The name of the link to use to load the resource.

Reload the Resource​

reload<resourceName>(): Promise<void>

Reloads the resource from the last used URL.