Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: handle pretty formatting of wide arrays and array-like objects #12402

Merged
merged 11 commits into from Feb 16, 2022

Conversation

ryanwilsonperkin
Copy link
Contributor

Summary

Fixes #12364

Jest will attempt to avoid printing very deeply nested objects beyond a certain depth when writing output from matchers, but it doesn't have the same mechanism for very wide objects.

As a result, very large arrays can cause Jest to run out of memory when a matcher fails and jest attempts to pretty-print the array.

This change introduces a maxWidth parameter to the pretty-format package to complement the existing maxWidth parameter so that it can be used by jest-matcher-utils (and potentially others) to limit the impact of printing very wide objects. For now this applies to Arrays, Sets, and Maps, but in the future could also be used by custom plugins, serializers, or other pretty formatting elements.

Test plan

Added tests to validate the behaviour and tested against code that previously resulted in out-of-memory errors that now fails correctly.

Copy link
Member

@SimenB SimenB left a comment

Choose a reason for hiding this comment

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

yay, this is awesome!

also please include a changelog entry 🙂

packages/pretty-format/src/collections.ts Outdated Show resolved Hide resolved
packages/pretty-format/src/collections.ts Outdated Show resolved Hide resolved
packages/pretty-format/src/collections.ts Outdated Show resolved Hide resolved
packages/pretty-format/src/index.ts Outdated Show resolved Hide resolved
@facebook-github-bot
Copy link
Contributor

Hi @ryanwilsonperkin!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@fb.com. Thanks!

prefer to use these operators where possible on the options object

Refactor requested during review
? ''
: createIndent(options?.indent ?? DEFAULT_OPTIONS.indent),
maxDepth: options?.maxDepth ?? DEFAULT_OPTIONS.maxDepth,
maxWidth: options?.maxWidth ?? DEFAULT_OPTIONS.maxWidth,
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Functionally, the maxWidth is the only newly introduced behaviour in this block. The rest of this block diff is related to a refactor to make use of the safe navigation and null coalescing operators so that

options && options.foo ? options.foo : DEFAULT_OPTIONS.foo

can become

options?.foo ?? DEFAULT_OPTIONS.foo

@facebook-github-bot
Copy link
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

CHANGELOG.md Outdated Show resolved Hide resolved
@SimenB SimenB changed the title Fix pretty formatting of wide arrays and array-like objects fix: handle pretty formatting of wide arrays and array-like objects Feb 16, 2022
@SimenB SimenB merged commit 6094810 into jestjs:main Feb 16, 2022
@ryanwilsonperkin ryanwilsonperkin deleted the fix-pretty-printing-wide-objects branch February 16, 2022 13:17
@github-actions
Copy link

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.
Please note this issue tracker is not a help forum. We recommend using StackOverflow or our discord channel for questions.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Mar 19, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Bug]: Jest runs out of memory when trying to print wide objects
3 participants