mocktail — скилл для Claude Code: моки и установка
Скилл помогает писать тесты на Dart и Flutter с пакетами Mocktail: настраивать моки, проверять вызовы и выбирать между моками, фейками и реальными объектами.
MIT ★ 674 обновлён 2026-10-29
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rulesЧто делает mocktail
Скилл объясняет, когда оставить реальный объект, когда сделать лёгкий фейк, а когда нужен мок для проверки аргументов или числа вызовов. Он также показывает, как задавать ответы и ошибки, перехватывать аргументы и проверять, вызывался ли метод. Для асинхронных методов используются thenAnswer.
В инструкциях есть примеры классов на базе Mock и Fake, настройки when и проверок verify. Для пользовательских типов, передаваемых через any(), captureAny() или captureThat(), нужно заранее зарегистрировать fallback-значение. Если не проверяете взаимодействия, мок здесь не подходит: используйте реальный объект или фейк.
Какие задачи решает
- выбрать между мок-объектом, фейком и реальной реализацией
- настроить ответ или ошибку для вызова метода
- проверить число вызовов и переданные аргументы
- перехватить аргументы метода для последующих проверок
- зарегистрировать fallback-значения для пользовательских типов
Примеры запросов агенту
- Помоги написать тест на Dart с Mocktail и проверь, сколько раз вызывается
fetchData. - Настрой мок для асинхронного метода
fetchDataи верни тестовый результат. - Покажи, как перехватить аргумент
processи проверить его значение.
Как установить mocktail
1Через маркетплейс плагинов
/plugin marketplace add evanca/flutter-ai-rules/plugin install flutter-ai-skills@flutter-ai-rulesКоманда ставит плагин flutter-ai-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill mocktail -a claude-code3Вручную: положить файлы
~/.claude/skills/mocktail/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mocktail/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill mocktail -a codex2Вручную: положить файлы
.agents/skills/mocktail/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill mocktail -a cursor2Вручную: положить файлы
.cursor/skills/mocktail/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install evanca/flutter-ai-rules skills/mocktail2Вручную: положить файлы
.github/skills/mocktail/SKILL.md1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill mocktail -a gemini-cli2Командой платформы
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/mocktailВручную: положить файлы
.devin/skills/mocktail/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mocktail
Как установить mocktail в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add evanca/flutter-ai-rules, затем установите скилл командой /plugin install flutter-ai-skills@flutter-ai-rules.
Что делает скилл mocktail?
Он помогает настраивать моки и заглушки в тестах Dart и Flutter, проверять взаимодействия и выбирать между моками, фейками и реальными объектами.
Когда нужно регистрировать fallback-значение в Mocktail?
До использования пользовательского типа с any(), captureAny() или captureThat(). Регистрацию можно поместить в setUpAll или в начало теста.
Исходный текст
SKILL.md · MIT
---
name: mocktail
description: "Use when creating mocks, stubbing methods, verifying interactions, registering fallback values, or choosing between mocks, fakes, and real objects (Mocktail)."
license: MIT
---
# Mocktail Skill
This skill defines how to correctly use the `mocktail` package for mocking in Dart and Flutter tests.
---
## 1. Mock vs. Fake vs. Real Object
| Use | When |
|---|---|
| **Real object** | Prefer over mocks when practical. |
| **Fake** (`extends Fake`) | Lightweight custom implementation; override only the methods you need. Prefer over mocks when you don't need interaction verification. |
| **Mock** (`extends Mock`) | Only when you need to **verify interactions** (call counts, arguments) or stub dynamic responses. |
- Never add `@override` methods or implementations to a class extending `Mock`.
- Only use mocks if your test has `verify` assertions; otherwise prefer real or fake objects.
---
## 2. Creating Mocks
```dart
class MockMyService extends Mock implements MyService {}
class FakeMyEvent extends Fake implements MyEvent {}
```
No code generation required — unlike Mockito, Mocktail uses `noSuchMethod` at runtime.
---
## 3. Registering Fallback Values
Register fallback values **before** using custom types with argument matchers. Do this in `setUpAll` or at the top of your test:
```dart
setUpAll(() {
registerFallbackValue(FakeMyEvent());
});
```
- Required for non-nullable custom types used with `any()`, `captureAny()`, or `captureThat()`.
- Register fallback values for **any** custom type used with argument matchers.
---
## 4. Stubbing
```dart
final mock = MockMyService();
// Return a value
when(() => mock.fetchData()).thenReturn('result');
// Throw an error
when(() => mock.fetchData()).thenThrow(Exception('error'));
// Dynamic/async response
when(() => mock.fetchData()).thenAnswer((_) async => 'result');
// Future<void>
when(() => mock.doWork()).thenAnswer((_) async {});
```
- Always stub async methods (returning `Future` or `Future<void>`) with `thenAnswer`.
- Stub every method you expect to be called, even if it's not the focus of your test.
---
## 5. Named Parameters
Always include **all named parameters** in both `when` and `verify` calls. Use `any(named: 'paramName')` for those you don't care about:
```dart
when(() => mock.fetch(
id: any(named: 'id'),
headers: any(named: 'headers'),
)).thenReturn(response);
```
- If a method has default values for named parameters, Mocktail still expects them all to be matched.
---
## 6. Verification
```dart
verify(() => mock.fetchData()); // called at least once
verifyNever(() => mock.fetchData()); // never called
verify(() => mock.fetchData()).called(2); // called exactly twice
```
---
## 7. Argument Matchers
```dart
// Any positional argument
when(() => mock.process(any())).thenReturn(true);
// Capture arguments for later assertions
final captured = verify(() => mock.process(captureAny())).captured;
print(captured.last);
```
- Use `any()` for positional parameters when you don't care about the exact value.
- Use `captureThat()` for conditional capturing.
- When matching string output, be aware of what `.toString()` returns for the type.
---
## References
- [Mocktail GitHub Repository](https://github.com/felangel/mocktail)
© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules