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

n8n-trigger-testing-strategies — скилл для Claude Code

Скилл n8n-trigger-testing-strategies для Claude Code тестирует триггеры n8n: вебхуки, cron-расписания, события и опрос. Помогает выяснить, почему воркфлоу срабатывает не тогда, когда ожидается.

MIT 128 установок ★ 533 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add proffesor-for-testing/agentic-qe --skill n8n-trigger-testing-strategies -a claude-code
Открыть на GitHub

Что делает n8n-trigger-testing-strategies

Скилл разбирает, как воркфлоу n8n получает запуск: вебхук, расписание, событие сервиса или опрос источника. Внутри есть карточка-шпаргалка по типам триггеров и настройкам вебхука, готовые TypeScript-функции для прогонов и субагент n8n-trigger-test, который проходит чек-лист от распознавания типа до замера времени ответа.

Прогоны покрывают то, на чём триггеры обычно и ломаются. Вебхук получает пустой объект, крупный JSON, глубоко вложенную структуру и строку со спецсимволами; отдельно проверяются HTTP-методы и сценарии авторизации. Для расписаний есть валидатор cron-выражения: он сверяет поля с диапазонами (минуты 0–59, часы 0–23, день месяца 1–31, месяц 1–12, день недели 0–7) и показывает ближайшие запуски.

Для проверки авторизации нужны два токена: рабочий и просроченный. С одним тест не покажет, что вебхук действительно отсекает старую сессию. Валидатор cron ждёт от пяти до шести полей, четырёхчастное выражение вернётся ошибкой.

Какие задачи решает

  • прогнать вебхук пустым, крупным и вложенным payload
  • выяснить, какие HTTP-методы вебхук принимает, а на какие отвечает 405
  • проверить, что запрос без токена и с просроченным токеном отклоняется
  • сверить cron-выражение с диапазонами полей и увидеть ближайшие запуски
  • замерить время ответа триггера на разных входах

Примеры запросов агенту

  • Протестируй вебхук моего воркфлоу n8n: пустой payload, большой JSON и глубоко вложенный объект.
  • Проверь, что вебхук не пускает без заголовка Authorization и с просроченным токеном.
  • Разбери cron-выражение */5 * * * * и покажи ближайшие пять запусков.

Как установить n8n-trigger-testing-strategies

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill n8n-trigger-testing-strategies -a claude-code

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

~/.claude/skills/n8n-trigger-testing-strategies/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/n8n-trigger-testing-strategies/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о n8n-trigger-testing-strategies

Как установить n8n-trigger-testing-strategies в Claude Code?

Выполните npx skills add proffesor-for-testing/agentic-qe --skill n8n-trigger-testing-strategies -a claude-code. Файл скилла окажется по пути ~/.claude/skills/n8n-trigger-testing-strategies/SKILL.md.

Что делает n8n-trigger-testing-strategies?

Даёт агенту готовые приёмы проверки триггеров n8n: payload для вебхука, перебор HTTP-методов, сценарии авторизации, валидацию полей cron и замер времени ответа.

Нужен ли запущенный n8n, чтобы этим пользоваться?

Хелперы для вебхука шлют запросы по адресу, который вы им дадите, поэтому воркфлоу должен быть доступен. Для сценариев авторизации понадобятся рабочий токен и просроченный.

Исходный текст

SKILL.md · MIT
---
name: n8n-trigger-testing-strategies
description: "Webhook testing, schedule validation, event-driven triggers, and polling mechanism testing for n8n workflows. Use when testing how workflows are triggered."
category: n8n-testing
priority: high
tokenEstimate: 1000
agents: [n8n-trigger-test]
implementation_status: production
optimization_version: 1.0
last_optimized: 2025-12-15
dependencies: []
quick_reference_card: true
tags: [n8n, triggers, webhook, schedule, cron, polling, testing]
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/n8n-trigger-testing-strategies.yaml
---

# n8n Trigger Testing Strategies

<default_to_action>
When testing n8n triggers:
1. IDENTIFY trigger type (webhook, schedule, polling, event)
2. TEST with various valid payloads
3. VERIFY authentication and authorization
4. CHECK error handling for invalid inputs
5. MEASURE response time and reliability

