Skip to content

feat(config): allow --exclude to exclude suites by name#14915

Merged
christian-bromann merged 3 commits intowebdriverio:mainfrom
mccmrunal:feat/exclude-suite-support-new
Jan 8, 2026
Merged

feat(config): allow --exclude to exclude suites by name#14915
christian-bromann merged 3 commits intowebdriverio:mainfrom
mccmrunal:feat/exclude-suite-support-new

Conversation

@mccmrunal
Copy link
Contributor

@mccmrunal mccmrunal commented Dec 4, 2025 •
edited
Loading

Proposed changes

#14447
This PR enhances the existing --exclude CLI option so that it can automatically detect and exclude suites by their suite name, not just by spec files or globs. It keeps full backward compatibility, and you don’t need to introduce any new CLI flags or config changes. With this update, you can now exclude entire suites just by providing their name, while still retaining all current behaviour of --exclude.
//: # (Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixes a bug or resolves a feature request, be sure to link to that issue.)
Key changes:

  • Added [isSpecPattern()] helper function to distinguish between file paths/globs and suite names
  • Modified [getSpecs()] method to partition exclude values into excludeSuites and excludeSpecPatterns
  • Suite exclusion takes precedence when a value matches both a suite name and could be a file pattern
  • Added comprehensive unit tests and documentation

Types of changes

  • Polish (an improvement for an existing feature)
  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update (improvements to the project's docs)
  • Specification changes (updates to WebDriver command specifications)
  • Internal updates (everything related to internal scripts, governance documentation and CI files)

Checklist

  • I have read the CONTRIBUTING doc
  • I have added tests that prove my fix is effective or that my feature works
  • I have added the necessary documentation (if appropriate)
  • I have added proper type definitions for new commands (if appropriate)

Backport Request

//: # (The current main branch is the development branch for WebdriverIO v9. If your change should be released to the current major version of WebdriverIO (v8), please raise another PR with the same changes against the v8 branch.)

  • This change is solely for v9 and doesn't need to be back-ported
  • Back-ported PR at #XXXXX

Further comments

Reviewers: @webdriverio/project-committers

@mccmrunal
Copy link
Contributor Author

mccmrunal commented Dec 4, 2025

please review

@pkg-pr-new
Copy link

pkg-pr-new bot commented Dec 4, 2025 •
edited
Loading

Open in StackBlitz

create-wdio

npm i https://pkg.pr.new/webdriverio/webdriverio/create-wdio@14915

eslint-plugin-wdio

npm i https://pkg.pr.new/webdriverio/webdriverio/eslint-plugin-wdio@14915

@wdio/allure-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/allure-reporter@14915

@wdio/appium-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/appium-service@14915

@wdio/browser-runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/browser-runner@14915

@wdio/browserstack-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/browserstack-service@14915

@wdio/cli

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/cli@14915

@wdio/concise-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/concise-reporter@14915

@wdio/config

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/config@14915

@wdio/cucumber-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/cucumber-framework@14915

@wdio/dot-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/dot-reporter@14915

@wdio/firefox-profile-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/firefox-profile-service@14915

@wdio/globals

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/globals@14915

@wdio/jasmine-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/jasmine-framework@14915

@wdio/json-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/json-reporter@14915

@wdio/junit-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/junit-reporter@14915

@wdio/lighthouse-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/lighthouse-service@14915

@wdio/local-runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/local-runner@14915

@wdio/logger

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/logger@14915

@wdio/mocha-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/mocha-framework@14915

@wdio/protocols

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/protocols@14915

@wdio/repl

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/repl@14915

@wdio/reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/reporter@14915

@wdio/runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/runner@14915

@wdio/sauce-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/sauce-service@14915

@wdio/shared-store-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/shared-store-service@14915

@wdio/smoke-test-cjs-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-cjs-service@14915

@wdio/smoke-test-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-reporter@14915

@wdio/smoke-test-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-service@14915

@wdio/spec-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/spec-reporter@14915

@wdio/static-server-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/static-server-service@14915

@wdio/sumologic-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/sumologic-reporter@14915

@wdio/testingbot-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/testingbot-service@14915

@wdio/types

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/types@14915

@wdio/utils

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/utils@14915

@wdio/webdriver-mock-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/webdriver-mock-service@14915

@wdio/xvfb

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/xvfb@14915

webdriver

npm i https://pkg.pr.new/webdriverio/webdriverio/webdriver@14915

webdriverio

npm i https://pkg.pr.new/webdriverio/webdriverio@14915

commit: 2c2c07f

@mccmrunal mccmrunal closed this Dec 4, 2025
@mccmrunal mccmrunal reopened this Dec 4, 2025
@mccmrunal mccmrunal closed this Dec 4, 2025
@mccmrunal mccmrunal reopened this Dec 4, 2025
@mccmrunal mccmrunal closed this Dec 4, 2025
@mccmrunal mccmrunal reopened this Dec 4, 2025
@mccmrunal mccmrunal closed this Dec 24, 2025
@mccmrunal mccmrunal reopened this Dec 24, 2025
@mccmrunal mccmrunal closed this Dec 25, 2025
@mccmrunal mccmrunal reopened this Dec 25, 2025
christian-bromann
christian-bromann approved these changes Jan 8, 2026
View reviewed changes
Copy link
Member

@christian-bromann christian-bromann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🐐

@christian-bromann christian-bromann merged commit e7907d6 into webdriverio:main Jan 8, 2026
94 of 95 checks passed
@christian-bromann christian-bromann added the PR: New Feature 🚀 PRs that contain new features label Jan 8, 2026
@wdio-bot
Copy link
Contributor

wdio-bot commented Jan 8, 2026

Hey mccmrunal 👋

Thank you for your contribution to WebdriverIO! Your pull request has been marked as an "Expensable" contribution.

We've sent you an email with further instructions on how to claim your expenses from our development fund.
Please make sure to check your spam folder as well. If you have any questions, feel free to reach out to us at expense@webdriver.io or in the contributing channel on Discord.

We are looking forward to more contributions from you in the future 🙌

Have a nice day,
The WebdriverIO Team 🤖

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@christian-bromann christian-bromann christian-bromann approved these changes

Assignees

No one assigned

Labels

Expensable $25 💸 PR: New Feature 🚀 PRs that contain new features

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@mccmrunal @wdio-bot @christian-bromann @wswebcreation