mock_api_assets: Mock Backend for Dart & Flutter

ملخص

Pixel shares an overview of mock_api_assets, a JSON fixture-based mock backend for Dart and Flutter that keeps apps using real HTTP clients while the API is unavailable. It covers route matching, templated fixtures, simulated latency and errors, stateful CRUD, pagination, switchable scenarios, and Dio and package:http adapters—helping developers test loading, error, and create-to-list flows earlier.

DEV Community

mock_api_assets: backend وهمي من ملفات JSON لتطبيقات Dart و Flutter

العمل على الواجهة يبدأ غالبًا قبل أن يجهز الـ backend. الـ API ما يزال قيد التصميم، أو موجود لكنك في القطار، أو عليك عرض التطبيق ولا تستطيع الاعتماد على خادم. الجواب المعتاد بضع قوائم مكتوبة مباشرة في الكود هنا وهناك، ثم يجب العثور عليها وحذفها لاحقًا. الـ backend الوهمي جواب أنظف: التطبيق يواصل إرسال طلبات HTTP حقيقية عبر الـ client الحقيقي، وشيء ما يجيب عنها من ملفات JSON محلية. لكن الوهمي الجيد يجب أن يفعل أكثر من إرجاع ملف. الـ APIs الحقيقية بطيئة، وتفشل، وتتذكر ما أرسلته لها. وإن لم يفعل الوهمي شيئًا من ذلك، فحالات التحميل وشاشات الخطأ ومسارات «أنشئ ثم اعرض القائمة» لا تُجرَّب أبدًا. mock_api_assets هي backend وهمي مصنوع من ملفات JSON جاهزة (fixtures). فيها مطابقة للمسارات (routes)، و fixtures بقوالب، وتأخير محاكى (latency)، وحقن أخطاء، ومخزن CRUD يحتفظ بالحالة، وسيناريوهات قابلة للتبديل، ومحوّلات (adapters) لـ Dio و package:http. ماذا تقدّم Router. MockRouter يطابق على الـ method ونمط المسار. :id يلتقط مقطعًا واحدًا، و يطابق مقطعًا واحدًا، و* (في المقطع الأخير فقط) يطابق بقية المسار. قيود الـ query string اختيارية. أول تطابق يفوز، وpriority: يقدّم route على routes مسجّلة قبله. الشرطة المائلة في النهاية تُتجاهل، ويمكن نزع basePath مثل /api/v1 قبل المطابقة. Handlers. MockHandler.fixture(path) يقدّم ملف fixture. MockHandler.json(value) يقدّم قيمة JSON مباشرة. MockHandler.callback(...) يستقبل معاملات المسار والـ query والـ headers والـ body بعد تحليله، ويُرجع ردًّا. وMockHandler.paginated(...) وMockHandler.paginatedList(...) يقطّعان قائمة حسب page وlimit. القوالب. العناصر النائبة في الـ fixtures وفي JSON المباشر تُملأ من الطلب: {{params.id}} و{{query.q}} و{{headers.x-token}} و{{body.items.0.sku}} و{{method}} و{{path}} و{{now}}. النص الذي هو عنصر نائب واحد بالضبط يحتفظ بنوع القيمة، والفلاتر | int و| num و| bool تحوّله. محمِّلات fixtures قابلة للاستبدال. MapFixtureLoader يحتفظ بالـ fixtures في الذاكرة. CallbackFixtureLoader ينادي دالة تعطيها له، مثل rootBundle.loadString في Flutter. وFileFixtureLoader يقرأ من القرص وموجود في package:mock_api_assets/io.dart. التأخير. MockLatency.fixed أو .uniform أو .normal. القيم العشوائية تأتي من Random قابل للحقن، ودالة التأخير قابلة للحقن أيضًا، فتستطيع الاختبارات العمل على ساعة وهمية. حقن الأخطاء. نسبة فشل عامة، وأخطاء لـ routes محددة مع عدد مرات اختياري، و«أفشِل الطلبات الـ N القادمة». الأخطاء إما حالات HTTP أو أخطاء شبكة: timeout، connection refused، connection reset و host lookup. CRUD بحالة. router.resource('/todos', seed: [...]) يسجّل routes للقائمة والإنشاء والقراءة والاستبدال والتحديث والحذف فوق مجموعة في الذاكرة. POST ثم GET يُرجع ما أُرسل. وrouter.store.reset() يستعيد البيانات الأولية. السيناريوهات. مجموعات مسمّاة من التجاوزات تبدّلها وقت التشغيل: تجاوز routes، تأخير، خطأ لكل طلب، أو نسبة فشل. مثل "empty-state" و"server-down" و"slow-3g". ويمكن تفعيل عدة سيناريوهات معًا. سجل الطلبات. تحقق عبر router.calls وrouter.callsTo('POST', '/todos') وrouter.wasCalled(...). ردود 404 مفيدة. الطلب الذي لا يطابق شيئًا يحصل على 404 بجسم JSON يسرد أقرب الـ routes المسجّلة. المحوّلات. MockDioAdapter من package:mock_api_assets/dio.dart وMockHttpClient من package:mock_api_assets/http.dart. والمكتبة الأساسية لا تستورد أيًّا منهما. طريقة الاستعمال أضِفها من GitHub: dependencies:
mock_api_assets:
git: https://github.com/AbdeldjalilChougui/mock_api_assets
مع Dio: import 'package:dio/dio.dart';
import 'package:mock_api_assets/dio.dart';
import 'package:mock_api_assets/mock_api_assets.dart';

Future main() async {
final router = MockRouter(
loader: MapFixtureLoader({
'users/detail.json': {'id': '{{params.id | int}}', 'name': 'User'},
}),
latency: const MockLatency.uniform(
Duration(milliseconds: 200),
Duration(milliseconds: 800),
),
)
..get('/users/:id', MockHandler.fixture('users/detail.json'))
..get('/orders/queue', MockHandler.json([]), priority: 10)
..get('/orders/:id', MockHandler.callback((req) {
return MockResponse.json({'id': req.pathParams['id'], 'q': req.query});
}))
..resource('/todos', seed: [
{'id': 1, 'tit...
mock_api_assets: Mock Backend for Dart & Flutter
Powered by Readybot.io

الأحدث من Pixel

Incident Response: Look Beyond the Red Alert

Pixel’s DEV Community announcement explores how teams can fixate on one failing service while overlooking the real cause of an outage, such as a full …

Sach: AI Fact-Checks WhatsApp Forwards in India

Pixel’s announcement introduces Sach, a tool that checks forwarded messages in English, Hindi, Telugu, and 14 other Indian languages against official sources. It gives cited …

Java 25 Removes SecurityManager: What to Fix

Pixel’s announcement explains how Java 24’s JEP 486 permanently disabled the SecurityManager, breaking test workarounds that intercept System.exit. It recommends returning exit codes or throwing …

Why a Java HPA Got Stuck at 20 Kubernetes Pods

Pixel shares how a Spring Boot pricing service autoscaled to 20 Kubernetes pods and stayed there because the JVM retained committed heap memory after traffic …