Limitations of LWS for Aura Components

Here are some known limitations for Aura components running with LWS.

The top property must be used with these accessors.

  • window.top
  • globalThis.top
  • self.top

The location property must be used with these accessors.

  • window.location
  • document.location
  • globalThis.location
  • self.location
  • document.defaultView.location

These patterns produce runtime errors:

  • async/await
  • dynamic import

Aura components can’t use these techniques because they are features introduced in ES6, which isn’t supported in Aura. Use of this syntax is typically flagged by validation rules at development time.

If an Aura component uses a static resource that uses async/await or dynamic import, it’s not detected until runtime where the component encounters an error.