[Durable Objects] Add docs & changelog for eviction helpers in vitest

[apeacock1991]

Summary

Adds docs and changelog for the new vitest helpers, which allow the testing of evictions with Durable Objects.

The implementation PR can be found here: cloudflare/workers-sdk#14398.

Note: I updated two unrelated examples because they actually failed when ran, and all the new examples have been tested and pass.

Documentation checklist

• Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
• The change adheres to the documentation style guide.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/changelog/	@cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/durable-objects/	@elithrar, @rita3ko, @irvinebroque, @vy-ton, @iglesiasbrandon, @joshthoward, @danlapid, @oxyjun, @lambrospetrou, @mikenomitch, @cloudflare/product-owners
/src/content/docs/workers/	@cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK, @cloudflare/dev-plat-leads, @vy-ton

[github-actions]

Preview URL: https://b9e2478d.preview.developers.cloudflare.com
Preview Branch URL: https://apeacock-do-eviction.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/durable-objects/examples/testing-with-durable-objects/	https://apeacock-do-eviction.preview.developers.cloudflare.com/durable-objects/examples/testing-with-durable-objects/
https://developers.cloudflare.com/workers/testing/vitest-integration/test-apis/	https://apeacock-do-eviction.preview.developers.cloudflare.com/workers/testing/vitest-integration/test-apis/
https://developers.cloudflare.com/changelog/post/2026-06-25-durable-object-eviction-test-helpers/	https://apeacock-do-eviction.preview.developers.cloudflare.com/changelog/post/2026-06-25-durable-object-eviction-test-helpers/
https://developers.cloudflare.com/workers/testing/	https://apeacock-do-eviction.preview.developers.cloudflare.com/workers/testing/

[iglesiasbrandon]

/bonk review this pr

[ask-bonk]

This is a well-structured PR. The documentation is clear, the examples are practical, and the fixes to existing snippets are appreciated. A few notes:

src/content/docs/durable-objects/examples/testing-with-durable-objects.mdx

• Good fix changing expect(ids.length).toBe(2) to .toBeGreaterThanOrEqual(2) in the listDurableObjectIds test — that's a realistic failure mode when other tests have created objects.
• The eviction examples nicely demonstrate the difference between in-memory and durable state. The WebSocket hibernation/close examples are particularly useful.
• Nit: Consider updating the reviewed: 2023-08-08 frontmatter date since this is a substantial content addition.

src/content/docs/workers/testing/vitest-integration/test-apis.mdx

• Good job backfilling docs for reset() and abortAllDurableObjects() alongside the new eviction helpers.
• The DurableObjectEvictionOptions table is clear and concise.
• The evictDurableObject code example is self-contained and correctly shows the persisted-count behavior.

src/content/changelog/workers/2026-06-25-durable-object-eviction-test-helpers.mdx

• Clean, to-the-point changelog entry. The inline example covers both single-object eviction and the webSockets option, which is exactly what readers need.

src/content/docs/workers/testing/index.mdx

• Comparison matrix update is correctly placed.

Overall this looks ready to land. Nice work on testing the examples. 👍

github run

[vy-ton]

As a user, I would ask "is this different than remote production behavior" because you're calling out all these things.

[apeacock1991]

Removed the references to durable storage

[vy-ton]

These helpers let you exercise how a Durable Object behaves across evictions in your tests.

add something to help users why you would want to do this

[irvinebroque]

+1 and link to something that gives context on evictions maybe?

[apeacock1991]

Good shout, linked to the lifecycle doc now + gave some context on why

[vy-ton]

avoid graceful everywhere?

why callout saving durable storage? - if you do should be to highlight thats the product capability. otherwise I wonder "is my storage not durable"

[apeacock1991]

Fair, removed the graceful parts. They are in there because of the abort functionality, which is non-graceful but I think we can just stick with "non-graceful" or similar in the abort part.