Skip to content

Add guides for diagnosing failures in WPT tests.#192

Merged
jdm merged 10 commits intomainfrom
wpt-failurew
Jan 6, 2026
Merged

Add guides for diagnosing failures in WPT tests.#192
jdm merged 10 commits intomainfrom
wpt-failurew

Conversation

@jdm
Copy link
Copy Markdown
Member

@jdm jdm commented Jan 5, 2026

I've tried to highlight the most common strategies that I use to narrow down the cause of failures in WPT tests. This is useful for cases like servo/servo#41661 where the expected test result changes did not materialize and we ask contributors to help diagnose why.

@jdm jdm requested review from delan and mrobinson as code owners January 5, 2026 04:36
jdm added 2 commits January 4, 2026 23:38
Signed-off-by: Josh Matthews <[email protected]>
Signed-off-by: Josh Matthews <[email protected]>
Co-authored-by: Mukilan Thiyagarajan <[email protected]>
Signed-off-by: Josh Matthews <[email protected]>
Copy link
Copy Markdown
Member

@mrobinson mrobinson left a comment

Choose a reason for hiding this comment

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

Great stuff! A couple minor comments and a question:


## Diagnosing a reftest failure

To see a visual representation of the differences between a test file and its reference file, you can use the [reftest analyzer](../testing.md#analyzing-reftest-results).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

FWIW, I almost never use the reftest analyzer nowadays and simply do --log-html out.html. I'm not sure if we should recommend one or the other.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I have exclusively used the analyzer and didn't even know there was an alternative.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I find that it's a bit easier to use as the analyzer often seems to fail in weird ways for me.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Let's stick with the existing recommendation for the purposes of this PR, since this is just linking to existing text in the book.

@jdm jdm requested a review from mrobinson January 6, 2026 16:54
Copy link
Copy Markdown
Member

@mrobinson mrobinson left a comment

Choose a reason for hiding this comment

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

Thank you!

@jdm jdm added this pull request to the merge queue Jan 6, 2026
Merged via the queue into main with commit dd34e93 Jan 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants