k6_load_test.js

import http from 'k6/http';
import { check, sleep } from 'k6';
import { Rate, Trend } from 'k6/metrics';

/**
 * متریک‌های سفارشی (Custom Metrics)
 * errorRate: درصد درخواست‌های ناموفق
 * apiDuration: مدت زمان پاسخ‌دهی API (میلی‌ثانیه)
 */
const errorRate = new Rate('errors');
const apiDuration = new Trend('api_response_time', true);

/**
 * تنظیمات تست بار (Load Test Configuration)
 * Stages: سه مرحله - افزایش بار، نگهداری، و کاهش بار
 * Thresholds: معیارهای قبول/عدم قبول تست
 */
export const options = {
  stages: [
    // مرحله 1: Ramp-up - افزایش تدریجی بار از 0 به 50 کاربر در 1 دقیقه
    { duration: '1m', target: 50 },
    // مرحله 2: Steady state - نگهداری بار در سطح 50 کاربر برای 5 دقیقه
    { duration: '5m', target: 50 },
    // مرحله 3: Ramp-down - کاهش تدریجی بار به 0 کاربر در 1 دقیقه
    { duration: '1m', target: 0 },
  ],
  thresholds: {
    // معیار کارایی: 95 درصد درخواست‌ها باید در کمتر از 2000ms پاسخ دهند
    'http_req_duration': ['p(95)<2000'],
    // معیار پایایی: نرخ خطا باید کمتر از 1 درصد (0.01) باشد
    'errors': ['rate<0.01'],
  },
  tags: {
    test_type: 'load_test',
  },
};

const BASE_URL = 'https://automationexercise.com/api';

/**
 * تابع اصلی تست (Main test function)
 * هر تکرار این تابع یک کاربر مجازی را نمایندگی می‌کند
 */
export default function () {
  // درخواست GET برای دریافت لیست محصولات
  const res = http.get(`${BASE_URL}/productsList`, {
    headers: { 'Accept': 'application/json' },
  });

  // ثبت زمان پاسخ‌دهی به متریک apiDuration
  apiDuration.add(res.timings.duration);

  // اعتبارسنجی پاسخ: بررسی کد وضعیت و محتوای پاسخ
  const isSuccessful = check(res, {
    'Status is 200': (r) => r.status === 200,
    'Response contains products': (r) => r.body.includes('products'),
  });

  // ثبت خطا اگر بررسی‌ها ناموفق باشند (errorRate متریک اپدیت می‌شود)
  errorRate.add(!isSuccessful);

  // تاخیر برای شبیه‌سازی رفتار کاربر واقعی (1 ثانیه)
  sleep(1);
}