`unregisterRefreshHandler()`

Removes a component’s refresh handler method from the refresh process.

Syntax

1import { LightningElement, wire } from "lwc";
2import { unregisterRefreshHandler } from "lightning/refresh";
3
4export function unregisterRefreshHandler(refreshID);

Parameters

refreshID—(Required) A numeric refreshNode.handle value that uniquely identifies the node of this component on the refresh tree. You obtain the refreshNode.handle value when you call registerRefreshHandler().

Returns

None.

Usage

Use the unregisterRefreshHandler() method to remove a refresh handler’s registration from the refresh tree. Child contexts are temporarily retained to ensure that they are refreshed, in case unregistration takes place mid-refresh.

You must unregister your component’s handler callback methods in disconnectedCallback().

1import { unregisterRefreshHandler } from 'lightning/refresh';
2
3disconnectedCallback() {
4  unregisterRefreshHandler(this.refreshHandlerID);
5}

See Also

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.