Angularのuntrackedで依存を外していい場面をレビューで線引きする

untracked の実装は、現在の読み取り先(activeConsumer)を一時的に空にして関数を呼ぶだけである。

@angular/core 22.2.1 の untracked
function untracked(nonReactiveReadsFn) {
  const prevConsumer = setActiveConsumer(null);
  try {
    return nonReactiveReadsFn();
  } finally {
    setActiveConsumer(prevConsumer);
  }
}

signal を読んだときに依存を記録する producerAccessed は、読み取り先が無ければ何もせずに戻る。

@angular/core 22.2.1 の producerAccessed(抜粋)
if (activeConsumer === null) {
  return;
}
activeConsumer.consumerOnSignalRead(node);

依存の記録を止める道具としては、これで説明が終わる。レビューで見る位置は別にある。activeConsumer が空になると、signal への書き込みを禁じる検査も通るようになり、computed の中の書き込みが例外にならない。そして computed で外した依存は、別の依存が変わるまで読み直されない。

computedで外した依存の読み直し

computed の中で untracked を使うと、その signal の変更は再評価の契機にならない。税率を untracked で読む派生を作り、税率だけを変えた場合の値が次である。

@angular/core 22.2.1 / total = computed(() => price() + price() * untracked(taxRate) / 100)
初回 (price=1000, taxRate=10)   : 1100
taxRate を 8 にした直後        : 1100
price を 2000 にした後         : 2160 (8% がここで初めて反映される)

2行目は意図どおりである。3行目が、レビューで問題になる形である。computed は依存した signal が変わったときに本体を走らせ直すので、そのとき untracked の中も読み直される。つまり外した signal の新しい値は、捨てられるのではなく、別の依存が変わった瞬間に黙って混ざる。

税率のように「後から変わるが、変わったときに再計算してほしくない」値なら、この挙動は指定した側の意図と合わない。表示は古い税率のままで、利用者が価格を編集した時点で計算の前提が入れ替わる。どちらの値が使われているかは画面から判別できない。

意図が「最初に読んだ値で固定する」なら、untracked ではなく値を持つ形にする。選択を保ちつつ元が変わったら作り直す構造なら linkedSignal が当たる。この使い分けはAngularのlinkedSignalがeffectによるリセット実装を置き換える場面に整理した。

Comment
@Reviewer: この `computed` は `untracked(taxRate)` で税率を読んでいるので、税率を変えても表示は更新されず、次に `price` が変わったときに新しい税率へ入れ替わります。税率の変更を反映しないのが意図なら、計算した時点の税率を値として持たせてください(`linkedSignal` か、計算結果をまとめた1つの signal)。反映するのが意図なら `untracked` を外してください。

書き込みを禁じる検査との関係

signal への書き込みは producerUpdatesAllowed() を通る。この判定は読み取り先のフラグを見るので、読み取り先が無いときは許可になる。

@angular/core 22.2.1 の signalSetFn と producerUpdatesAllowed
function producerUpdatesAllowed() {
  return activeConsumer?.consumerAllowSignalWrites !== false;
}
function signalSetFn(node, newValue) {
  if (!producerUpdatesAllowed()) {
    throwInvalidWriteToSignalError(node);
  }
  // …
}

computed の本体は書き込みを禁じる側のフラグを持つので、そのまま書くと NG0600 になる。untracked で囲むと、同じ書き込みが通る。

computed の中で別の signal へ書き込んだ場合
untracked 無し       : RuntimeError NG0600: Writing to signals is not allowed in a `computed`
untracked で囲んだ場合: 例外にならない(log = 1 へ更新される)

untracked を「依存を外す道具」として入れた結果、禁止されていた書き込みが通るようになることがある。computed の中で untracked を使っている箇所は、中身が読み取りだけかを確かめる。

NG0600 のメッセージは ngDevMode の中で組み立てられる。本番ビルドでは番号だけが残り、computed の中の書き込みなのかテンプレートの描画中の書き込みなのかは文面から分からない。

@angular/core 22.2.1 の publishSignalConfiguration(抜粋)
setThrowInvalidWriteToSignalError(node => {
  let errorMessage = '';
  if (ngDevMode) {
    // … 'Writing to signals is not allowed while Angular renders the template (eg. interpolations)'
    // … 'Writing to signals is not allowed in a `computed`'
  }
  throw new RuntimeError(-600, errorMessage);
});

effectで外していい読み取り

effect の中では、untracked の使いどころがはっきりしている。再実行の契機にしたい signal と、値を参照したいだけの signal を分ける用途である。

effect(() => { query(); untracked(page); }) の実行回数
初回実行回数        : 1
page を変えた後     : 1
query を変えた後    : 2 (このとき page=2 が読まれる)

3行目は前節と同じ構造だが、effect では帰結が違う。effect は外側の世界へ書き出す場所であり、書き出す値がいつの時点のものかは effect が走った時点で決まる。「検索語が変わったら、そのときのページ番号で記録を送る」という仕様なら、この形がそのまま仕様の写しになる。

