Newer Version Available

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

onEnclosingTabRefresh()

Registers a function to call when the enclosing tab refreshes. This method is only available in API version 24.0 or later.

Syntax

1sforce.console.onEnclosingTabRefresh(eventHandler:Function)

Arguments

Name Type Description
eventHandler function JavaScript method called when the enclosing tab refreshes.

Sample Code–Visualforce

1<apex:page>
2
3    <apex:includeScript value="/support/console/59.0/integration.js"/>
4
5    <script type="text/javascript">
6        var eventHandler = function eventHandler(result) {
7            alert('Enclosing tab has refreshed:' + result.id 
8          + 'and the object Id is:' + result.objectId);
9        };
10            sforce.console.onEnclosingTabRefresh(eventHandler);
11    </script>
12</apex:page>

Event Handler Response

This method is asynchronous so it returns its response in an object in a callback method. The response object contains the following fields:

Name Type Description
id string The ID of the refreshed tab.
objectId string The object ID of the refreshed tab or null if no object exists.