@stryker-mutator/api

What is @stryker-mutator/api?

@stryker-mutator/api is a part of the Stryker Mutator framework, which is used for mutation testing in JavaScript and TypeScript projects. It provides a set of APIs that allow developers to integrate and extend the mutation testing capabilities of Stryker.

What are @stryker-mutator/api's main functionalities?

Mutator API

The Mutator API allows developers to create custom mutators that define how code should be mutated during testing. This is useful for extending the mutation testing capabilities to cover more specific or custom scenarios.

const { Mutator } = require('@stryker-mutator/api/mutant');

class MyMutator extends Mutator {
  mutate(node) {
    // Custom mutation logic
  }
}

Reporter API

The Reporter API provides a way to create custom reporters that can handle and display the results of mutation testing. This allows for customized reporting formats and integration with other tools.

const { Reporter } = require('@stryker-mutator/api/report');

class MyReporter extends Reporter {
  onMutantTested(result) {
    console.log(`Mutant ${result.id} tested with status ${result.status}`);
  }
}

Test Framework API

The Test Framework API allows developers to integrate custom test frameworks with Stryker. This is useful for supporting additional testing frameworks that are not natively supported by Stryker.

const { TestFramework } = require('@stryker-mutator/api/test_framework');

class MyTestFramework extends TestFramework {
  constructor() {
    super();
    // Custom test framework initialization
  }
}

Other packages similar to @stryker-mutator/api

jest

Jest is a popular JavaScript testing framework with built-in support for snapshot testing, mocking, and more. While it does not focus on mutation testing like Stryker, it provides a comprehensive testing solution that can be used alongside Stryker for a complete testing strategy.

mocha

Mocha is a flexible JavaScript test framework for Node.js programs. It provides a simple and extensible interface for writing tests, but does not include mutation testing capabilities. Mocha can be used with Stryker to perform mutation testing on tests written in Mocha.

karma

Karma is a test runner that allows you to execute JavaScript code in multiple real browsers. It is often used in conjunction with other testing frameworks like Jasmine or Mocha. While Karma itself does not provide mutation testing, it can be integrated with Stryker to run mutation tests in a browser environment.

README

StrykerJS API

This is the repository for maintaining the API of the StrykerJS mutation testing framework. Plugin creators should depend on this API rather than on the main Stryker repository directly.

Extension use cases

You can extend Stryker in a number of ways.

1. Create your own Mutator
2. Create a custom Reporter
3. Create a TestFramework for a test framework
4. Create a TestRunner to bridge the gap between your test runner and Stryker
5. Create a custom way of configuring Stryker by creating an OptionsEditor

All extension points work in the same basic way.

1. Create a constructor function (or class)
2. Register the constructor function to the correct Factory.

For more info, please take a look at the Stryker website section on plugins.

Changelog

8.6.0 (2024-09-29)

Bug Fixes

• deps: update dependency @cucumber/messages to v26 (#4960) (7de2749)
• deps: update dependency @inquirer/prompts to v6 (#5029) (d727cb7)
• deps: update dependency emoji-regex to ~10.4.0 (#4987) (8337f88)
• deps: update dependency execa to v9.4.0 (#5024) (99d60e0)
• deps: update dependency npm-run-path to v6 (#4986) (1c9f354)
• deps: update dependency tslib to v2.7.0 (#4981) (4bdef40)
• deps: update dependency typed-rest-client to ~2.1.0 (#5025) (454e5e2)
• deps: update mutation-testing-elements monorepo to v3.3.0 (#5026) (88caf82)
• jest-runner: allow prerelease jest versions (#5015) (#5016) (0c9cdd1)

Features

• ignore: add "angular" ignore plugin (#4789) (5d792d8)
• init: use user configured npm registry (#4937) (33e348e)
• instrumenter: add expression mutator for Date (#4917) (#4918) (8207ef6)
• reporter: add "% score of covered" column to the clear text report (#4945) (3b511ed)