**Quick Trigger Checklist:**
- Trigger activates workflow correctly
- Payload parsed and validated
- Authentication enforced (if configured)
- Error responses are informative
- Response time is acceptable

**Critical Success Factors:**
- Test edge cases (empty payloads, large payloads)
- Verify idempotency where needed
- Check timeout handling
- Monitor for missed triggers
</default_to_action>

## Quick Reference Card

### n8n Trigger Types

| Type | Use Case | Testing Focus |
|------|----------|---------------|
| **Webhook** | External HTTP calls | Payloads, auth, methods |
| **Schedule** | Timed execution | Cron accuracy, timezone |
| **Polling** | Check for changes | Interval, deduplication |
| **Event** | Service events | Event handling, filtering |

### Common Webhook Configurations

| Setting | Options | Impact |
|---------|---------|--------|
| HTTP Method | GET, POST, PUT, DELETE | Request handling |
| Authentication | None, Basic, Header | Security |
| Response Mode | Immediately, Last Node, Custom | Response timing |
| Path | Custom URL path | Endpoint identification |

---

## Webhook Testing

### Basic Webhook Test

```typescript
// Test webhook with various payloads
async function testWebhook(webhookUrl: string): Promise<WebhookTestResult> {
  const testPayloads = [
    // Valid JSON
    { type: 'json', data: { event: 'test', timestamp: Date.now() } },
    // Empty object
    { type: 'empty', data: {} },
    // Large payload
    { type: 'large', data: { items: Array(1000).fill({ id: 1, name: 'test' }) } },
    // Nested data
    { type: 'nested', data: { level1: { level2: { level3: { value: 'deep' } } } } },
    // Special characters
    { type: 'special', data: { text: 'Hello <script>alert("xss")</script>' } }
  ];

  const results: PayloadTestResult[] = [];

  for (const payload of testPayloads) {
    const startTime = Date.now();

    try {
      const response = await fetch(webhookUrl, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(payload.data)
      });

      results.push({
        payloadType: payload.type,
        success: response.ok,
        status: response.status,
        responseTime: Date.now() - startTime,
        responseBody: await response.text()
      });
    } catch (error) {
      results.push({
        payloadType: payload.type,
        success: false,
        error: error.message
      });
    }
  }

  return { webhookUrl, results };
}
```

### HTTP Method Testing

```typescript
// Test all HTTP methods
async function testWebhookMethods(webhookUrl: string): Promise<MethodTestResult[]> {
  const methods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'];
  const results: MethodTestResult[] = [];

  for (const method of methods) {
    try {
      const response = await fetch(webhookUrl, {
        method,
        headers: { 'Content-Type': 'application/json' },
        body: ['GET', 'HEAD', 'OPTIONS'].includes(method) ? undefined : '{}'
      });

      results.push({
        method,
        allowed: response.ok || response.status !== 405,
        status: response.status,
        statusText: response.statusText
      });
    } catch (error) {
      results.push({
        method,
        allowed: false,
        error: error.message
      });
    }
  }

  return results;
}
```

### Authentication Testing

```typescript
// Test webhook authentication
async function testWebhookAuth(webhookUrl: string, authConfig: AuthConfig): Promise<AuthTestResult> {
  const scenarios = [
    // No auth
    { name: 'no-auth', headers: {} },
    // Invalid auth
    { name: 'invalid-auth', headers: { 'Authorization': 'Bearer invalid-token' } },
    // Valid auth
    { name: 'valid-auth', headers: { 'Authorization': `Bearer ${authConfig.token}` } },
    // Expired auth
    { name: 'expired-auth', headers: { 'Authorization': `Bearer ${authConfig.expiredToken}` } }
  ];

  const results: AuthScenarioResult[] = [];

  for (const scenario of scenarios) {
    const response = await fetch(webhookUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        ...scenario.headers
      },
      body: '{}'
    });

    results.push({
      scenario: scenario.name,
      status: response.status,
      authenticated: response.ok,
      errorMessage: response.ok ? null : await response.text()
    });
  }

  return {
    authRequired: !results.find(r => r.scenario === 'no-auth')?.authenticated,
    invalidRejected: !results.find(r => r.scenario === 'invalid-auth')?.authenticated,
    validAccepted: results.find(r => r.scenario === 'valid-auth')?.authenticated,
    results
  };
}
```

