Ir al contenido
verdict:

Zustand 5.0.0

featured

Notas de la versión

note: la síntesis y las notas de la versión están en inglés

warning: requiere intervención

9 breaking changes4 puntos clave

Zustand v5 adds no new features but drops many old APIs, so upgrading needs the migration guide.

síntesis · solo a partir de las notas de la versión · claude-haiku-5-5 · prompt v7

breaking changestodos citados, cada uno con su solución

breaking[1]: Default exports are removed.

release-notes:11
Drop default exports

help: Follow the migration guide linked in the release notes.

breaking[2]: Deprecated features are removed.

release-notes:12
Drop deprecated features

help: Follow the migration guide linked in the release notes.

breaking[3]: React 18 becomes the minimum required version.

release-notes:13
Make React 18 the minimum required version

help: Upgrade React to version 18 or newer before upgrading Zustand.

breaking[4]: TypeScript 4.5 becomes the minimum required version.

release-notes:15
Make TypeScript 4.5 the minimum required version

help: Upgrade TypeScript to version 4.5 or newer.

breaking[5]: UMD and SystemJS support is dropped.

release-notes:16
Drop UMD/SystemJS support

help: Follow the migration guide linked in the release notes.

breaking[6]: ES5 support is dropped.

release-notes:18
Drop ES5 support

help: Follow the migration guide linked in the release notes.

breaking[7]: Types are stricter when setState's replace flag is set.

release-notes:19
Stricter types when setState's replace flag is set

help: Check your setState calls that use the replace flag for type errors.

breaking[8]: The persist middleware behaves differently.

release-notes:20
Persist middleware behavioral change

help: Check your persist middleware usage against the migration guide linked in the release notes.

breaking[9]: Other small improvements include changes that are technically breaking.

release-notes:21
Other small improvements (technically breaking changes)

help: Check the migration guide linked in the release notes for details.

puntos clave

release-notesgithub.com/pmndrs/zustand · 58 líneas
  1. # 🎉🎉🎉 Zustand v5 🐻🐻🐻
  3. ## TL;DR
  5. - No new features
  6. - Drop many old things
  7. - Migration from v4 should be smooth.
  9. ## Changes in v5
  11. - Drop default exports
  12. - Drop deprecated features
  13. - Make React 18 the minimum required version
  14. - Make use-sync-external-store a peer dependency (required for `createWithEqualityFn` and `useStoreWithEqualityFn` in `zustand/traditional`)
  15. - Make TypeScript 4.5 the minimum required version
  16. - Drop UMD/SystemJS support
  17. - Organize entry points in the package.json
  18. - Drop ES5 support
  19. - Stricter types when setState's replace flag is set
  20. - Persist middleware behavioral change
  21. - Other small improvements (technically breaking changes)
  23. ## Migration Guide
  25. Read the migration guide carefully:
  26. https://github.com/pmndrs/zustand/blob/main/docs/migrations/migrating-to-v5.md
  28. ### Frequently Reported Issue
  30. During the RC period, some users encountered the following infinite loop error:
  31. ```
  32. Uncaught Error: Maximum update depth exceeded. This can happen when a component repeatedly calls setState inside componentWillUpdate or componentDidUpdate. React limits the number of nested updates to prevent infinite loops.
  33. ```
  35. This case was already a non-ideal behavior in v4 but appears more explicitly as an error in v5. While there are several ways to resolve this, using `useShallow` often fixes the problem.
  37. ## What's Changed
  38. * v5 by @dai-shi in https://github.com/pmndrs/zustand/pull/2138
  39. * Fix Immer type inference for `setState` by @chrisvander in https://github.com/pmndrs/zustand/pull/2696
  41. ## New Contributors
  42. * @abernier made their first contribution in https://github.com/pmndrs/zustand/pull/2674
  43. * @tthallos made their first contribution in https://github.com/pmndrs/zustand/pull/2501
  44. * @sagiereder made their first contribution in https://github.com/pmndrs/zustand/pull/2673
  45. * @melutovich made their first contribution in https://github.com/pmndrs/zustand/pull/2692
  46. * @rgksugan made their first contribution in https://github.com/pmndrs/zustand/pull/2695
  47. * @Anuovec made their first contribution in https://github.com/pmndrs/zustand/pull/2708
  48. * @EthanRBrown made their first contribution in https://github.com/pmndrs/zustand/pull/2717
  49. * @mym0404 made their first contribution in https://github.com/pmndrs/zustand/pull/2730
  50. * @87xie made their first contribution in https://github.com/pmndrs/zustand/pull/2745
  51. * @f312213213 made their first contribution in https://github.com/pmndrs/zustand/pull/2761
  52. * @DanThemes made their first contribution in https://github.com/pmndrs/zustand/pull/2764
  53. * @chaficnajjar made their first contribution in https://github.com/pmndrs/zustand/pull/2770
  54. * @goosewobbler made their first contribution in https://github.com/pmndrs/zustand/pull/2781
  55. * @Amyssyko made their first contribution in https://github.com/pmndrs/zustand/pull/2784
  56. * @MartinGamesCZ made their first contribution in https://github.com/pmndrs/zustand/pull/2785
  58. **Full Changelog**: https://github.com/pmndrs/zustand/compare/v4.5.5...v5.0.0

ver en githubimported 2026-09-28 vía npm