もう1つの用途が、自分が書く signal を読む場合である。effect が読んだ signal へ書き込むと、その書き込みが次の実行の契機になる。

effect(() => { count.set(count() + 1) }) を1回の tick で動かした場合
自分が読む signal へ書く effect : 1回の tick での実行回数 200

200 は実行回数に上限を入れて止めた数である。上限を外せば止まらない。count() を untracked(count) に変えると依存が切れ、契機になった signal の変更1回につき1度だけ走る。

ただし、この形を見たときに untracked を足すのが答えになる場面は限られる。前の値に足し込む処理は、computed か linkedSignal の計算として書けることが多い。effect の中で状態を更新する構造そのものを問うほうが先になる。effect と computed の境界はAngularのeffectを状態同期に使うコードをレビューで止めるにある。

Comment
@Reviewer: この `effect` は `total()` を読んで `total` へ書いているため、1回の変更で実行が繰り返されます。`untracked(total)` で依存を切れば止まりますが、合計の計算自体は `computed` に移せる形です。どちらにするか決めてください。

非同期のコールバックの中の読み取り

untracked が止めるのは、渡した関数が同期的に走っている間だけである。Promise のコールバックやタイマーの中は、その時点で読み取り先が元に戻っている(通常は空である)ため、依存として記録されない。

effect(() => { Promise.resolve().then(() => flag()) }) の実行回数
then の中で読んだ場合の実行回数: 1 / 読んだ値 [false]

flag を true にしても effect は再実行されず、読まれた値も最初の1回ぶんだけである。非同期のコールバックの中の読み取りを untracked で囲んでいる箇所は、何も変えていない。同じ理由で、untracked(async () => { … }) は最初の await までしか範囲に入らない。

この性質は逆向きにも働く。effect の中で await したあとに signal を読んでも、依存にならない。取得の結果が届いてから別の signal を読んで分岐する処理を effect に書くと、その signal の変更では走り直さない。意図して依存から外したのか、非同期にしたために外れたのかは差分から読み取れないので、effect の中で await を挟んでいる箇所は依存の一覧を確かめる。

フレームワーク側も同じ道具を使っている。22.1 以降の HttpInterceptorHandler は鎖の呼び出し全体を untracked で包み、effect の中で発行した通信がインターセプターの読み取りを依存として拾わないようにしている。経緯はAngularの関数型インターセプターの順序と二重実行をレビューするにまとめた。

レビューで見る順序

untracked が入っている箇所は、置かれた場所で問いが変わる。

computed の中なら、まず中身が読み取りだけかを見る。書き込みがあれば NG0600 を回避した形なので、その書き込みが要るかどうかから議論する。読み取りだけなら、外した signal が変わったときに表示を更新しない意図があるかを確かめる。意図があるなら、別の依存が変わった時点で新しい値が混ざることまで受け入れているかを聞く。

effect の中なら、依存の一覧が仕様と一致しているかを見る。再実行の契機にしたい signal だけが裸で読まれていればよい。自分が書く signal を読んでいる箇所は、untracked で止める前に computed へ移せないかを見る。

非同期のコールバックの中なら、その untracked は外せる。残っていると「ここは依存にしたくない」という読み手への合図として働くが、同じ合図はコメントで足りる。

レビュー観点チェックリスト

untracked の使いどころを確かめる項目
  • computed の中の untracked に、依存から外した理由が書かれているか
  • computed の中の untracked が読み取りだけか(書き込みを含んでいないか)
  • 含んでいる場合、NG0600 を回避する目的で入っていないか
  • 外した signal の新しい値が、別の依存が変わった時点で混ざることを受け入れているか
  • 「最初に読んだ値で固定する」意図なら、linkedSignal か値を持つ形に置き換えられないか
  • effect の中で裸で読んでいる signal が、再実行の契機にしたいものだけになっているか
  • effect が自分で書く signal を裸で読んでいないか(繰り返し実行になる)
  • その箇所が computed か linkedSignal へ移せる計算でないか
  • 非同期のコールバックの中に untracked が残っていないか(依存にならないので不要)
  • effect の中で await を挟んだ後に読んでいる signal が、依存から外れていて構わないか
  • untracked を使わずに済む構造(依存を持たない引数渡し)に直せないか

おわりに

untracked は読み取り先を空にする1行であり、依存の記録を止めると同時に、signal への書き込み検査も通す。computed の中で使っている箇所は、読み取りだけかどうかを先に確かめる。

computed で外した依存は捨てられるのではなく、別の依存が変わった時点で新しい値として混ざる。表示を固定したいなら値として持たせるか linkedSignal を使う。effect の中では、再実行の契機と参照したい値を分ける用途がはっきりしていて、自分が書く signal を読む形を止める使い方もある。ただし後者は、計算を computed へ移す判断と並べて決める。

非同期のコールバックの中の読み取りは、untracked を書かなくても依存にならない。同じ理由で、effect の中で await を挟んだ後の読み取りは依存から外れる。signal と computed の観点の全体はAngular 22のSignalと非同期状態をレビューする100観点の「computed の純粋性」と「effect」の群にある。