ToValue

Unwraps a MaybeSignal value. If the input is a signal, it returns the signal's value; otherwise, it returns the input as-is.

This utility is useful when you need to handle both signal and non-signal values uniformly.

Usage

import { signal } from '@angular/core';
import { toValue } from '@signality/core';

const plainValue = 42;
const signalValue = signal(42);

toValue(plainValue);  // 42
toValue(signalValue); // 42

With untracked

The untracked variant reads the signal's value without tracking it as a dependency in the current reactive context:

import { effect, signal } from '@angular/core';
import { toValue } from '@signality/core';

const count = signal(0);

effect(() => {
  // This effect tracks count
  console.log('Tracked:', toValue(count));
});

effect(() => {
  // This effect does NOT track count
  console.log('Untracked:', toValue.untracked(count)); 
});

Type Definitions

type MaybeSignal<T> = T | Signal<T>;

interface ToValueFn {
  <T>(maybeSignal: MaybeSignal<T>): T;
  untracked: <T>(maybeSignal: MaybeSignal<T>) => T;
}

Related

• ToElement — Similar utility for element references

Edit this page on GitHub Last updated: Apr 3, 2026, 22:51:46

PreviousGenerateIdNextToElement