Plugins

Standard Plugins

Drift comes bundled with several core plugins that provide essential testing, validation, and reporting capabilities out of the box.

OpenAPI (oas)

The foundational plugin for spec-first testing. It parses OpenAPI 3.0 and 3.1 documents to resolve endpoints, schemas, and examples.

JSON (json)

Provides specialized validation for JSON payloads.

Media Type Support: Handles application/json payloads defined in your API specification.
Schema Support: Powers deep property and type checking for API responses.

XML (xml)

Provides payload support for XML request and response bodies.

Media Type Support: Handles application/xml payloads defined in your API specification.
Use Case: Use this plugin when your API exchanges XML bodies that Drift needs to send or validate.
See Also: XML Plugin

Form URL Encoded (form-urlencoded)

Provides payload support for HTML form-style request bodies.

Media Type Support: Handles application/x-www-form-urlencoded payloads.
Use Case: Use this plugin when an operation expects form fields instead of JSON.
See Also: Form URL Encoded Plugin

Data (data)

Manages the loading and injection of external datasets into your test cases.

Dataset Management: Resolves references like ${product:products.product10.id} from drift-dataset-file sources.
Dynamic Generation: Supports advanced expressions like notIn() to create unique test data on the fly.

JUnit Reporter (junit-output)

Generates standardized XML reports for integration with CI/CD tools like GitHub Actions, Jenkins, or GitLab.

Format: Produces testsuite and testcase elements compatible with universal JUnit XML schemas.
CI Integration: Allows build systems to visualize pass/fail counts and execution times natively.

HTTP Dump (http-dump)

A debugging utility that logs raw HTTP traffic.

Use Case: Enable this plugin to inspect the exact headers and bodies being sent and received during a test run.
Configuration: Can be configured via config.toml to adjust log verbosity.

In this section: