К основному содержанию
скилл CX Codex

mocktail — скилл для Claude Code: моки и установка

Скилл помогает писать тесты на Dart и Flutter с пакетами Mocktail: настраивать моки, проверять вызовы и выбирать между моками, фейками и реальными объектами.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/mocktail/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mocktail/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Каталог скиллов SKILL.md →
find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

Из того же набора39

Весь набор →
flutter_errors Правило flutter_errors помогает разбирать типичные ошибки Flutter-разметки: от переполнения Row до неверного вызова setState во время сборки. Пригодится при поиске причин сбоя в дереве виджетов. CX Codex +1 ★ 674звёзд репо code_review Правило code_review для Claude Code задаёт порядок проверки изменений перед слиянием. Оно проверяет ветку, файлы, код, тесты и описание PR/MR. CX Codex +1 ★ 674звёзд репо flutter-errors flutter-errors — скилл для Claude Code, который помогает разбирать ошибки компоновки и выполнения Flutter. Он подключается при переполнении RenderFlex, проблемах с прокруткой и вызове setState во время сборки. CX Codex +1 ★ 674звёзд репо flutter-change-notifier Скилл flutter-change-notifier учит агента правильно использовать ChangeNotifier и provider для управления состоянием во Flutter: модель, провайдер, Consumer, оптимизация ребилдов. CX Codex +1 ★ 674звёзд репо provider Скилл учит нейросеть грамотно использовать пакет provider во Flutter: от настройки связок до точечной перерисовки UI. CX Codex +1 ★ 674звёзд репо mockito Скилл mockito для Claude Code помогает писать тесты Dart и Flutter с моками: генерировать классы, задавать ответы и проверять вызовы. Он подключается к задачам с Mockito. CX Codex +1 ★ 674звёзд репо developing-genkit-dart Скилл developing-genkit-dart для разработки AI-агентов на Genkit Dart: подсказывает агенту, когда загружать справки по ядру фреймворка и плагинам Genkit. CX Codex +1 ★ 674звёзд репо firebase-storage Скилл firebase-storage содержит инструкции по работе с Firebase Cloud Storage во Flutter: загрузке и скачиванию файлов, управлению метаданными и обработке ошибок. CX Codex +1 ★ 674звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой