diff --git a/.github/workflows/e2e.yml b/.github/workflows/e2e.yml
index 5a86b5368..3434f3d23 100644
--- a/.github/workflows/e2e.yml
+++ b/.github/workflows/e2e.yml
@@ -31,7 +31,7 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
- workspace: [jasmine, jest, multi-remote-mocha]
+ workspace: [jasmine, jest, multi-remote-mocha, browser-runner]
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
diff --git a/docs/Framework.md b/docs/Framework.md
index 6d11063d7..29c1cbe1f 100644
--- a/docs/Framework.md
+++ b/docs/Framework.md
@@ -305,3 +305,7 @@ describe('My tests', async () => {
### Cucumber
More details to come. In short, when paired with [`@wdio/cucumber-framework`](https://www.npmjs.com/package/@wdio/cucumber-framework), you can use WebDriverIO's `expect` library seamlessly within your Cucumber step definitions and [Gherkin-based](https://www.npmjs.com/package/@cucumber/gherkin) tests.
+
+### Browser Runner
+
+Browser Runner is a special case that relies on standard `expect` and only registers `expect-webdriverio` matchers. Because it does not fully leverage `expect-webdriverio`, features such as `DefaultOption`, `SoftAssertion`, `expect.oneOf`, and `some` are currently unsupported.
diff --git a/docs/MultipleElements.md b/docs/MultipleElements.md
index 45e50fc91..5f10bc0a3 100644
--- a/docs/MultipleElements.md
+++ b/docs/MultipleElements.md
@@ -35,6 +35,10 @@ before: function (_capabilities, _specs) {
- For `containing` use Asymmetric Matchers (`expect.stringContaining('Example')`)
- Passing an array of "containing" values is a legacy behavior and only used by default with `toHaveText` when `useToHaveTextStrictMultiElementsCompareStrategy` is disabled.
+### Browser Runner
+
+Since the Browser Runner uses standard `expect` by only extending the `expect-webdriverio` matchers, `expect.oneOf` and `some` are not currently supported.
+
## Supported types
You can pass any of these element types to `expect`:
diff --git a/playgrounds/browser-runner/README.md b/playgrounds/browser-runner/README.md
new file mode 100644
index 000000000..9c01db516
--- /dev/null
+++ b/playgrounds/browser-runner/README.md
@@ -0,0 +1,7 @@
+# Browser Runner Playground
+
+This playground project uses the local build of `expect-webdriverio` with the Browser Runner to test integration with vue.
+
+## Framework
+
+Browser runner is a special case not relying on the `expect-webdriverio` configuration per see. It actual rely mainly on `expect` and only register wdio custom matchers using `expect` lib `expect.extend()` and NOT the one from `expect-webdriverio`!
diff --git a/playgrounds/browser-runner/components/Component.vue b/playgrounds/browser-runner/components/Component.vue
new file mode 100644
index 000000000..92f4180b7
--- /dev/null
+++ b/playgrounds/browser-runner/components/Component.vue
@@ -0,0 +1,20 @@
+
+