{"id":192966,"date":"2019-12-26T11:00:37","date_gmt":"2019-12-26T19:00:37","guid":{"rendered":"http:\/\/developer.salesforce.com\/blogs\/?p=192966"},"modified":"2025-11-05T02:21:14","modified_gmt":"2025-11-05T09:21:14","slug":"automated-testing-of-global-search-in-lightning-ui","status":"publish","type":"post","link":"https:\/\/developer.salesforce.com\/blogs\/2019\/12\/automated-testing-of-global-search-in-lightning-ui","title":{"rendered":"Automated Testing of Global Search in Lightning UI"},"content":{"rendered":"

We are excited to kick off a series of posts on Selenium WebDriver-based test automation best practices and tips for test engineers who are developing or maintaining test automation for Salesforce applications. Lightning Experience continues to evolve with modern web standards, and that evolution can have unintended impact on Selenium-based tests. Our posts will provide measures to deal with the changes introduced by the new web technologies.<\/p>\n

Not familiar with Selenium WebDriver? It is the de-facto standard<\/a> open-source-tool for testing web applications like the Salesforce app. Learn more about Selenium WebDriver on its home page<\/a> or this Wikipedia article<\/a>. This 5 Minute Getting Started Guide<\/a> leads you through the first steps to run tests automatically. In June 2013 the tool was also the topic of this Salesforce Developer blog post<\/a>.<\/p><\/blockquote>\n

In this first post, we cover automation of the global search field in the Lightning UI. The global search field is one of the most popular features used by end users, and many automated UI test cases will need to implement steps that work with this UI element. We\u2019ll start with a simple query and then move to more complicated settings \u2014 the use of categories for restricting the search and how to make the use of categories dynamic. By following the steps here, you will be able to automate these tasks in a fast yet robust way.<\/p>\n

Task 1: Enter a search term in the global search field and start the search<\/h3>\n

Here is a very simple, straight-forward implementation, assuming you have to test the UI in one language only and that would be English:<\/p>\n

01 WebElement inputBox = wd.findElement(By.xpath(\"\/\/input[@title='Search Salesforce']\"));\r\n02 inputBox.click();\r\n03 inputBox.clear();\r\n04 inputBox.sendKeys(\"CS88 Corp\");\r\n05 inputBox.click();\r\n06 wd.findElement(By.xpath(\"\/\/span[@title='CS88 Corp']\"));\r\n07 inputBox.sendKeys(Keys.RETURN);\r\n08 wd.findElement(By.xpath(\"\/\/a[@title='CS88 Corp']\"));<\/pre>\n
Line-by-line:<\/p>\n
    \n
  1. Line 1: If you are covering only a single UI user language, then searching for an element by using a UI text is the most simple differentiator. If you need to cover multiple languages, you could perhaps get the correct text from a dictionary. See the line-by-line description for Task 2 below for what the approach could look like.<\/li>\n
  2. Line 2: This click sets the cursor in the search box.<\/li>\n
  3. Line 3: Remove any previously entered text.<\/li>\n
  4. Line 4: Insert the search term of your choice.<\/li>\n
  5. Line 5: This click kicks off the search.<\/li>\n
  6. Line 6: Using findElement() is an easy way to assert that an element is present. If not, Selenium will throw a proper exception and your test will fail in a way you can easily triage the problem. Here we assert that the list of most recently used records is listing the record we are looking for.<\/li>\n
  7. Line 7: Sending a Return keystroke will finally kick off the search.<\/li>\n
  8. Line 8: Verify that the search returned the expected record.<\/li>\n<\/ol>\n
    You may have noticed that this code works without a single Thread.sleep() call! Why? Because WebDriver does a lot of things under-the-hood to ensure stable test execution. We will have more on this in a future post.<\/p>\n
    Is this the only way to implement testing the global search field? No, it\u2019s not. However, it is an approach which is both simple and robust.<\/p>\n
    Task 2: Select a category for filtering before entering a search term in the global search field<\/h3>\n
    For clarification purposes, this picture shows where you can set a category for filtering the search result:<\/p>\n
    \n\t\t\t  \n\t\t\t    \"\"\n\t\t\t  <\/span>\n\t\t\t
    \nThis code example builds on the above example:<\/p>\n
    01 WebElement inputBox = wd.findElement(By.xpath(\"\/\/input[@title='\" + getSearchHint() + \"']\"));\r\n02 WebElement categoryHome = wd.findElement(By.xpath(\"\/\/input[@id='input-5']\"));\r\n03 categoryHome.click();\r\n04 wd.findElement(By.xpath(\"\/\/lightning-base-combobox-item[@id='input-5-1-5']\")).click();\r\n05 inputBox = wd.findElement(By.xpath(\"\/\/input[@title='Search \" + getSearchHintForAccounts() + \"']\"));\r\n06 inputBox.click();\r\n07 inputBox.clear();\r\n08 inputBox.sendKeys(\"CS88 Corp\");\r\n09 inputBox.click();\r\n10 wd.findElement(By.xpath(\"\/\/span[@title='CS88 Corp']\"));\r\n11 inputBox.sendKeys(Keys.RETURN);\r\n12 wd.findElement(By.xpath(\"\/\/a[@title='CS88 Corp']\"));<\/pre>\n
    Line-by-line unless covered in Task 1:<\/p>\n
      \n
    1. Line 1: This assumes getSearchHint() gets you the right text from a dictionary which is based on UI user language setting. I leave the implementation of getSearchHint() up to you.<\/li>\n
    2. Line 2: This is the input field directly on the left side of the global search box. The use of By.xpath instead of By.id<\/a> is intentional and is because of Lighting Web Components (LWC). We will have more on this in a later post.<\/li>\n
    3. Line 3: A click in that input field expands the list of categories the user can choose from.<\/li>\n
    4. Line 4: Finding any entry in the list is actually quite tricky, because a right-mouse click on it to inspect in your browser\u2019s developer console makes the list vanish without updating the console. However, once you have expanded the list and are inspecting the input field in the console, you will find an attribute of type \u201caria-activedescendant\u201d. This short video<\/a> shows how.<\/li>\n
    5. Line 5: Now that a filter is established, the selector for the input box needs an update. If your user language setting is English, the title<\/b> attribute needs to have the value \u201cSearch Accounts\u201d. Similar to line 1, we call a dictionary to get right text based on the UI user language setting.<\/li>\n
    6. Lines 6-12: See comments for lines 2-8 for Task 1.<\/li>\n<\/ol>\n
      As mentioned above, this too is technically, still pretty simple, don\u2019t you agree? The exception is of course figuring out how to get to the right element in the list of categories. In the next example we will explore how to use an arbitrary category name.<\/p>\n
      Task 3: Select a category by name for filtering<\/h3>\n
      This code example is a variation of the above example:<\/p>\n
      01 WebElement inputBox = wd.findElement(By.xpath(\"\/\/input[@title='\" + getSearchHint() + \"']\"));\r\n02 WebElement categoryHome = wd.findElement(By.xpath(\"\/\/input[@id='input-5']\"));\r\n03 categoryHome.click();\r\n04 wd.findElement(By.xpath(\"\/\/lightning-base-combobox-item[@data-value='FILTER:Account:Accounts']\")).click();\r\n05 inputBox = wd.findElement(By.xpath(\"\/\/input[@title='Search \" + getSearchHintForAccounts() + \"']\"));\r\n06 inputBox.click();\r\n07 inputBox.clear();\r\n08 inputBox.sendKeys(\"CS88 Corp\");\r\n09 inputBox.click();\r\n10 wd.findElement(By.xpath(\"\/\/span[@title='CS88 Corp']\"));\r\n11 inputBox.sendKeys(Keys.RETURN);\r\n12 sleep(1000L);\r\n13 wd.findElement(By.xpath(\"\/\/a[@title='CS88 Corp']\"));<\/pre>\n
      Line-by-line unless covered in Task 2:<\/p>\n
        \n
      1. Lines 1-3. See comments for same lines for Task 2<\/li>\n
      2. Line 4. The interesting part here is the value of the attribute data-value<\/b>. It is a concatenation of the object\u2019s API name in its singular form (\u201cAccount\u201d) and its plural form (\u201cAccounts\u201d) as defined in Setup. Hence this value will be the same even if using a different UI user language.<\/li>\n
      3. Line 5-11. See comments for same lines for Task 2.<\/li>\n
      4. Line 12. This is one of the rare examples where a Thread.sleep() call is actually required! We need to wait for the page to display the list of records found. If you leave the call out, the UI sometimes opens the record right away and the command on the next line will fail. We will have more on judicious uses of Thread.sleep() in a future post.<\/li>\n
      5. Line 13. See comments for line 12 for Task 2.<\/li>\n<\/ol>\n
        The examples in this post show how to:<\/p>\n