@redhat-developer/page-objects 1.19.1 → 1.21.0

package/out/components/AbstractElement.d.ts

@@ -33,7 +33,7 @@ export interface LocatorInfo {
 export declare abstract class AbstractElement extends WebElement {
     static readonly ctlKey: string;
     protected static driver: WebDriver;
-    protected static locators: Locators;
+    protected static locators: Locators & Record<string, Record<string, unknown>>;
     protected static versionInfo: {
         version: string;
         browser: string;

package/out/components/AbstractElement.js

@@ -252,7 +252,7 @@ class AbstractElement extends selenium_webdriver_1.WebElement {
      */
     async safeGetAttribute(name) {
         return await this.withRecovery(async (self) => {
-            return await self.getAttribute(name);
+            return (await self.getAttribute(name));
         });
     }
 }

package/out/components/activityBar/ActionsControl.js

@@ -36,7 +36,7 @@ class ActionsControl extends ElementWithContextMenu_1.ElementWithContextMenu {
      * Returns the title of the associated action
      */
     async getTitle() {
-        return await this.getAttribute('aria-label');
+        return (await this.getAttribute('aria-label'));
     }
 }
 exports.ActionsControl = ActionsControl;

package/out/components/activityBar/ViewControl.js

@@ -34,12 +34,12 @@ class ViewControl extends ElementWithContextMenu_1.ElementWithContextMenu {
      */
     async openView() {
         // Check whether view is already open
-        const klass = await this.getAttribute(ViewControl.locators.ViewControl.attribute);
+        const klass = (await this.getAttribute(ViewControl.locators.ViewControl.attribute));
         if (klass.indexOf(ViewControl.locators.ViewControl.klass) < 0) {
             await this.click();
             // Wait for view to be marked as active
             await this.getWaitHelper().forCondition(async () => {
-                const newKlass = await this.getAttribute(ViewControl.locators.ViewControl.attribute);
+                const newKlass = (await this.getAttribute(ViewControl.locators.ViewControl.attribute));
                 return newKlass.includes(ViewControl.locators.ViewControl.klass);
             }, { timeout: 2000, pollInterval: 100 });
         }
@@ -60,7 +60,7 @@ class ViewControl extends ElementWithContextMenu_1.ElementWithContextMenu {
      * @returns Promise resolving when the view closes
      */
     async closeView() {
-        const klass = await this.getAttribute(ViewControl.locators.ViewControl.attribute);
+        const klass = (await this.getAttribute(ViewControl.locators.ViewControl.attribute));
         if (klass.indexOf(ViewControl.locators.ViewControl.klass) > -1) {
             await this.click();
         }
@@ -70,7 +70,7 @@ class ViewControl extends ElementWithContextMenu_1.ElementWithContextMenu {
      */
     async getTitle() {
         const badge = await this.findElement(ViewControl.locators.ViewControl.badge);
-        return await badge.getAttribute('aria-label');
+        return (await badge.getAttribute('aria-label'));
     }
 }
 exports.ViewControl = ViewControl;

package/out/components/bottomBar/AbstractViews.js

@@ -35,7 +35,7 @@ class ChannelView extends ElementWithContextMenu_1.ElementWithContextMenu {
         await Promise.all(elements.map(async (element) => {
             const disabled = await element.getAttribute('disabled');
             if (!disabled) {
-                names.push(await element.getAttribute('value'));
+                names.push((await element.getAttribute('value')));
             }
         }));
         return names;
@@ -50,7 +50,7 @@ class ChannelView extends ElementWithContextMenu_1.ElementWithContextMenu {
             throw Error(`DEPRECATED METHOD! The 'ChannelView.getCurrentChannel' method is broken! Read more information in 'Known Issues > Limitations in testing with VS Code 1.87+' - https://github.com/microsoft/vscode/issues/206897.`);
         }
         const combo = await this.enclosingItem.findElement(ChannelView.locators.BottomBarViews.channelCombo);
-        return await combo.getAttribute(ChannelView.locators.OutputView.currentChannelAttribute);
+        return (await combo.getAttribute(ChannelView.locators.OutputView.currentChannelAttribute));
     }
     /**
      * Select a channel using the selector combo

package/out/components/bottomBar/ProblemsView.js

@@ -125,7 +125,7 @@ class Marker extends ElementWithContextMenu_1.ElementWithContextMenu {
      * @returns Promise resolving to a Marker row text
      */
     async getText() {
-        return await this.getAttribute(ProblemsView.locators.ProblemsView.rowLabel);
+        return (await this.getAttribute(ProblemsView.locators.ProblemsView.rowLabel));
     }
     /**
      * Get the Marker label text
@@ -141,7 +141,7 @@ class Marker extends ElementWithContextMenu_1.ElementWithContextMenu {
      */
     async toggleExpand(expand) {
         if ((await this.getType()) === MarkerType.File) {
-            const klass = await this.findElement(ProblemsView.locators.ProblemsView.markerTwistie).getAttribute('class');
+            const klass = (await this.findElement(ProblemsView.locators.ProblemsView.markerTwistie).getAttribute('class'));
             if (klass.indexOf('collapsed') > -1 === expand) {
                 await this.click();
             }

package/out/components/bottomBar/Views.js

@@ -226,7 +226,7 @@ class TerminalView extends AbstractViews_1.ChannelView {
         const rows = await list.findElements(TerminalView.locators.TerminalView.row);
         for (const row of rows) {
             const label = await row.getAttribute('aria-label');
-            if (label.includes(channelNumber)) {
+            if (label?.includes(channelNumber)) {
                 await row.click();
                 return;
             }

package/out/components/editor/ContentAssist.js

@@ -63,7 +63,7 @@ class ContentAssist extends __1.Menu {
     async getItems() {
         await this.getDriver().wait(async () => {
             return await this.isLoaded();
-        });
+        }, 10000);
         const elements = await this.findElement(ContentAssist.locators.ContentAssist.itemRows).findElements(ContentAssist.locators.ContentAssist.itemRow);
         const items = [];
         for (const item of elements) {
@@ -84,12 +84,15 @@ class ContentAssist extends __1.Menu {
      * to false otherwise
      */
     async isLoaded() {
-        const message = await this.findElement(ContentAssist.locators.ContentAssist.message);
-        if (await message.isDisplayed()) {
-            if ((await message.getText()).startsWith('No suggestions')) {
-                return true;
-            }
-            return false;
+        const messages = await this.findElements(ContentAssist.locators.ContentAssist.message);
+        if (messages.length === 0) {
+            return true;
+        }
+        if (await messages[0].isDisplayed()) {
+            const text = await messages[0].getText();
+            // Empty message means loaded; "No suggestions" is also a terminal state.
+            // Any other non-empty text (e.g. "Loading...") means still loading.
+            return text === '' || text.startsWith('No suggestions');
         }
         return true;
     }

package/out/components/editor/CustomEditor.js

@@ -36,7 +36,7 @@ class CustomEditor extends __1.Editor {
      */
     async isDirty() {
         const tab = await this.getTab();
-        const klass = await tab.getAttribute('class');
+        const klass = (await tab.getAttribute('class'));
         return klass.includes('dirty');
     }
     /**

package/out/components/editor/EditorAction.js

@@ -26,7 +26,7 @@ class BaseEditorAction extends ActionButtonElementDropdown_1.ActionButtonElement
      * Get text description of the action.
      */
     async getTitle() {
-        return await this.getAttribute(BaseEditorAction.locators.EditorView.attribute);
+        return (await this.getAttribute(BaseEditorAction.locators.EditorView.attribute));
     }
 }
 class EditorAction extends BaseEditorAction {

package/out/components/editor/SettingsEditor.js

@@ -203,7 +203,7 @@ exports.Setting = Setting;
 class ComboSetting extends Setting {
     async getValue() {
         const combo = await this.findElement(SettingsEditor.locators.SettingsEditor.comboSetting);
-        return await combo.getAttribute(SettingsEditor.locators.SettingsEditor.comboValue);
+        return (await combo.getAttribute(SettingsEditor.locators.SettingsEditor.comboValue));
     }
     async setValue(value) {
         const rows = await this.getOptions();
@@ -233,7 +233,7 @@ class ComboSetting extends Setting {
         const rows = await this.getOptions();
         for (const row of rows) {
             try {
-                values.push(await row.getAttribute(SettingsEditor.locators.SettingsEditor.comboValue));
+                values.push((await row.getAttribute(SettingsEditor.locators.SettingsEditor.comboValue)));
             }
             catch (e) {
                 if (e.name === 'StaleElementReferenceError') {
@@ -256,7 +256,7 @@ exports.ComboSetting = ComboSetting;
 class TextSetting extends Setting {
     async getValue() {
         const input = await this.findElement(SettingsEditor.locators.SettingsEditor.textSetting);
-        return await input.getAttribute('value');
+        return (await input.getAttribute('value'));
     }
     async setValue(value) {
         const input = await this.findElement(SettingsEditor.locators.SettingsEditor.textSetting);

package/out/components/editor/TextEditor.d.ts

@@ -223,6 +223,7 @@ export declare class TextEditor extends Editor {
      * **Caution** line & column coordinates do not start at `0` but at `1`!
      */
     getCoordinates(): Promise<[number, number]>;
+    private getTabSize;
     /**
      * Toggle breakpoint on a given line
      *

package/out/components/editor/TextEditor.js

@@ -40,7 +40,7 @@ class TextEditor extends Editor_1.Editor {
      */
     async isDirty() {
         const tab = await this.enclosingItem.findElement(TextEditor.locators.TextEditor.activeTab);
-        const klass = await tab.getAttribute('class');
+        const klass = (await tab.getAttribute('class'));
         return klass.indexOf('dirty') >= 0;
     }
     /**
@@ -67,7 +67,7 @@ class TextEditor extends Editor_1.Editor {
      */
     async getFileUri() {
         const ed = await this.findElement(TextEditor.locators.TextEditor.editorContainer);
-        return await ed.getAttribute(TextEditor.locators.TextEditor.dataUri);
+        return (await ed.getAttribute(TextEditor.locators.TextEditor.dataUri));
     }
     /**
      * Retrieve the path to the file opened in the active editor
@@ -87,7 +87,7 @@ class TextEditor extends Editor_1.Editor {
             let isHidden = true;
             try {
                 const assist = await self.findElement(TextEditor.locators.ContentAssist.constructor);
-                const klass = await assist.getAttribute('class');
+                const klass = (await assist.getAttribute('class'));
                 const visibility = await assist.getCssValue('visibility');
                 isHidden = klass.indexOf('visible') < 0 || visibility === 'hidden';
             }
@@ -236,7 +236,7 @@ class TextEditor extends Editor_1.Editor {
         if (lineNum < 1) {
             throw new Error(`Text '${text}' not found`);
         }
-        await this.moveCursor(lineNum, column);
+        await this.setCursor(lineNum, column);
         let actions = this.getDriver().actions();
         await actions.clear();
         actions.keyDown(selenium_webdriver_1.Key.SHIFT);
@@ -320,7 +320,7 @@ class TextEditor extends Editor_1.Editor {
      * @returns Promise resolving when the text is typed in
      */
     async typeTextAt(line, column, text) {
-        await this.moveCursor(line, column);
+        await this.setCursor(line, column);
         await this.typeText(text);
     }
     /**
@@ -489,11 +489,15 @@ class TextEditor extends Editor_1.Editor {
         let column = -1;
         let found = 0;
         const lines = (await this.getText()).split('\n');
+        const tabSize = await this.getTabSize();
         for (let i = 0; i < lines.length; i++) {
             let searchIndex = -1; // start at the beginning of the line
             while ((searchIndex = lines[i].indexOf(text, searchIndex)) > -1) {
                 found++;
-                column = searchIndex + 1;
+                // Compute offset for tabs
+                const nTabs = lines[i].substring(0, searchIndex + 1).split('\t').length - 1;
+                const tabOffset = nTabs * (tabSize - 1); // 1 character per tab has already been counted ('\t') - now offset for the tab size
+                column = searchIndex + 1 + tabOffset;
                 line = i + 1;
                 if (found >= occurrence) {
                     return [line, column];
@@ -559,6 +563,12 @@ class TextEditor extends Editor_1.Editor {
         }
         return [coords[0], coords[1]];
     }
+    async getTabSize() {
+        const statusBar = new StatusBar_1.StatusBar();
+        const indent = await statusBar.getCurrentIndentation();
+        const matches = indent.match(/\d+/g);
+        return +matches[0];
+    }
     /**
      * Toggle breakpoint on a given line
      *
@@ -795,7 +805,7 @@ class CodeLens extends AbstractElement_1.AbstractElement {
      * @returns tooltip as string
      */
     async getTooltip() {
-        return await this.getAttribute('title');
+        return (await this.getAttribute('title'));
     }
 }
 exports.CodeLens = CodeLens;
@@ -817,7 +827,7 @@ class FindWidget extends AbstractElement_1.AbstractElement {
      */
     async toggleReplace(replace) {
         const btn = await this.findElement(FindWidget.locators.FindWidget.toggleReplace);
-        const klass = await btn.getAttribute('class');
+        const klass = (await btn.getAttribute('class'));
         if ((replace && klass.includes('collapsed')) || (!replace && !klass.includes('collapsed'))) {
             await btn.sendKeys(selenium_webdriver_1.Key.SPACE);
             const repl = await this.getDriver().wait(selenium_webdriver_1.until.elementLocated(FindWidget.locators.FindWidget.replacePart), 2000);
@@ -843,7 +853,7 @@ class FindWidget extends AbstractElement_1.AbstractElement {
      */
     async getSearchText() {
         const findPart = await this.findElement(FindWidget.locators.FindWidget.findPart);
-        return await this.getInputText(findPart);
+        return (await this.getInputText(findPart));
     }
     /**
      * Set text in the replace box. Will toggle replace mode on if called in find mode.
@@ -860,7 +870,7 @@ class FindWidget extends AbstractElement_1.AbstractElement {
      */
     async getReplaceText() {
         const replacePart = await this.findElement(FindWidget.locators.FindWidget.replacePart);
-        return await this.getInputText(replacePart);
+        return (await this.getInputText(replacePart));
     }
     /**
      * Click 'Next match'

package/out/components/menu/ContextMenu.js

@@ -61,7 +61,7 @@ class ContextMenu extends __1.Menu {
         const elements = await this.findElements(ContextMenu.locators.ContextMenu.itemElement);
         for (const element of elements) {
             try {
-                const klass = await element.getAttribute('class');
+                const klass = (await element.getAttribute('class'));
                 if (klass.indexOf('disabled') < 0) {
                     items.push(await new ContextMenuItem(element, this).wait());
                 }
@@ -158,7 +158,7 @@ class ContextMenuItem extends __1.MenuItem {
     }
     async getLabel() {
         const labelItem = await this.findElement(ContextMenu.locators.ContextMenu.itemLabel);
-        return await labelItem.getAttribute(ContextMenu.locators.ContextMenu.itemText);
+        return (await labelItem.getAttribute(ContextMenu.locators.ContextMenu.itemText));
     }
     async isNesting() {
         try {

package/out/components/menu/TitleBar.js

@@ -52,7 +52,7 @@ class TitleBar extends Menu_1.Menu {
         for (const element of elements) {
             try {
                 if (await element.isDisplayed()) {
-                    items.push(await new TitleBarItem(await element.getAttribute(TitleBar.locators.TitleBar.itemLabel), this).wait());
+                    items.push(await new TitleBarItem((await element.getAttribute(TitleBar.locators.TitleBar.itemLabel)), this).wait());
                 }
             }
             catch (e) {

package/out/components/sidebar/ViewSection.js

@@ -35,7 +35,7 @@ class ViewSection extends AbstractElement_1.AbstractElement {
      */
     async getTitle() {
         const title = await this.findElement(ViewSection.locators.ViewSection.title);
-        return await title.getAttribute(ViewSection.locators.ViewSection.titleText);
+        return (await title.getAttribute(ViewSection.locators.ViewSection.titleText));
     }
     /**
      * Expand the section if collapsed
@@ -186,7 +186,7 @@ class BaseViewPanelAction extends ActionButtonElementDropdown_1.ActionButtonElem
      * Get label of the action button
      */
     async getLabel() {
-        return await this.getAttribute(BaseViewPanelAction.locators.ViewSection.buttonLabel);
+        return (await this.getAttribute(BaseViewPanelAction.locators.ViewSection.buttonLabel));
     }
     /**
      * Wait for the action button to be located within a given timeout.

package/out/components/sidebar/ViewTitlePart.js

@@ -42,7 +42,7 @@ class ViewTitlePart extends ElementWithContextMenu_1.ElementWithContextMenu {
         const actions = [];
         const elements = await this.findElements(ViewTitlePart.locators.ViewTitlePart.action);
         for (const element of elements) {
-            const title = await element.getAttribute(ViewTitlePart.locators.ViewTitlePart.actionLabel);
+            const title = (await element.getAttribute(ViewTitlePart.locators.ViewTitlePart.actionLabel));
             actions.push(await new TitleActionButton(TitleActionButton.locators.ViewTitlePart.actionConstructor(title), this).wait());
         }
         return actions;
@@ -68,7 +68,7 @@ class TitleActionButton extends AbstractElement_1.AbstractElement {
      * Get title of the button
      */
     async getTitle() {
-        return await this.getAttribute(TitleActionButton.locators.ViewTitlePart.actionLabel);
+        return (await this.getAttribute(TitleActionButton.locators.ViewTitlePart.actionLabel));
     }
 }
 exports.TitleActionButton = TitleActionButton;

package/out/components/sidebar/debug/DebugView.d.ts

@@ -45,6 +45,16 @@ export declare class DebugView extends SideBarView {
      * @param title title of the configuration to select
      */
     selectLaunchConfiguration(title: string): Promise<void>;
+    /**
+     * Opens the launch config dropdown overlay, waiting until it is visible.
+     * If it is already open (context-view-pointerBlock present) the click is skipped.
+     * @returns the context-view element to scope subsequent searches against
+     */
+    private openLaunchDropdown;
+    /**
+     * Closes the launch config dropdown by sending Escape to the filter input that holds focus.
+     */
+    private closeLaunchDropdown;
     /**
      * Start Debugging using the current launch configuration
      */

package/out/components/sidebar/debug/DebugView.js

@@ -18,6 +18,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DebugView = void 0;
 const compare_versions_1 = require("compare-versions");
+const selenium_webdriver_1 = require("selenium-webdriver");
 const SideBarView_1 = require("../SideBarView");
 const DebugBreakpointSection_1 = require("../tree/debug/DebugBreakpointSection");
 const DebugCallStackSection_1 = require("../tree/debug/DebugCallStackSection");
@@ -34,26 +35,22 @@ class DebugView extends SideBarView_1.SideBarView {
      */
     async getLaunchConfiguration() {
         if ((0, compare_versions_1.satisfies)(DebugView.versionInfo.version, '>=1.87.0') && process.platform !== 'darwin') {
-            throw Error(`DEPRECATED METHOD! The 'DebugView.getLaunchConfiguration' method is broken! Read more information in 'Known Issues > Limitations in testing with VS Code 1.87+' - https://github.com/microsoft/vscode/issues/206897.`);
+            throw new Error(`DEPRECATED METHOD! The 'DebugView.getLaunchConfiguration' method is broken! Read more information in 'Known Issues > Limitations in testing with VS Code 1.87+' - https://github.com/microsoft/vscode/issues/206897.`);
         }
         const action = await this.getTitlePart().findElement(DebugView.locators.DebugView.launchCombo);
-        const combo = await action.findElement(DebugView.locators.DebugView.launchSelect);
-        return await combo.getAttribute(DebugView.locators.DebugView.launchSelectAttribute);
+        return await action.getText();
     }
     /**
      * Get titles of all available launch configurations
      * @returns Promise resolving to list of titles
      */
     async getLaunchConfigurations() {
-        const action = await this.getTitlePart().findElement(DebugView.locators.DebugView.launchCombo);
-        const combo = await action.findElement(DebugView.locators.DebugView.launchSelect);
+        const contextView = await this.openLaunchDropdown();
         const configs = [];
-        const options = await combo.findElements(DebugView.locators.DebugView.launchOption);
+        const options = await contextView.findElements(DebugView.locators.DebugView.launchOption);
         for (const option of options) {
             try {
-                if (await option.isEnabled()) {
-                    configs.push(await option.getAttribute('value'));
-                }
+                configs.push((await option.getAttribute(DebugView.locators.DebugView.launchSelectAttribute)));
             }
             catch (e) {
                 if (e.name === 'StaleElementReferenceError') {
@@ -62,6 +59,7 @@ class DebugView extends SideBarView_1.SideBarView {
                 throw e;
             }
         }
+        await this.closeLaunchDropdown();
         return configs;
     }
     async getVariablesSection() {
@@ -81,10 +79,44 @@ class DebugView extends SideBarView_1.SideBarView {
      * @param title title of the configuration to select
      */
     async selectLaunchConfiguration(title) {
-        const action = await this.getTitlePart().findElement(DebugView.locators.DebugView.launchCombo);
-        const combo = await action.findElement(DebugView.locators.DebugView.launchSelect);
-        const option = await combo.findElement(DebugView.locators.DebugView.optionByName(title));
-        await option.click();
+        const contextView = await this.openLaunchDropdown();
+        const option = await contextView.findElement(DebugView.locators.DebugView.optionByName(title));
+        // context-view-pointerBlock overlays the list and intercepts regular clicks —
+        // use JavaScript click to bypass it.
+        await this.getDriver().executeScript('arguments[0].click()', option);
+        // Wait for the overlay to be dismissed so subsequent operations are not blocked.
+        await this.getDriver()
+            .wait(selenium_webdriver_1.until.elementIsNotVisible(contextView), 2000)
+            .catch(() => {
+            // If already gone, that's fine.
+        });
+    }
+    /**
+     * Opens the launch config dropdown overlay, waiting until it is visible.
+     * If it is already open (context-view-pointerBlock present) the click is skipped.
+     * @returns the context-view element to scope subsequent searches against
+     */
+    async openLaunchDropdown() {
+        // context-view persists in the DOM between uses (display:none when closed).
+        // Only click to open if it is not currently visible.
+        const existingViews = await this.getDriver().findElements(DebugView.locators.ContextMenu.contextView);
+        const isOpen = existingViews.length > 0 && (await existingViews[0].isDisplayed());
+        if (!isOpen) {
+            const action = await this.getTitlePart().findElement(DebugView.locators.DebugView.launchCombo);
+            await action.click();
+        }
+        const contextView = await this.getDriver().wait(selenium_webdriver_1.until.elementLocated(DebugView.locators.ContextMenu.contextView), 2000);
+        await this.getDriver().wait(selenium_webdriver_1.until.elementIsVisible(contextView), 2000);
+        // Wait until at least one option row is present inside the overlay
+        await this.getDriver().wait(async () => (await contextView.findElements(DebugView.locators.DebugView.launchOption)).length > 0, 2000);
+        return contextView;
+    }
+    /**
+     * Closes the launch config dropdown by sending Escape to the filter input that holds focus.
+     */
+    async closeLaunchDropdown() {
+        const input = await this.getDriver().findElement(selenium_webdriver_1.By.className('action-list-filter-input'));
+        await input.sendKeys('\uE00C'); // Escape
     }
     /**
      * Start Debugging using the current launch configuration

package/out/components/sidebar/extensions/ExtensionsViewItem.js

@@ -42,7 +42,7 @@ class ExtensionsViewItem extends ViewItem_1.ViewItem {
         if (version.length > 0) {
             return await version[0].getText();
         }
-        const label = await this.getAttribute('aria-label');
+        const label = (await this.getAttribute('aria-label'));
         const ver = label.split(',')[1].trim();
         return ver;
     }

package/out/components/sidebar/scm/NewScmView.js

@@ -64,7 +64,7 @@ class SingleScmProvider extends ScmView_1.ScmProvider {
         const buttons = [];
         if ((0, compare_versions_1.satisfies)(ScmView_1.ScmProvider.versionInfo.version, '>=1.93.0')) {
             actions = await this.getProviderHeaderActions(view);
-            names = await Promise.all(actions.map(async (action) => await action.getAttribute(ScmView_1.ScmProvider.locators.ScmView.actionLabel)));
+            names = await Promise.all(actions.map(async (action) => (await action.getAttribute(ScmView_1.ScmProvider.locators.ScmView.actionLabel))));
         }
         else {
             const titlePart = view.getTitlePart();

package/out/components/sidebar/scm/ScmView.js

@@ -75,13 +75,13 @@ class ScmProvider extends AbstractElement_1.AbstractElement {
      * Get title of the scm provider
      */
     async getTitle() {
-        return await this.findElement(ScmProvider.locators.ScmView.providerTitle).getAttribute('innerHTML');
+        return (await this.findElement(ScmProvider.locators.ScmView.providerTitle).getAttribute('innerHTML'));
     }
     /**
      * Get type of the scm provider (e.g. Git)
      */
     async getType() {
-        return await this.findElement(ScmProvider.locators.ScmView.providerType).getAttribute('innerHTML');
+        return (await this.findElement(ScmProvider.locators.ScmView.providerType).getAttribute('innerHTML'));
     }
     /**
      * Find an action button for the SCM provider by title and click it. (e.g 'Commit')

package/out/components/sidebar/tree/custom/CustomTreeItem.js

@@ -29,7 +29,8 @@ class CustomTreeItem extends ViewItem_1.TreeItem {
         return await this.findElement(CustomTreeItem.locators.CustomTreeSection.itemLabel).getText();
     }
     async getTooltip() {
-        return await this.getAttribute(CustomTreeItem.locators.CustomTreeItem.tooltipAttribute);
+        const resourceItem = await this.findElement(CustomTreeItem.locators.CustomTreeItem.tooltipElement);
+        return (await resourceItem.getAttribute(CustomTreeItem.locators.CustomTreeItem.tooltipAttribute));
     }
     async getDescription() {
         return await this.findElement(CustomTreeItem.locators.CustomTreeItem.description).getText();

package/out/components/sidebar/tree/debug/CallStackItem.js

@@ -28,7 +28,7 @@ class CallStackItem extends CustomTreeItem_1.CustomTreeItem {
      */
     async getLabel() {
         const name = await this.findElement(CallStackItem.locators.CallStackItem.label);
-        return await name?.getAttribute('textContent');
+        return (await name?.getAttribute('textContent'));
     }
     /**
      * Get text of the Call Stack item.

package/out/components/sidebar/tree/debug/WatchSectionItem.js

@@ -28,7 +28,7 @@ class WatchSectionItem extends CustomTreeItem_1.CustomTreeItem {
      */
     async getLabel() {
         const name = await this.findElement(WatchSectionItem.locators.WatchSectionItem.label);
-        return await name?.getAttribute('textContent');
+        return (await name?.getAttribute('textContent'));
     }
     /**
      * Get value of the Watch section item.

package/out/components/sidebar/tree/default/DefaultTreeItem.js

@@ -35,10 +35,10 @@ class DefaultTreeItem extends ViewItem_1.TreeItem {
     }
     async getTooltip() {
         const tooltip = await this.findElement(DefaultTreeItem.locators.DefaultTreeItem.tooltip);
-        return await tooltip.getAttribute(DefaultTreeItem.locators.DefaultTreeItem.labelAttribute);
+        return (await tooltip.getAttribute(DefaultTreeItem.locators.DefaultTreeItem.labelAttribute));
     }
     async isExpanded() {
-        const twistieClass = await this.findElement(DefaultTreeItem.locators.DefaultTreeItem.twistie).getAttribute('class');
+        const twistieClass = (await this.findElement(DefaultTreeItem.locators.DefaultTreeItem.twistie).getAttribute('class'));
         return twistieClass.indexOf('collapsed') < 0;
     }
     async getChildren() {
@@ -47,7 +47,7 @@ class DefaultTreeItem extends ViewItem_1.TreeItem {
         return items;
     }
     async isExpandable() {
-        const twistieClass = await this.findElement(DefaultTreeItem.locators.DefaultTreeItem.twistie).getAttribute('class');
+        const twistieClass = (await this.findElement(DefaultTreeItem.locators.DefaultTreeItem.twistie).getAttribute('class'));
         return twistieClass.indexOf('collapsible') > -1;
     }
 }

package/out/components/statusBar/StatusBar.js

@@ -157,7 +157,7 @@ class StatusBar extends AbstractElement_1.AbstractElement {
     async toggleNotificationsCentre(open) {
         let visible = false;
         try {
-            const klass = await this.enclosingItem.findElement(StatusBar.locators.StatusBar.notifications).getAttribute('class');
+            const klass = (await this.enclosingItem.findElement(StatusBar.locators.StatusBar.notifications).getAttribute('class'));
             visible = klass.indexOf('visible') > -1;
         }
         catch (err) {
@@ -168,7 +168,7 @@ class StatusBar extends AbstractElement_1.AbstractElement {
         }
     }
     async getPartText(locator) {
-        return await this.findElement(locator).findElement(StatusBar.locators.StatusBar.aTag).getAttribute('innerHTML');
+        return (await this.findElement(locator).findElement(StatusBar.locators.StatusBar.aTag).getAttribute('innerHTML'));
     }
 }
 exports.StatusBar = StatusBar;

package/out/components/workbench/Notification.js

@@ -47,7 +47,7 @@ class Notification extends ElementWithContextMenu_1.ElementWithContextMenu {
      * @returns Promise resolving to NotificationType
      */
     async getType() {
-        const iconType = await (await this.findElement(Notification.locators.Notification.icon)).getAttribute('class');
+        const iconType = (await (await this.findElement(Notification.locators.Notification.icon)).getAttribute('class'));
         if (iconType.indexOf('icon-info') > -1) {
             return NotificationType.Info;
         }
@@ -68,14 +68,14 @@ class Notification extends ElementWithContextMenu_1.ElementWithContextMenu {
             throw Error(`DEPRECATED METHOD! For VS Code 1.88+ this method won't be working any more.`);
         }
         await this.expand();
-        return await (await this.findElement(Notification.locators.Notification.source)).getAttribute('title');
+        return (await (await this.findElement(Notification.locators.Notification.source)).getAttribute('title'));
     }
     /**
      * Find whether the notification has an active progress bar
      * @returns Promise resolving to true/false
      */
     async hasProgress() {
-        const klass = await (await this.findElement(Notification.locators.Notification.progress)).getAttribute('class');
+        const klass = (await (await this.findElement(Notification.locators.Notification.progress)).getAttribute('class'));
         return klass.indexOf('done') < 0;
     }
     /**

package/out/components/workbench/input/Input.js

@@ -31,7 +31,7 @@ class Input extends AbstractElement_1.AbstractElement {
      */
     async getText() {
         const input = await this.findElement(Input.locators.Input.inputBox).findElement(Input.locators.Input.input);
-        return await input.getAttribute('value');
+        return (await input.getAttribute('value'));
     }
     /**
      * Set (by selecting all and typing) text in the input field
@@ -75,7 +75,7 @@ class Input extends AbstractElement_1.AbstractElement {
      * @returns Promise resolving to input placeholder
      */
     async getPlaceHolder() {
-        return await this.findElement(Input.locators.Input.inputBox).findElement(Input.locators.Input.input).getAttribute('placeholder');
+        return (await this.findElement(Input.locators.Input.inputBox).findElement(Input.locators.Input.input).getAttribute('placeholder'));
     }
     /**
      * Confirm the input field by pressing Enter

package/out/components/workbench/input/InputBox.js

@@ -42,7 +42,7 @@ class InputBox extends __1.Input {
         return await this.findElement(InputBox.locators.InputBox.message).getText();
     }
     async hasProgress() {
-        const klass = await this.findElement(InputBox.locators.InputBox.progress).getAttribute('class');
+        const klass = (await this.findElement(InputBox.locators.InputBox.progress).getAttribute('class'));
         return klass.indexOf('done') < 0;
     }
     async getQuickPicks() {
@@ -90,7 +90,7 @@ class InputBox extends __1.Input {
      * @returns Promise resolving to notification message
      */
     async hasError() {
-        const klass = await this.findElement(InputBox.locators.Input.inputBox).getAttribute('class');
+        const klass = (await this.findElement(InputBox.locators.Input.inputBox).getAttribute('class'));
         return klass.indexOf('error') > -1;
     }
     /**

package/out/components/workbench/input/QuickOpenBox.js

@@ -36,7 +36,7 @@ class QuickOpenBox extends __1.Input {
         return new QuickOpenBox().wait();
     }
     async hasProgress() {
-        const klass = await this.findElement(QuickOpenBox.locators.QuickOpenBox.progress).getAttribute('class');
+        const klass = (await this.findElement(QuickOpenBox.locators.QuickOpenBox.progress).getAttribute('class'));
         return klass.indexOf('done') < 0;
     }
     async getQuickPicks() {

package/out/index.d.ts

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 import { WebDriver } from 'selenium-webdriver';
+export { AbstractElement } from './components/AbstractElement';
 export * from 'selenium-webdriver';
 export * from './locators/locators';
 export * from './errors/NullAttributeError';
@@ -88,4 +89,4 @@ export * from './conditions/WaitForAttribute';
  * @param driver WebDriver instance
  * @param browserID identifier/name of the browser (i.e. vscode)
  */
-export declare function initPageObjects(currentVersion: string, baseVersion: string, locatorFolder: string, driver: WebDriver, browserID: string): void;
+export declare function initPageObjects(currentVersion: string, baseVersion: string, locatorFolder: string, driver: WebDriver, browserID: string, customLocatorsPath?: string): void;

package/out/index.js

@@ -26,14 +26,39 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotificationType = exports.Notification = exports.ScmChange = exports.ScmProvider = exports.ScmView = void 0;
+exports.NotificationType = exports.Notification = exports.ScmChange = exports.ScmProvider = exports.ScmView = exports.AbstractElement = void 0;
 exports.initPageObjects = initPageObjects;
+const path = __importStar(require("node:path"));
 const AbstractElement_1 = require("./components/AbstractElement");
 const loader_1 = require("./locators/loader");
+var AbstractElement_2 = require("./components/AbstractElement");
+Object.defineProperty(exports, "AbstractElement", { enumerable: true, get: function () { return AbstractElement_2.AbstractElement; } });
 __exportStar(require("selenium-webdriver"), exports);
 __exportStar(require("./locators/locators"), exports);
 __exportStar(require("./errors/NullAttributeError"), exports);
@@ -112,8 +137,12 @@ __exportStar(require("./conditions/WaitForAttribute"), exports);
  * @param driver WebDriver instance
  * @param browserID identifier/name of the browser (i.e. vscode)
  */
-function initPageObjects(currentVersion, baseVersion, locatorFolder, driver, browserID) {
-    const locators = new loader_1.LocatorLoader(currentVersion, baseVersion, locatorFolder).loadLocators();
+function initPageObjects(currentVersion, baseVersion, locatorFolder, driver, browserID, customLocatorsPath) {
+    let locators = new loader_1.LocatorLoader(currentVersion, baseVersion, locatorFolder).loadLocators();
+    if (customLocatorsPath) {
+        const custom = require(path.resolve(customLocatorsPath));
+        locators = (0, loader_1.mergeLocators)(locators, custom);
+    }
     AbstractElement_1.AbstractElement.init(locators, driver, browserID, currentVersion);
 }
 //# sourceMappingURL=index.js.map

package/out/locators/loader.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Locators } from './locators';
+import { Locators, LocatorDiff } from './locators';
 /**
  * Utility for loading locators for a given vscode version
  */
@@ -34,3 +34,4 @@ export declare class LocatorLoader {
      */
     loadLocators(): Locators;
 }
+export declare function mergeLocators(original: Locators, diff: LocatorDiff): Locators;

package/out/locators/loader.js

@@ -53,6 +53,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocatorLoader = void 0;
+exports.mergeLocators = mergeLocators;
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
 const compare_versions_1 = require("compare-versions");
@@ -102,8 +103,7 @@ class LocatorLoader {
         }
         for (const version of versions) {
             const diff = require(path.join(this.baseFolder, version)).diff;
-            const newLocators = mergeLocators(this.locators, diff);
-            this.locators = newLocators;
+            this.locators = mergeLocators(this.locators, diff);
         }
         return this.locators;
     }

package/out/locators/locators.d.ts

@@ -15,8 +15,10 @@
  * limitations under the License.
  */
 import { By, IRectangle, WebElement } from 'selenium-webdriver';
-import { PartialDeep } from 'type-fest';
 import { ViewSection } from '../components/sidebar/ViewSection';
+type PartialDeep<T> = T extends object ? {
+    [K in keyof T]?: PartialDeep<T[K]>;
+} : T;
 type WebElementFunction<E extends WebElement, T> = (element: E) => T | PromiseLike<T>;
 type LocatorAwareWebElementFunction<T> = (element: WebElement, locator: Locators) => T | PromiseLike<T>;
 /**
@@ -336,6 +338,7 @@ export interface Locators {
         expandedAttr: string;
         expandedValue: string;
         tooltipAttribute: string;
+        tooltipElement: By;
         description: By;
     };
     DebugBreakpointSection: {
@@ -547,7 +550,7 @@ export interface Locators {
  * Definition for locator diff object
  */
 export interface LocatorDiff {
-    locators: PartialDeep<Locators>;
+    locators: PartialDeep<Locators> & Record<string, Record<string, unknown>>;
     extras?: object;
 }
 export declare function hasAttribute(attr: string, value?: string, locator?: By): (el: WebElement) => Promise<boolean>;

package/out/locators/locators.js

@@ -39,7 +39,7 @@ function hasClass(classOrPredicate, locator) {
         const klasses = await el.getAttribute('class');
         const segments = klasses?.split(/\s+/g);
         const predicate = typeof classOrPredicate === 'string' ? (klass) => klass === classOrPredicate : classOrPredicate;
-        return segments.find(predicate) !== undefined;
+        return segments?.find(predicate) !== undefined;
     };
 }
 function hasNotClass(klass, locator) {
@@ -56,7 +56,7 @@ function hasElement(locatorSelector) {
 function fromAttribute(attribute, locator) {
     return async (el) => {
         el = locator ? await el.findElement(locator) : el;
-        return await el.getAttribute(attribute);
+        return (await el.getAttribute(attribute));
     };
 }
 function fromText(locator) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redhat-developer/page-objects",
-  "version": "1.19.1",
+  "version": "1.21.0",
   "description": "Page Object API implementation for a VS Code editor used by ExTester framework.",
   "main": "out/index.js",
   "types": "out/index.d.ts",
@@ -37,15 +37,14 @@
     "ui-test"
   ],
   "dependencies": {
-    "clipboardy": "^5.3.1",
+    "clipboardy": "^5.3.2",
     "clone-deep": "^4.0.1",
     "compare-versions": "^6.1.1",
-    "fs-extra": "^11.3.3",
-    "type-fest": "^4.41.0"
+    "fs-extra": "^11.4.0"
   },
   "peerDependencies": {
     "selenium-webdriver": ">=4.6.1",
     "typescript": ">=4.6.2"
   },
-  "gitHead": "2348dcd72380e2b62591c3c589f81cd26ed7b76a"
+  "gitHead": "d3ed855411fdff9575ce7d7e8a65faa70a08349f"
 }