---

## Schedule Testing

### Cron Expression Validation

```typescript
// Validate cron expression
function validateCronExpression(expression: string): CronValidationResult {
  const parts = expression.trim().split(/\s+/);

  if (parts.length < 5 || parts.length > 6) {
    return {
      valid: false,
      error: `Expected 5-6 parts, got ${parts.length}`
    };
  }

  const [minute, hour, dayOfMonth, month, dayOfWeek, year] = parts;

  const validations = [
    { field: 'minute', value: minute, range: [0, 59] },
    { field: 'hour', value: hour, range: [0, 23] },
    { field: 'dayOfMonth', value: dayOfMonth, range: [1, 31] },
    { field: 'month', value: month, range: [1, 12] },
    { field: 'dayOfWeek', value: dayOfWeek, range: [0, 7] }
  ];

  for (const v of validations) {
    const result = validateCronField(v.value, v.range);
    if (!result.valid) {
      return { valid: false, error: `Invalid ${v.field}: ${result.error}` };
    }
  }

  return {
    valid: true,
    description: describeCronExpression(expression),
    nextExecutions: getNextCronExecutions(expression, 5)
  };
}

// Get human-readable description
function describeCronExpression(expression: string): string {
  // Common patterns
  const patterns: Record<string, string> = {
    '* * * * *': 'Every minute',
    '*/5 * * * *': 'Every 5 minutes',
    '0 * * * *': 'Every hour',
    '0 0 * * *': 'Every day at midnight',
    '0 9 * * 1-5': 'Weekdays at 9:00 AM',
    '0 0 1 * *': 'First day of every month',
    '0 0 * * 0': 'Every Sunday at midnight'
  };

  return patterns[expression] || 'Custom schedule';
}

// Calculate next execution times
function getNextCronExecutions(expression: string, count: number): Date[] {
  const executions: Date[] = [];
  let current = new Date();

  // Simple implementation - use cron-parser library in production
  for (let i = 0; i < count; i++) {
    const next = calculateNextCronExecution(expression, current);
    executions.push(next);
    current = new Date(next.getTime() + 60000); // Move past this execution
  }

  return executions;
}
```

### Schedule Reliability Testing

```typescript
// Test schedule trigger reliability
async function testScheduleReliability(triggerId: string, testDuration: number): Promise<ScheduleTestResult> {
  const startTime = Date.now();
  const expectedExecutions: Date[] = [];
  const actualExecutions: Date[] = [];

  // Calculate expected execution times
  const cronExpression = await getTriggerCronExpression(triggerId);
  let checkTime = new Date(startTime);
  while (checkTime.getTime() < startTime + testDuration) {
    const nextExec = calculateNextCronExecution(cronExpression, checkTime);
    if (nextExec.getTime() < startTime + testDuration) {
      expectedExecutions.push(nextExec);
    }
    checkTime = new Date(nextExec.getTime() + 60000);
  }

  // Monitor actual executions
  const executionListener = onExecutionStart(triggerId, (exec) => {
    actualExecutions.push(new Date(exec.startedAt));
  });

  // Wait for test duration
  await sleep(testDuration);
  executionListener.stop();

  // Compare expected vs actual
  const comparison = compareExecutions(expectedExecutions, actualExecutions);

  return {
    testDuration,
    expectedCount: expectedExecutions.length,
    actualCount: actualExecutions.length,
    missedExecutions: comparison.missed,
    extraExecutions: comparison.extra,
    timingAccuracy: comparison.timingAccuracy,
    reliability: (actualExecutions.length / expectedExecutions.length) * 100
  };
}
```

---

## Polling Trigger Testing

