プロパティか、引数か？――設計の迷いを断つ「確定タイミング」の法則

2026年3月2日

クラス設計において、ある値を「プロパティ（フィールド）」として保持すべきか、それとも「メソッドの引数」として渡すべきか。この選択に、明確な正解がないように思えることがあります。

しかし、ひとつの強力な判断材料があります。それは、「その値が確定するタイミング」と「メソッドが実行されるタイミング」にズレがあるかどうかです。

1. プロパティにすべきは「設定（Configuration）」

値が決まるタイミングが、メソッドを実行するよりも「前」にある場合、それはプロパティとして保持すべきです。

ケース： インスタンス化の時点で決まっている情報。
例： APIのベースURL、リトライ回数、タイムアウト秒数、出力先のパス。
マインド： そのクラスにとっての「前提条件」や「性格（設定）」です。

判断基準： 「この値は、メソッドを呼び出す『準備』としてあらかじめ知っておくべきことか？」

2. 引数にすべきは「文脈（Context / Input）」

値が決まるタイミングが、メソッドを実行する「その瞬間」である場合、それは引数として渡すべきです。

ケース： 実行するたびに中身が変わり得る情報。
例：検索キーワード、保存対象のデータ、計算の元になる数値。
マインド： そのメソッドにとっての「材料」や「今回のリクエスト」です。

判断基準： 「この値は、メソッドを動かす『その時』にならないと分からないことか？」

3. 「タイミングの不一致」が生むアンチパターン

もし、タイミングが「同時」なのにプロパティを使おうとすると、設計が壊れ始めます。

避けるべき「一時的なプロパティ保持」

メソッドを呼ぶ直前にだけプロパティを書き換え、実行後にその値を放置するパターンです。TypeScript

// 悪い例：タイミングが同時なのにプロパティを使っている
class Searcher {
  private keyword: string = "";

  setKeyword(k: string) { this.keyword = k; }

  execute() {
    // this.keyword を使って検索。実行が終わっても残ってしまう。
  }
}