Salesforce Console Integration Toolkit Methods Supported in Lightning Console JavaScript API

This table lists the Salesforce Console Integration Toolkit methods that you can use in Lightning Console JavaScript API starting with API version 42.0.

Only API versions 42.0 and above of the Salesforce Console Integration Toolkit are supported in the Lightning Console JavaScript API.

Important

Salesforce Console Integration Toolkit methods that aren’t supported in Lightning Experience result in a failure error message.

Methods for Primary Tabs and Subtabs

Methods using objectId return 18-character, case-insensitive record IDs when invoked from within Lightning Console. When invoked from within Salesforce Classic, they return 15-character, case-sensitive record IDs.

Primary tab and subtab IDs in Lightning Console use a different format from Salesforce Classic primary tab and subtab IDs. Any code that validates the format of tab IDs must be updated or removed to account for the change. A Salesforce Classic Console tab ID can look like scc-pt-1 or scc-st-1. A Lightning Console tab ID looks like ctab1 or ctab1_3.

Note

Salesforce Classic Method	Supported in Lightning Console	Notes about Use in Lightning Console
`closeTab()`
`disableTabClose()`
`focusPrimaryTabById()`
`focusPrimaryTabByName()`
`focusSidebarComponent()`
`focusSubtabById()`
`focusSubtabByNameAndPrimaryTabId()`
`focusSubtabByNameAndPrimaryTabName()`
`generateConsoleUrl()`
`getEnclosingPrimaryTabId()`
`getEnclosingTabId()`
`getFocusedPrimaryTabId()`
`getFocusedPrimaryTabObjectId()`
`getFocusedSubtabId()`
`getFocusedSubtabObjectId()`
`getPageInfo()`	See notes	These fields aren’t supported and aren’t returned in the response: object displayName accountId contactId personAccount
`getPrimaryTabIds()`
`getSubtabIds()`
`getTabLink()`	See notes	The level argument `sforce.console.TabLink.PARENT_AND_CHILDREN` isn’t supported.
`isInConsole()`
`onEnclosingTabRefresh()`
`onFocusedPrimaryTab()`
`onFocusedSubtab()`
`onTabSave()`
`openConsoleUrl()`
`openPrimaryTab()`	See notes	Make sure to add third-party domains to the CSP Trusted Sites list. Note The following aren’t supported in the Lightning API: `id` argument `name` argument
`openSubtab()`	See notes	Make sure to add third-party domains to the CSP Trusted Sites list. Note The following aren’t supported in the Lightning API: `id` argument `name` argument
`openSubtabByPrimaryTabName()`
`refreshPrimaryTabById()`
`refreshPrimaryTabByName()`
`refreshSubtabById()`
`refreshSubtabByNameAndPrimaryTabId()`
`refreshSubtabByNameAndPrimaryTabName()`
`reopenLastClosedTab()`
`resetSessionTimeOut()`
`setTabUnsavedChanges()`
`setTabIcon()`	See notes	Only Salesforce Lightning Design System icons are supported for `iconUrl`. URLs and custom icons aren’t supported. Sample supported values: `sforce.console.setTabIcon(“standard:email”)` `sforce.console.setTabIcon(“action:new”)` `sforce.console.setTabIcon(“custom:custom1”)`
`setTabLink()`
`setTabStyle()`
`setTabTextStyle()`
`setTabTitle()`

Methods for Application-Level Custom Console Components

The following methods must be called from within a Lightning utility.

Salesforce Classic Method	Supported in Lightning Console	Notes about Use in Lightning Console
`addToBrowserTitleQueue()`
`blinkCustomConsoleComponentButtonText()`
`isCustomConsoleComponentPoppedOut()`
`isCustomConsoleComponentHidden()`
`isInCustomConsoleComponent()`
`onCustomConsoleComponentButtonClicked()`
`onFocusedPrimaryTab()`
`removeFromBrowserTitleQueue()`
`runSelectedMacro()`
`scrollCustomConsoleComponentButtonText()`
`selectMacro()`
`setCustomConsoleComponentButtonIconUrl()`	See notes	In Lightning Console, URL values for icons aren’t supported in utility bar utilities. Only Salesforce Lightning Design System are supported. Sample supported `iconUrl` values: `setCustomConsoleComponentButtonIconUrl("clock");` `setCustomConsoleComponentButtonIconUrl("utility:clock");`
`setCustomConsoleComponentButtonStyle()`
`setCustomConsoleComponentButtonText()`
`setCustomConsoleComponentHeight()`
`setCustomConsoleComponentVisible()`
`setCustomConsoleComponentWidth()`
`setCustomConsoleComponentPopoutable()`
`setCustomConsoleComponentWindowVisible()`
`setSidebarVisible()`

Methods for Navigation Tabs

Salesforce Classic Method	Supported in Lightning Console	Notes about Use in Lightning Console
`focusNavigationTab()`
`getNavigationTabs()`
`getSelectedNavigationTab()`
`refreshNavigationTab()`
`setSelectedNavigationTab()`

Methods for Console Events

Salesforce Classic Method	Supported in Lightning Console	Notes about Use in Lightning Console
`addEventListener()`		`sforce.console.ConsoleEvent.CONSOLE_LOGOUT` isn’t supported in the Lightning API. `sforce.console.ConsoleEvent.CLOSE_TAB` returns the ID of the closed tab only. The Lightning API doesn’t return the objectId or the tabObjectId. The Lightning API doesn’t return special message responses from custom keyboard shortcuts. However, if the response is from a console event, the message includes payload details.
`fireEvent()`	See notes	`fireEvent()` returns `success true` even when eventListeners for the given eventType are removed.
`removeEventListener()`

Salesforce Classic Method

Supported in Lightning Console

Notes about Use in Lightning Console

addEventListener()

sforce.console.ConsoleEvent.CONSOLE_LOGOUT isn’t supported in the Lightning API.

sforce.console.ConsoleEvent.CLOSE_TAB returns the ID of the closed tab only. The Lightning API doesn’t return the objectId or the tabObjectId.

The Lightning API doesn’t return special message responses from custom keyboard shortcuts. However, if the response is from a console event, the message includes payload details.

fireEvent()

See notes

fireEvent() returns success true even when eventListeners for the given eventType are removed.

removeEventListener()

Salesforce Console Developer Guide

Salesforce Console Integration Toolkit Methods Supported in Lightning Console JavaScript API

Methods for Primary Tabs and Subtabs

Methods for Application-Level Custom Console Components

Methods for Navigation Tabs

Methods for Console Events