Newer Version Available

This content describes an older version of this product. View Latest

Subscribe to Platform Event Notifications in a Lightning Component

Add the lightning:empApi component to your custom Lightning component to receive platform event messages. The lightning:empApi component provides access to methods for subscribing to a streaming channel and listening to event messages.

The lightning:empApi component uses a shared CometD-based Streaming API connection, enabling you to run multiple streaming apps in the browser.

To call the component’s methods, add the lightning:empApi component inside your custom component and assign an aura:id attribute to it.

<lightning:empApi aura:id="empApi"/>

Then in the client-side controller, add functions to call the component methods.

For an example of how to use the lightning:empApi component and a complete reference, see the empApi documentation in the Lightning Component Library.