```typescript
// Test polling trigger behavior
async function testPollingTrigger(triggerId: string, testConfig: PollingTestConfig): Promise<PollingTestResult> {
  const { interval, testDuration, simulateDataChanges } = testConfig;

  const pollEvents: PollEvent[] = [];
  const triggeredExecutions: Execution[] = [];

  // Monitor polling events
  const pollListener = onPoll(triggerId, (event) => {
    pollEvents.push({
      timestamp: new Date(),
      dataFound: event.hasNewData,
      itemCount: event.items?.length || 0
    });
  });

  // Monitor triggered executions
  const execListener = onExecutionStart(triggerId, (exec) => {
    triggeredExecutions.push(exec);
  });

  // Optionally simulate data changes
  if (simulateDataChanges) {
    for (const change of simulateDataChanges) {
      setTimeout(() => {
        injectTestData(triggerId, change.data);
      }, change.at);
    }
  }

  // Wait for test duration
  await sleep(testDuration);

  pollListener.stop();
  execListener.stop();

  // Analyze results
  const expectedPolls = Math.floor(testDuration / interval);
  const actualPolls = pollEvents.length;

  return {
    interval,
    testDuration,
    expectedPolls,
    actualPolls,
    pollAccuracy: (actualPolls / expectedPolls) * 100,
    averageInterval: calculateAverageInterval(pollEvents),
    executionsTriggered: triggeredExecutions.length,
    deduplicationWorking: checkDeduplication(triggeredExecutions),
    pollEvents
  };
}

// Check if deduplication is working
function checkDeduplication(executions: Execution[]): boolean {
  const processedIds = new Set();

  for (const exec of executions) {
    const itemIds = exec.data?.resultData?.runData?.Trigger?.[0]?.data?.main?.[0]
      ?.map(item => item.json?.id);

    if (itemIds) {
      for (const id of itemIds) {
        if (processedIds.has(id)) {
          return false; // Duplicate found
        }
        processedIds.add(id);
      }
    }
  }

  return true;
}
```

---

## Event Trigger Testing

```typescript
// Test event-driven triggers
async function testEventTrigger(triggerId: string, eventConfig: EventTestConfig): Promise<EventTestResult> {
  const { eventType, testEvents, timeout } = eventConfig;

  const results: EventResult[] = [];

  for (const testEvent of testEvents) {
    // Emit test event
    const startTime = Date.now();
    await emitTestEvent(eventType, testEvent.payload);

    // Wait for trigger
    try {
      const execution = await waitForTrigger(triggerId, timeout);

      results.push({
        eventType: testEvent.type,
        triggered: true,
        latency: Date.now() - startTime,
        payloadReceived: execution.data?.inputData
      });
    } catch (error) {
      results.push({
        eventType: testEvent.type,
        triggered: false,
        error: error.message
      });
    }
  }

  return {
    eventType,
    testsRun: testEvents.length,
    triggered: results.filter(r => r.triggered).length,
    averageLatency: average(results.filter(r => r.triggered).map(r => r.latency)),
    results
  };
}
```

---

## Trigger Response Testing

```typescript
// Test trigger response modes
async function testTriggerResponses(webhookUrl: string): Promise<ResponseTestResult> {
  // Test immediate response
  const immediateStart = Date.now();
  const immediateResponse = await fetch(webhookUrl, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: '{"test": "immediate"}'
  });
  const immediateTime = Date.now() - immediateStart;

  // Test with workflow execution
  const workflowStart = Date.now();
  const workflowResponse = await fetch(`${webhookUrl}?waitForResponse=true`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: '{"test": "workflow"}'
  });
  const workflowTime = Date.now() - workflowStart;

  return {
    immediateResponse: {
      status: immediateResponse.status,
      time: immediateTime,
      body: await immediateResponse.text()
    },
    workflowResponse: {
      status: workflowResponse.status,
      time: workflowTime,
      body: await workflowResponse.text()
    },
    responseMode: workflowTime > immediateTime + 100 ? 'workflow' : 'immediate'
  };
}
```

---

## Test Scenarios

```yaml
Webhook Scenarios:
  - name: Valid JSON POST
    method: POST
    payload: {"event": "test"}
    expected: 200 OK

  - name: Invalid JSON
    method: POST
    payload: "not valid json"
    expected: 400 Bad Request

  - name: Missing auth
    method: POST
    headers: {}
    expected: 401 Unauthorized

  - name: Large payload
    method: POST
    payload: [10MB of data]
    expected: 413 Payload Too Large

Schedule Scenarios:
  - name: Every 5 minutes
    cron: "*/5 * * * *"
    verify: 12 executions per hour

  - name: Weekdays at 9 AM
    cron: "0 9 * * 1-5"
    verify: 5 executions per week

Polling Scenarios:
  - name: 1 minute interval
    interval: 60000
    verify: ~60 polls per hour

  - name: Deduplication
    interval: 60000
    inject_duplicate: true
    verify: No duplicate processing
```

