Note: 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.

addToBrowserTitleQueue() for Lightning Experience

Adds a string to a list of titles that rotate in the browser title bar every three seconds.This method works only in Lightning console apps. This method isn’t supported for Lightning Web Components (LWC).

Accurate browser tab titles help improve accessibility. Screen readers announce page titles when a page is first loaded, and don’t announce dynamic updates to the title. Use the root node of the document, like document.title, to announce the updated browser tab title instead.

Note

Arguments

Name	Type	Description
title	string	The browser tab title to add.

Aura Components Sample Code

This component has a button that, when pressed, adds a string to a list of titles that rotate in the browser title bar every three seconds.

Component code:

1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2    <lightning:workspaceAPI aura:id="workspace" />
3    <lightning:button label="Add to Browser Title Queue" onclick="{! c.handleAddToBrowserTitleQueue }" />
4</aura:component>

Controller code:

1({
2    handleAddToBrowserTitleQueue : function(component, event, helper) {
3        var workspaceAPI = component.find("workspace");
4        workspaceAPI.addToBrowserTitleQueue({
5            title: "New Browser Title"
6        })
7        .then(function(result){
8            console.log(result);
9        })
10        .catch(function(error) {
11            console.log(error);
12        });
13    }
14})

Response

This method returns a promise that, upon success, resolves to true.

Salesforce Console Developer Guide

addToBrowserTitleQueue() for Lightning Experience

Arguments

Aura Components Sample Code

Response