getFocusedSubtabObjectId()

Returns the object ID of the subtab on which the browser is focused. For example, a case ID or account ID. This method is only available in API version 24.0 or later.

Syntax

1sforce.console.getFocusedSubtabObjectId((optional)callback:Function)

Arguments

Name	Type	Description
callback	function	JavaScript method that’s called upon completion of the method.

Sample Code–Visualforce

1<apex:page standardController="Case">
2    <A HREF="#" onClick="testGetFocusedSubtabObjectId();">
3           Click here to get the object ID of the focused subtab</A> 
4
5    <apex:includeScript value="/support/console/55.0/integration.js"/>
6    <script type="text/javascript">
7        function testGetFocusedSubtabObjectId() {
8            sforce.console.getFocusedSubtabObjectId(showObjectId);
9        }
10            var showObjectId = function showObjectId(result) {
11                // Display the object ID
12            alert ('Object ID: ' + result.id);
13        };
14    </script>
15</apex:page>

To see this example in action, click the custom link on a case. For more information, see Define Custom Buttons and Links in the Salesforce help.

Note

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 object ID of the subtab on which the browser is focused. If no subtab is open, the ID is null.
success	boolean	`true` if returning the object ID of the focused subtab was successful; `false` if returning the object ID of the focused subtab wasn't successful.

Salesforce Console Developer Guide

getFocusedSubtabObjectId()

Syntax

Arguments

Sample Code–Visualforce

Response