Packages

@lwc/shared

9.5.3 · 27 Oct 2026MIT510.2k / weekRepositoryHomepagenpmAtom feed

Your version

5.0.0

major8 Nov 2023Where it was published

5.3.0 is the newest release of 5.x.

In short

2 breaking2 new8 internal

  • breaking

    LWC v5.0.0 contains breaking changes.

  • breaking

    Use comment nodes for VFragment bookends

Release note

LWC v5.0.0 contains breaking changes. Please read carefully below if you are upgrading from v4.

If you are upgrading from v3, please upgrade to v4 first.

Note

LWC v5 corresponds to Salesforce release Spring '24 (API version 60).

Breaking change

Empty comment nodes as VFragment bookends

Note

On the Salesforce Lightning platform, this change only applies to components with an API version of 60 or above.

Features like slots in light DOM, scoped slots and lwc:if use VFragment as virtual DOM nodes. The underlying implementation of VFragment used empty text nodes to aid the DOM diffing algorithm of @lwc/engine-core. With this change, the empty text nodes are replaced with empty comment nodes.

The impact of this change is expected to be minimal. Test snapshots may need to be updated, where new <!----> comment nodes show up. Additionally, some usage of DOM node APIs may be impacted. If you use childNode, nextSibling, etc in your code, there may be subtle changes in behavior.

  • breaking

    Use comment nodes for VFragment bookends

Other changes

  • Adding missing aria attributes

  • rollup-plugin: Expose enableStaticContentOptimization, test it