fix: Cypress hangs when wrapping an object containing circular references

[jennifer-shehane]

• Closes Cypress hangs when wrapping an object containing circular references. #24715

Additional details

When cy.wrap() is called with objects containing circular references, the logging code in stringifyActual causes infinite recursion because it doesn't track visited objects. This can lead to stack overflow errors - which cause the Cypress App to completely hang.

I'm not sure if this is an issue with other command logs, but this addresses the issue with logging in general, so it would resolve situations there as well.

Steps to test

• Run yarn cypress:open
• Run the example below to ensure it doesn't hang:

class Node {
  parent;
  children = [];

  appendChild(child) {
    child.parent = this;
    this.children.push(child);
    return child;
  }
}

describe("Reproduce the Cypress's issue", () => {
  it("Wrap an object containing circular references", () => {
    const rootNode = new Node();
    rootNode.appendChild(new Node()).appendChild(new Node());
    cy.wrap(rootNode);
    cy.visit("https://example.cypress.io/");
  })
})

How has the user experience changed?

Before

!!!! Complete Cypress App hang when running the test

After

PR Tasks

• Have tests been added/updated?
• Has a PR for user-facing changes been opened in cypress-documentation?
• Have API changes been updated in the type definitions?

---

Note

Track visited objects to safely stringify circular structures, preventing cy.wrap() hangs and updating tests and changelog accordingly.

• Driver utils:
  • Update packages/driver/src/cypress/utils.ts to detect circular references using a WeakSet in stringifyActual()/stringifyActualObj() and return [Circular], Array[N], or Object{N} safely.
• Tests:
  • Add circular reference scenarios for cy.wrap() in packages/driver/cypress/e2e/commands/misc.cy.js (objects, arrays, nested/multiple refs; ensure logs include [Circular] and chaining works).
  • Expand packages/driver/cypress/e2e/cypress/utils.cy.js to assert safe stringification of circular objects/arrays and adjust expectations for small/large arrays and object key counts.
• Changelog:
  • Note bugfix for cy.wrap() freezing on circular references in cli/CHANGELOG.md.

^{Written by Cursor Bugbot for commit f84e3f4. This will update automatically on new commits. Configure here.}

[cypress]

cypress    Run #67248

Run Properties:   Passed #67248  •  f84e3f438a: Merge branch 'develop' into fix-wrap-circular-reference-log

Project	cypress
Branch Review	fix-wrap-circular-reference-log
Run status	Passed #67248
Run duration	34m 31s
Commit	f84e3f438a: Merge branch 'develop' into fix-wrap-circular-reference-log
Committer	Jennifer Shehane
View all properties for this run ↗︎

---

Test results
Failures	0
Flaky	11
Pending	1098
Skipped	4
Passing	26594
View all changes introduced in this branch ↗︎

---

Warning

Partial Report: The results for the Application Quality reports may be incomplete.

UI Coverage  45.48%
Untested elements	188
Tested elements	161

Accessibility  97.98%
Failed rules	4 critical   8 serious   2 moderate   2 minor
Failed elements	101

[cypress-bot]

Released in 15.7.0.

This comment thread has been locked. If you are still experiencing this issue after upgrading to
Cypress v15.7.0, please open a new issue.