Skip to main content

Function: withResource()

Call Signature​

withResource<Input, ResourceValue>(resourceFactory): SignalStoreFeature<Input, ResourceResult<ResourceValue | undefined>>

Defined in: lib/with-resource.ts:158

Experimental

Type Parameters​

Input​

Input extends SignalStoreFeatureResult

ResourceValue​

ResourceValue

Parameters​

resourceFactory​

(store) => ResourceRef<ResourceValue>

A factory function that receives the store's state signals, methods, and props.

Returns​

SignalStoreFeature<Input, ResourceResult<ResourceValue | undefined>>

Description​

Integrates a Resource into the SignalStore and makes the store instance implement the Resource interface.

The resource's value is stored under the value key in the state and is exposed as a DeepSignal.

It can also be updated via patchState.

Usage Notes​

const UserStore = signalStore(
  withState({ userId: undefined as number | undefined }),
  withResource(({ userId }) =>
    httpResource<User>(() =>
      userId === undefined ? undefined : `/users/${userId}`
    )
  )
);

const userStore = new UserStore();
userStore.value(); // User | undefined

Call Signature​

withResource<Input, ResourceValue>(resourceFactory, resourceOptions): SignalStoreFeature<Input, ResourceResult<ResourceValue | undefined>>

Defined in: lib/with-resource.ts:167

Experimental

Type Parameters​

Input​

Input extends SignalStoreFeatureResult

ResourceValue​

ResourceValue

Parameters​

resourceFactory​

(store) => ResourceRef<ResourceValue>

A factory function that receives the store's state signals, methods, and props.

resourceOptions​

Allows configuration of the error handling behavior.

errorHandling​

"undefined value"

Returns​

SignalStoreFeature<Input, ResourceResult<ResourceValue | undefined>>

Description​

Integrates a Resource into the SignalStore and makes the store instance implement the Resource interface.

The resource's value is stored under the value key in the state and is exposed as a DeepSignal.

It can also be updated via patchState.

Usage Notes​

const UserStore = signalStore(
  withState({ userId: undefined as number | undefined }),
  withResource(({ userId }) =>
    httpResource<User>(() =>
      userId === undefined ? undefined : `/users/${userId}`
    )
  )
);

const userStore = new UserStore();
userStore.value(); // User | undefined

Call Signature​

withResource<Input, ResourceValue>(resourceFactory, resourceOptions?): SignalStoreFeature<Input, ResourceResult<ResourceValue>>

Defined in: lib/with-resource.ts:177

Experimental

Type Parameters​

Input​

Input extends SignalStoreFeatureResult

ResourceValue​

ResourceValue

Parameters​

resourceFactory​

(store) => ResourceRef<ResourceValue>

A factory function that receives the store's state signals, methods, and props.

resourceOptions?​

ResourceOptions

Allows configuration of the error handling behavior.

Returns​

SignalStoreFeature<Input, ResourceResult<ResourceValue>>

Description​

Integrates a Resource into the SignalStore and makes the store instance implement the Resource interface.

The resource's value is stored under the value key in the state and is exposed as a DeepSignal.

It can also be updated via patchState.

Usage Notes​

const UserStore = signalStore(
  withState({ userId: undefined as number | undefined }),
  withResource(({ userId }) =>
    httpResource<User>(() =>
      userId === undefined ? undefined : `/users/${userId}`
    )
  )
);

const userStore = new UserStore();
userStore.value(); // User | undefined

Call Signature​

withResource<Input, Dictionary>(resourceFactory): SignalStoreFeature<Input, NamedResourceResult<Dictionary, true>>

Defined in: lib/with-resource.ts:221

Experimental

Type Parameters​

Input​

Input extends SignalStoreFeatureResult

Dictionary​

Dictionary extends ResourceDictionary

Parameters​

resourceFactory​

(store) => Dictionary

A factory function that receives the store's props, methods, and state signals. It must return a Record<string, ResourceRef>.

Returns​

SignalStoreFeature<Input, NamedResourceResult<Dictionary, true>>

Description​

Integrates multiple resources into the SignalStore. Each resource is registered by name, which is used as a prefix when spreading the members of Resource onto the store.

Each resource’s value is part of the state, stored under the value key with the resource name as prefix. Values are exposed as DeepSignals and can be updated via patchState.

Usage Notes​

const UserStore = signalStore(
  withState({ userId: undefined as number | undefined }),
  withResource(({ userId }) => ({
    list: httpResource<User[]>(() => '/users', { defaultValue: [] }),
    detail: httpResource<User>(() =>
      userId === undefined ? undefined : `/users/${userId}`
    ),
  }))
);

const userStore = new UserStore();
userStore.listValue(); // []
userStore.detailValue(); // User | undefined

Call Signature​

withResource<Input, Dictionary>(resourceFactory, resourceOptions): SignalStoreFeature<Input, NamedResourceResult<Dictionary, true>>

Defined in: lib/with-resource.ts:230

Experimental

Type Parameters​

Input​

Input extends SignalStoreFeatureResult

Dictionary​

Dictionary extends ResourceDictionary

Parameters​

resourceFactory​

(store) => Dictionary

A factory function that receives the store's state signals, methods, and props.

resourceOptions​

Allows configuration of the error handling behavior.

errorHandling​

"undefined value"

Returns​

SignalStoreFeature<Input, NamedResourceResult<Dictionary, true>>

Description​

Integrates a Resource into the SignalStore and makes the store instance implement the Resource interface.

The resource's value is stored under the value key in the state and is exposed as a DeepSignal.

It can also be updated via patchState.

Usage Notes​

const UserStore = signalStore(
  withState({ userId: undefined as number | undefined }),
  withResource(({ userId }) =>
    httpResource<User>(() =>
      userId === undefined ? undefined : `/users/${userId}`
    )
  )
);

const userStore = new UserStore();
userStore.value(); // User | undefined

Call Signature​

withResource<Input, Dictionary>(resourceFactory, resourceOptions?): SignalStoreFeature<Input, NamedResourceResult<Dictionary, false>>

Defined in: lib/with-resource.ts:240

Experimental

Type Parameters​

Input​

Input extends SignalStoreFeatureResult

Dictionary​

Dictionary extends ResourceDictionary

Parameters​

resourceFactory​

(store) => Dictionary

A factory function that receives the store's state signals, methods, and props.

resourceOptions?​

ResourceOptions

Allows configuration of the error handling behavior.

Returns​

SignalStoreFeature<Input, NamedResourceResult<Dictionary, false>>

Description​

Integrates a Resource into the SignalStore and makes the store instance implement the Resource interface.

The resource's value is stored under the value key in the state and is exposed as a DeepSignal.

It can also be updated via patchState.

Usage Notes​

const UserStore = signalStore(
  withState({ userId: undefined as number | undefined }),
  withResource(({ userId }) =>
    httpResource<User>(() =>
      userId === undefined ? undefined : `/users/${userId}`
    )
  )
);

const userStore = new UserStore();
userStore.value(); // User | undefined