@kubb/plugin-cypress

@kubb/plugin-cypress turns your OpenAPI operations into typed cy.request() wrappers, one helper per operation. Each helper types its path params, body, query, and response, so a broken API call fails at compile time instead of in the test runner. Use the helpers in before and beforeEach hooks to seed data, in custom commands, or in API-only tests.

Each helper takes its parameters as a single grouped options object shaped as { body, path, query, headers }, with camelCase property names. The request still sends the original parameter names from the spec, and Kubb writes that mapping for you. A helper resolves to the response body and its return type is Cypress.Chainable<{Operation}Response>.

Installation

bun

bun add -d @kubb/plugin-cypress@beta

pnpm

pnpm add -D @kubb/plugin-cypress@beta

npm

npm install --save-dev @kubb/plugin-cypress@beta

yarn

yarn add -D @kubb/plugin-cypress@beta

Dependencies

This plugin depends on @kubb/plugin-ts for the request, parameter, and response types it imports. Keep pluginTs() in the plugins array.

Example

kubb.config.ts

import {  } from 'kubb'
import {  } from '@kubb/plugin-ts'
import {  } from '@kubb/plugin-cypress'

export default ({
  : { : './petStore.yaml' },
  : { : './src/gen' },
  : [
    (),
    ({
      : {
        : './cypress',
        : { : 'named' },
        : '/* eslint-disable */',
      },
      : {
        : 'tag',
        : ({  }) => `${}Requests`,
      },
    }),
  ],
})

Using a generated helper

import { getPetById } from '../gen/cypress/petRequests'

describe('Pet API', () => {
  it('returns the pet by id', () => {
    getPetById({ path: { petId: 1 } }).then((pet) => {
      expect(pet.id).to.eq(1)
    })
  })
})

See also

• Cypress
• cy.request()
• @kubb/plugin-ts
• Changelog