pestphp/pest · error · InvalidOption

The [--retry] option is not supported when running in parall

Error message

The [--retry] option is not supported when running in parallel.

What it means

Error "The [--retry] option is not supported when running in parallel." thrown in pestphp/pest.

Source

Thrown at src/Plugins/Retry.php:27

/**
 * @internal
 */
final class Retry implements HandlesArguments
{
    use Concerns\HandleArguments;

    /**
     * {@inheritDoc}
     */
    public function handleArguments(array $arguments): array
    {
        if (! $this->hasArgument('--retry', $arguments)) {
            return $arguments;
        }

        if ($this->hasArgument('--parallel', $arguments)) {
            throw new InvalidOption('The [--retry] option is not supported when running in parallel.');
        }

        $arguments = $this->popArgument('--retry', $arguments);

        $arguments = $this->pushArgument('--order-by=defects', $arguments);

        return $this->pushArgument('--stop-on-failure', $arguments);
    }
}

View on GitHub (pinned to 1af74a215c)

When it happens

Trigger: Thrown at src/Plugins/Retry.php:27 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of pestphp/pest@1af74a215c (2026-08-21). Data as JSON: /api/errors/695432d8808e9875. Report an issue: GitHub.