【一発で理解】スタブとは？“テスト用の仮データ”の正体をわかりやすく解説

スタブとは？一発でわかる意味

スタブとは、テスト用に用意する仮の処理や仮のデータを指します。外部システムの代わりに動作する簡易的な部品です。

システム開発では、すべての機能が完成する前にテストを行います。未完成の機能がある状態では通常の処理が動きません。スタブを使うことで未完成の部分を仮の処理で補い、開発途中でもテストが可能になります。

スタブの語源と由来

stubは英語で「切り株」「半券」を意味する単語です。映画の半券（チケットスタブ）のように、本体の代わりとなる控え・代用品というニュアンスがあります。IT分野でもこの意味が転用され、「本物の処理の代わりに使う仮の部品」としてスタブという名称が定着しました。

なぜスタブが必要なのか──依存を切り離すため

スタブが必要な理由は、依存関係を排除するためです。

システムは複数の機能が連携して動作します。外部APIやデータベースに依存するケースも多く、依存が残ったままではテストが不安定になります。通信エラーや環境差異によって結果が変わるためです。

スタブを使うと依存を完全に切り離せます。安定した環境でテストを実行でき、バグの原因特定も容易になります。

スタブの仕組みを図解で理解する

スタブは概念だけでは理解しにくい技術です。「あり」と「なし」の比較で流れを見ると一気に理解が深まります。

スタブがない場合──テストが止まる

外部APIが未完成または不安定な状態では、データ取得ができずに機能全体のテストが停止します。開発が進まない原因になります。

スタブがある場合──テストが安定する

APIの代わりにスタブが固定データを返すため、外部通信がなくても処理が成立します。テストが止まらなくなります。

本物の処理とスタブの違い

本物の処理は複雑なロジックを含みます。一方でスタブは結果だけを返す簡易的な仕組みです。目的が異なるため、精度より安定性が重視されます。

スタブとモックの違い【最重要】

スタブとモックは混同されやすい用語ですが、役割が明確に異なります。

• スタブ：値を返す（返すことが目的）
• モック：呼び出しを検証する（確認することが目的）

正しく使い分けることで、テストの精度が大きく向上します。

比較表でわかるスタブとモックの違い

どちらを使うべきか──使い分けの基準

使い分けは次の基準で判断します。

• 結果だけ確認したい場合 → スタブを使う
• 呼び出しの正しさを確認したい場合 → モックを使う

たとえば、計算結果の数値が正しいかを確認するテストにはスタブが適しています。一方で「メール送信関数が正しく呼ばれたか」を確認する場合にはモックを使います。目的を明確にすると選択に迷いません。

スタブの具体例（コード付き）

スタブは具体例で見ると一気に理解できます。実際の開発でよく使われる2つのパターンを紹介します。

例1：APIをスタブ化するケース

外部APIを利用する処理を想定します。通常はAPIにリクエストを送りデータを取得しますが、APIが不安定な場合はテストが失敗します。スタブを使えば通信を行わず固定データを返せるため、テストが安定します。

# 本来の処理（外部APIに接続）
def get_weather(city):
    response = requests.get(f"https://api.example.com/weather/{city}")
    return response.json()

# スタブ（固定データを返す）
def get_weather_stub(city):
    return {"city": city, "temp": 20, "condition": "晴れ"}

// 本来の処理（外部APIに接続）
async function getWeather(city) {
  const res = await fetch(`https://api.example.com/weather/${city}`);
  return res.json();
}

// スタブ（固定データを返す）
function getWeatherStub(city) {
  return { city, temp: 20, condition: "晴れ" };
}

例2：データベースをスタブ化するケース

データベースに依存する処理も同様です。通常はデータの読み書きで動作しますが、環境によって結果が変わるリスクがあります。スタブを使えば決まったデータを返せるため、環境差を完全に排除できます。

# 本来の処理（DBに接続）
def get_user(user_id):
    return db.query(f"SELECT * FROM users WHERE id = {user_id}")

# スタブ（固定データを返す）
def get_user_stub(user_id):
    return {"id": user_id, "name": "テストユーザー", "role": "admin"}

# テストコード
def test_greet():
    user = get_user_stub(1)
    result = f"こんにちは、{user['name']}さん"
    assert result == "こんにちは、テストユーザーさん"

// 本来の処理（DBに接続）
async function getUser(userId) {
  return await db.query("SELECT * FROM users WHERE id = ?", [userId]);
}

// スタブ（固定データを返す）
function getUserStub(userId) {
  return { id: userId, name: "テストユーザー", role: "admin" };
}

// テストコード
function testGreet() {
  const user = getUserStub(1);
  const result = `こんにちは、${user.name}さん`;
  console.assert(result === "こんにちは、テストユーザーさん");
}

スタブを使うメリット・デメリット

スタブは便利な技術ですが、注意点も存在します。メリットとデメリットの両面を理解しておく必要があります。

スタブが使われるシーン

スタブは多くの開発現場で活用されています。代表的な3つのシーンを押さえておきましょう。

単体テスト（ユニットテスト）

スタブは単体テストで最も頻繁に使われます。単体テストは機能単位で動作を確認する工程であり、外部依存を排除する必要があります。スタブを使うことで対象機能だけを検証でき、余計な影響を受けずにテストできます。

外部API連携のテスト

API連携は不安定になりやすい領域です。通信エラーやレスポンス遅延が発生するため、安定したテストが難しくなります。スタブを使えば通信を省略でき、常に同じ結果を返すため検証が容易になります。

開発初期の仮実装

開発初期では機能が揃っていません。未完成の部分が多く動作確認が難しい状態です。スタブを使うことで仮の処理を用意し、開発を止めずに進行できます。

スタブを使うべきか迷ったときの判断基準

スタブの利用は判断基準を持つと迷いません。以下のポイントを確認してください。

外部依存があるかどうか

外部依存がある場合はスタブが有効です。APIやデータベースが対象になります。依存を切ることでテストが安定します。

テストの目的は「結果」か「挙動」か

結果の正しさを確認する場合はスタブが適しています。挙動の確認が目的ならモックを使います。

チェックリスト：スタブ vs モック

よくある誤解とNGパターン

スタブは誤解されやすい技術です。間違った使い方は品質低下につながります。

スタブに関するよくある質問（FAQ）

まとめ｜スタブは「テストを成立させるための土台」

スタブは開発効率を大きく向上させる技術です。

正しく理解することでテスト設計の質が上がります。まずは小さな機能からスタブを導入してください。実践を通じて理解が深まります。

より高度なテスト設計を学びたい場合は、モックやフェイクの理解も進めていきましょう。