Avoid Custom Properties on Standard JavaScript Objects

Adding custom properties directly to a standard built-in JavaScript object can cause issues when the object is serialized. When an object is passed across namespaces or into the global scope, Lightning Web Security (LWS) doesn’t reflect this kind of mutation for security reasons.

If you must add custom data to a DOM element, use the dataset property of DOM elements instead of adding custom properties to the element object.

See Also

Avoid Mutating Objects

Release Preview

This release is in preview. Features described here don't become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can't guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.