---

## Related Skills
- [n8n-workflow-testing-fundamentals](../n8n-workflow-testing-fundamentals/)
- [n8n-integration-testing-patterns](../n8n-integration-testing-patterns/)
- [n8n-security-testing](../n8n-security-testing/)

---

## Remember

**n8n triggers are the entry points** to workflows. Testing requires:
- Webhook: Payload handling, auth, HTTP methods
- Schedule: Cron accuracy, timezone handling
- Polling: Interval accuracy, deduplication
- Event: Event handling, filtering

**Key patterns:** Test with various payloads (valid, invalid, edge cases). Verify authentication enforcement. Check response times and reliability over time.

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

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

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
n8n-error-handling-official n8n-io Скилл n8n-error-handling-official для Claude, который заставляет агента настраивать обработку ошибок в n8n: коды ответов по причине, ветки ошибок и аварийные workflow. CX Codex +1 2 500установок n8n-workflow-patterns czlonkowski Скилл n8n-workflow-patterns даёт шесть архитектурных паттернов для n8n-воркфлоу: webhook, API, база данных, AI-агент, расписание, пакетная обработка. Подсказывает, какой паттерн выбрать и какие ноды нужны. CX Codex +1 12 400установок n8n-daily-report datadrivenconstruction Скилл n8n-daily-report с готовым воркфлоу n8n: собирает данные стройплощадки по расписанию и рассылает ежедневный отчёт. CX Codex +1 115установок n8n-workflow-lifecycle-official n8n-io Скилл n8n-workflow-lifecycle-official для Claude Code помогает создать, проверить и опубликовать рабочий процесс n8n. Подключается к задачам по проектированию, организации и выпуску workflow. CX Codex +1 2 900установок mcp-n8n leonardosepulvedat Сервер подключает ИИ-агента к n8n: он помогает собирать и проверять рабочие процессы, следить за запусками и управлять экземпляром. Нужны адрес n8n и API-ключ. CX Codex +1 ★ 22звёзд репо n8n-mcp-tools-expert czlonkowski Скилл n8n-mcp-tools-expert для Claude Code направляет агента при вызове инструментов n8n-mcp. Включается при сборке воркфлоу, поиске нод, валидации параметров и аудите инстанса. CX Codex +1 8 800установок

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

Весь набор →
contract-testing Скилл contract-testing помогает настроить контрактное тестирование API и микросервисов с помощью Pact и предотвратить поломки при деплое. CX Codex +1 130установок qe-quality-assessment Скилл qe-quality-assessment для Claude Code оценивает качество кода по сложности, линту, запахам и здоровью тестов. Проверяет quality gates, формирует отчёты и оценивает готовность релиза. CX Codex +1 129установок qe-defect-intelligence Скилл qe-defect-intelligence анализирует код на вероятность ошибок по частоте изменений, сложности и истории багов. Помогает найти проблемные участки до того, как они попадут в продакшн. CX Codex +1 129установок risk-based-testing Скилл risk-based-testing распределяет ресурсы тестирования по уровню риска модулей по шкале от 1 до 5 и приоритизирует автотесты перед релизом. CX Codex +1 128установок n8n-expression-testing Скилл n8n-expression-testing проверяет синтаксис выражений n8n, их работу с контекстом и обработку пустых значений. Нужен при отладке преобразований данных. CX Codex +1 127установок qe-coverage-analysis Скилл qe-coverage-analysis разбирает отчёты Istanbul, c8 и lcov, выявляя пробелы в тестах с учётом критичности кода. Помогает приоритизировать покрытие и блокировать проблемные PR. CX Codex +1 127установок test-reporting-analytics Скилл test-reporting-analytics формирует дашборды качества, отчёты для руководства и прогнозирует сбои тестов по diff в коде. Пригодится при контроле релизов и разборе динамики метрик в CI/CD. CX Codex +1 126установок qe-iterative-loop Скилл qe-iterative-loop для Claude Code запускает автономные циклы red-green-refactor: агент чинит падающие тесты, достигает целевого покрытия и проходит quality gates. Циклы устраняют падения тестов и повышают покрытие. CX Codex +1 126установок

Ещё в каталоге

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

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