Skip to content

Upgrading @vueuse/nuxt 14 to 15

Breaking14.4.0 → 15.0.0Breaking5Platform1New3Changed1Fixed9

Full comparisonBack to @vueuse/nuxt
BreakingUpgrade verdict

5 breaking changes and a platform requirement change.

In plain terms
  • The templateRef helper is removed, so code that imports or uses it will stop working.
  • Old timer options are gone; use the scheduler option instead.
  • Throttled functions now run once more at the end of the throttle window by default.
  • Server-sent event messages of type message now fire both the onmessage handler and addEventListener listeners, which can change how many times your code runs.
Must act Top 4 of 6 that need code or config changes

Requires Node.js >=22 from 15.0.0 (none stated before).

What you must change

Breaking5
Drops templateRef.
templateRef
15.0.0GitHub ReleaseSummarizedView source
Removes deprecated timer options in favor of scheduler in core.
scheduler
15.0.0GitHub ReleaseSummarizedView source
useThrottleFn changes default trailing option from false to true.
useThrottleFntrailing
15.0.0GitHub ReleaseSummarizedView source
useEventSource handles SSE message type and triggers both onmessage and addEventListener.
useEventSourceonmessageaddEventListener
15.0.0GitHub ReleaseSummarizedView source
useIDBKeyval syncs changes across tabs.
useIDBKeyval
15.0.0GitHub ReleaseSummarizedView source
Platform1
Drops support for Node.js 20.
15.0.0GitHub ReleaseSummarizedView source