Document Precedence of Mocked Routes if Multiple are Matching

[jklingen]

I have been looking for a documentation of the behavior and couldn't find it anywhere in the docs. (Maybe I looked in the wrong place, but I would have expected to find it in this document.)

According to this commit, the most recently registered route wins, which confirms what I assumed after a bit trial and error.

It would be helpful to have this behavior officially documented for the following use cases:

• adding a set of generic default mocks for all tests, which can be overridden with more specific mocks if needed
• adding an always-failing "catch-all" route as fallback to make sure that all API requests are mocked

[Skn0tt]

Thanks for the contribution! I verified we test this behaviour in

playwright/tests/page/page-route.spec.ts

Line 41 in bfd1ec6

it('should unroute', async ({ page, server }) => {

.

[Skn0tt]

can you run npm run build and commit the changed files? the linter is complaining.

[jklingen]

@microsoft-github-policy-service agree

[jklingen]

@Skn0tt thanks for the heads-up, I just ran the build and pushed the updated files

[github-actions]

Test results for "tests 1"

5 failed
❌ [playwright-test] › playwright.spec.ts:485 › should work with video: on-first-retry @macos-latest-node20
❌ [playwright-test] › reporter-base.spec.ts:259 › created › should print if globalTimeout is reached @macos-latest-node20
❌ [playwright-test] › test-step.spec.ts:577 › should not mark page.close as failed when page.click fails @macos-latest-node20
❌ [playwright-test] › to-have-screenshot.spec.ts:62 › should disable animations by default @macos-latest-node20
❌ [playwright-test] › ui-mode-trace.spec.ts:812 › should update state on subsequent run @macos-latest-node20

3 flaky

⚠️ [chromium-page] › page/page-request-continue.spec.ts:754 › propagate headers cross origin redirect after interception `@ubuntu-22.04-chromium-tip-of-tree`
⚠️ [firefox-library] › library/inspector/cli-codegen-1.spec.ts:1082 › cli codegen › should not throw csp directive violation errors `@firefox-ubuntu-22.04-node20`
⚠️ [playwright-test] › ui-mode-trace.spec.ts:700 › should indicate current test status `@macos-latest-node20`

38551 passed, 843 skipped

---

Merge workflow run.

[github-actions]

Test results for "MCP"

1467 passed, 45 skipped

---

Merge workflow run.