printデバッグを理解して、使いこなす

// ❌ こんなコードになっていませんか？
function processUser(userData) {
  console.log('1. 関数開始:', userData);
  
  const user = parseUserData(userData);
  console.log('2. パース後:', user);
  
  if (user.age < 18) {
    console.log('3. 未成年判定');
    return null;
  }
  
  console.log('4. 成人判定通過');
  const processed = processAdult(user);
  console.log('5. 処理後:', processed);
  
  console.log('6. 関数終了');
  return processed;
}

# ❌ あちこちにprint文を追加
def calculate_price(items):
    print(f"アイテム数: {len(items)}")  # ここ
    
    total = 0
    for item in items:
        print(f"アイテム: {item}")  # ここも
        price = get_item_price(item)
        print(f"価格: {price}")  # ここも
        total += price
        print(f"現在の合計: {total}")  # ここも
    
    discount = calculate_discount(total)
    print(f"割引: {discount}")  # ここも
    
    final_price = total - discount
    print(f"最終価格: {final_price}")  # ここも
    return final_price

// ❌ 本番環境で実行されてしまう
async function loginUser(email, password) {
  console.log('ログイン試行:', email, password); // セキュリティリスク！
  
  const user = await findUser(email);
  console.log('ユーザー情報:', user); // 個人情報の漏洩！
  
  if (validatePassword(password, user.hashedPassword)) {
    console.log('認証成功'); // 不要な出力
    return generateToken(user);
  }
  
  throw new Error('認証失敗');
}

// ✅ 適切なprintデバッグの使用例
async function fetchUserData(userId) {
  const response = await fetch(`/api/users/${userId}`);
  const userData = await response.json();
  
  // APIレスポンスの構造を確認
  console.log('APIレスポンス:', userData);
  
  return userData;
}

# ✅ 処理フローの確認
def process_order(order):
    print(f"注文処理開始: {order.id}")
    
    if order.status == 'pending':
        print("→ 保留中の注文を処理")
        return process_pending_order(order)
    elif order.status == 'confirmed':
        print("→ 確定済み注文を処理")
        return process_confirmed_order(order)
    else:
        print(f"→ 未知のステータス: {order.status}")
        raise ValueError("Invalid order status")

// ✅ 学習段階での活用
function learnArrayMethods() {
  const numbers = [1, 2, 3, 4, 5];
  
  // mapの動作を理解
  const doubled = numbers.map(n => {
    console.log(`${n} を2倍すると ${n * 2}`);
    return n * 2;
  });
  
  console.log('結果:', doubled);
}

// ❌ printデバッグでは非効率
function calculateShippingFee(order) {
  if (order.weight > 10) {
    if (order.destination === 'overseas') {
      if (order.express) {
        // この条件にたどり着くまでprint文だらけに...
        return 5000;
      }
      return 3000;
    }
    return 1000;
  }
  return 500;
}

// ✅ デバッガーでブレークポイントを設定して
// 条件分岐を一つずつ確認する方が効率的

// ❌ printデバッグでは限界がある
function slowFunction(data) {
  console.time('処理時間'); // 基本的な計測はできるが...
  
  // 複雑な処理
  const result = heavyComputation(data);
  
  console.timeEnd('処理時間'); // 詳細な分析はできない
  return result;
}

// ✅ Chrome DevToolsのPerformanceタブや
// Node.jsのプロファイラーを使用する

// ❌ printデバッグでは再現が困難
async function concurrentProcessing() {
  console.log('処理1開始');
  const result1 = processData1();
  
  console.log('処理2開始');
  const result2 = processData2();
  
  // この間の競合状態はprintでは捉えられない
  console.log('結果結合');
  return combineResults(result1, result2);
}

// ✅ 非同期デバッグに対応したツールや
// Promise.allSettledなどの適切な制御が必要

// ❌ printデバッグでは発見不可能
function createMemoryLeak() {
  const data = new Array(1000000).fill('data');
  
  // 循環参照の作成
  data.self = data;
  
  console.log('データ作成完了'); // これだけでは問題に気づけない
  return data;
}

// ✅ Chrome DevToolsのMemoryタブで
// ヒープスナップショットを比較する

// ❌ 個人的なprintデバッグでは共有困難
function problematicFunction(input) {
  console.log('入力:', input); // 他の人には見えない
  
  // 複雑な処理...
  
  console.log('結果:', result); // 環境依存で再現しない
}

// ✅ ログ収集システムや
// リモートデバッグツールを使用する

// ✅ 構造化されたログ出力
function debugLog(level, message, data = null) {
  const logEntry = {
    timestamp: new Date().toISOString(),
    level: level,
    message: message,
    data: data,
    stack: new Error().stack.split('\n')[2] // 呼び出し元の情報
  };
  
  console.log(JSON.stringify(logEntry, null, 2));
}

// 使用例
function processPayment(amount, currency) {
  debugLog('INFO', 'Payment processing started', { amount, currency });
  
  try {
    const result = chargeCard(amount, currency);
    debugLog('SUCCESS', 'Payment completed', result);
    return result;
  } catch (error) {
    debugLog('ERROR', 'Payment failed', { error: error.message });
    throw error;
  }
}

// ✅ 環境変数での制御
const DEBUG = process.env.NODE_ENV === 'development' || process.env.DEBUG === 'true';

function debug(message, data = null) {
  if (!DEBUG) return;
  
  console.log(`[DEBUG] ${message}`, data ? data : '');
}

// 使用例
function apiCall(endpoint, params) {
  debug('API call started', { endpoint, params });
  
  return fetch(endpoint, {
    method: 'POST',
    body: JSON.stringify(params)
  })
  .then(response => {
    debug('API response received', { status: response.status });
    return response.json();
  })
  .catch(error => {
    debug('API call failed', { error: error.message });
    throw error;
  });
}

// ✅ デバッグヘルパー関数
class DebugHelper {
  static traceFunction(fn, fnName) {
    return function(...args) {
      console.log(`🟢 ${fnName} 開始:`, args);
      
      try {
        const result = fn.apply(this, args);
        
        if (result instanceof Promise) {
          return result
            .then(data => {
              console.log(`✅ ${fnName} 成功:`, data);
              return data;
            })
            .catch(error => {
              console.log(`❌ ${fnName} エラー:`, error.message);
              throw error;
            });
        } else {
          console.log(`✅ ${fnName} 完了:`, result);
          return result;
        }
      } catch (error) {
        console.log(`❌ ${fnName} エラー:`, error.message);
        throw error;
      }
    };
  }
  
  static inspectObject(obj, label = 'Object') {
    console.group(`🔍 ${label}`);
    console.table(obj);
    console.log('Type:', typeof obj);
    console.log('Constructor:', obj.constructor.name);
    console.groupEnd();
  }
}

// 使用例
const calculateTotal = DebugHelper.traceFunction(
  function(items) {
    return items.reduce((sum, item) => sum + item.price, 0);
  },
  'calculateTotal'
);

const items = [{ price: 100 }, { price: 200 }];
DebugHelper.inspectObject(items, 'Shopping Items');
const total = calculateTotal(items);

// .vscode/launch.json の設定例
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Node.js Debug",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/src/index.js",
      "console": "integratedTerminal",
      "env": {
        "NODE_ENV": "development"
      }
    }
  ]
}