@redhat-developer/page-objects 1.9.0 → 1.11.0

package/out/components/ActionButtonElementDropdown.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License", destination); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ContextMenu } from './menu/ContextMenu';
+import { AbstractElement } from './AbstractElement';
+export declare abstract class ActionButtonElementDropdown extends AbstractElement {
+    open(): Promise<ContextMenu>;
+}

package/out/components/ActionButtonElementDropdown.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License", destination); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionButtonElementDropdown = void 0;
+const ElementWithContextMenu_1 = require("./ElementWithContextMenu");
+const ContextMenu_1 = require("./menu/ContextMenu");
+const selenium_webdriver_1 = require("selenium-webdriver");
+const AbstractElement_1 = require("./AbstractElement");
+class ActionButtonElementDropdown extends AbstractElement_1.AbstractElement {
+    async open() {
+        await this.click();
+        const shadowRootHost = await this.enclosingItem.findElements(selenium_webdriver_1.By.className('shadow-root-host'));
+        const actions = this.getDriver().actions();
+        await actions.clear();
+        await actions.sendKeys(selenium_webdriver_1.Key.ESCAPE).perform();
+        if (shadowRootHost.length > 0) {
+            if ((await this.getAttribute('aria-expanded')) !== 'true') {
+                await this.click();
+            }
+            const shadowRoot = await shadowRootHost[0].getShadowRoot();
+            return new ContextMenu_1.ContextMenu(await shadowRoot.findElement(selenium_webdriver_1.By.className('monaco-menu-container'))).wait();
+        }
+        else {
+            await this.click();
+            const workbench = await this.getDriver().findElement(ElementWithContextMenu_1.ElementWithContextMenu.locators.Workbench.constructor);
+            return new ContextMenu_1.ContextMenu(workbench).wait();
+        }
+    }
+}
+exports.ActionButtonElementDropdown = ActionButtonElementDropdown;
+//# sourceMappingURL=ActionButtonElementDropdown.js.map

package/out/components/activityBar/ViewControl.js

@@ -20,6 +20,7 @@ exports.ViewControl = void 0;
 const __1 = require("../..");
 const ElementWithContextMenu_1 = require("../ElementWithContextMenu");
 const NewScmView_1 = require("../sidebar/scm/NewScmView");
+const compare_versions_1 = require("compare-versions");
 /**
  * Page object representing a view container item in the activity bar
  */
@@ -40,7 +41,7 @@ class ViewControl extends ElementWithContextMenu_1.ElementWithContextMenu {
         }
         const view = await new __1.SideBarView().wait();
         if ((await view.findElements(ViewControl.locators.ViewControl.scmId)).length > 0) {
-            if (ViewControl.versionInfo.browser === 'vscode' && ViewControl.versionInfo.version >= '1.47.0') {
+            if (ViewControl.versionInfo.browser === 'vscode' && (0, compare_versions_1.satisfies)(ViewControl.versionInfo.version, '>=1.47.0')) {
                 return new NewScmView_1.NewScmView().wait();
             }
             return new __1.ScmView().wait();

package/out/components/bottomBar/AbstractViews.js

@@ -19,6 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TextView = exports.ChannelView = void 0;
 const selenium_webdriver_1 = require("selenium-webdriver");
 const ElementWithContextMenu_1 = require("../ElementWithContextMenu");
+const compare_versions_1 = require("compare-versions");
 /**
  * View with channel selector
  */
@@ -45,7 +46,7 @@ class ChannelView extends ElementWithContextMenu_1.ElementWithContextMenu {
      * @deprecated For VS Code 1.88+ this method won't be working any more
      */
     async getCurrentChannel() {
-        if (ChannelView.versionInfo.version >= '1.87.0' && process.platform !== 'darwin') {
+        if ((0, compare_versions_1.compareVersions)(ChannelView.versionInfo.version, '1.87.0') >= 0 && process.platform !== 'darwin') {
             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);

package/out/components/bottomBar/BottomBarPanel.d.ts

@@ -57,7 +57,13 @@ export declare class BottomBarPanel extends AbstractElement {
      * @returns Promise resolving when the restore button is pressed
      */
     restore(): Promise<void>;
-    private openTab;
+    /**
+     * Opens (or focuses) a tab in the bottom bar panel by its title.
+     *
+     * @param title The exact name of the tab to be opened or focused.
+     * @returns A promise that resolves when the tab is opened or focused.
+     */
+    openTab(title: string): Promise<void>;
     private resize;
     closePanel(): Promise<void>;
 }

package/out/components/bottomBar/BottomBarPanel.js

@@ -99,6 +99,12 @@ class BottomBarPanel extends AbstractElement_1.AbstractElement {
     async restore() {
         await this.resize(BottomBarPanel.locators.BottomBarPanel.restore);
     }
+    /**
+     * Opens (or focuses) a tab in the bottom bar panel by its title.
+     *
+     * @param title The exact name of the tab to be opened or focused.
+     * @returns A promise that resolves when the tab is opened or focused.
+     */
     async openTab(title) {
         await this.toggle(true);
         const tabContainer = await this.findElement(BottomBarPanel.locators.BottomBarPanel.tabContainer);

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

@@ -14,16 +14,18 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { EditorGroup } from './EditorView';
-import { ContextMenu, WebElement } from '../..';
-import { ElementWithContextMenu } from '../ElementWithContextMenu';
-export declare class EditorAction extends ElementWithContextMenu {
-    constructor(element: WebElement, parent: EditorGroup);
+import { ActionButtonElementDropdown } from '../ActionButtonElementDropdown';
+/**
+ * Base class for editor actions that provides a common method to get the title.
+ */
+declare abstract class BaseEditorAction extends ActionButtonElementDropdown {
     /**
      * Get text description of the action.
      */
     getTitle(): Promise<string>;
 }
-export declare class EditorActionDropdown extends EditorAction {
-    open(): Promise<ContextMenu>;
+export declare class EditorAction extends BaseEditorAction {
+}
+export declare class EditorActionDropdown extends BaseEditorAction {
 }
+export {};

package/out/components/editor/EditorAction.js

@@ -17,52 +17,22 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EditorActionDropdown = exports.EditorAction = void 0;
-const __1 = require("../..");
-const ElementWithContextMenu_1 = require("../ElementWithContextMenu");
-class EditorAction extends ElementWithContextMenu_1.ElementWithContextMenu {
-    constructor(element, parent) {
-        super(element, parent);
-    }
+const ActionButtonElementDropdown_1 = require("../ActionButtonElementDropdown");
+/**
+ * Base class for editor actions that provides a common method to get the title.
+ */
+class BaseEditorAction extends ActionButtonElementDropdown_1.ActionButtonElementDropdown {
     /**
      * Get text description of the action.
      */
     async getTitle() {
-        return await this.getAttribute(EditorAction.locators.EditorView.attribute);
+        return await this.getAttribute(BaseEditorAction.locators.EditorView.attribute);
     }
 }
+class EditorAction extends BaseEditorAction {
+}
 exports.EditorAction = EditorAction;
-class EditorActionDropdown extends EditorAction {
-    async open() {
-        await this.click();
-        const shadowRootHost = await this.enclosingItem.findElements(EditorAction.locators.EditorAction.shadowRootHost);
-        const actions = this.getDriver().actions();
-        await actions.clear();
-        await actions.sendKeys(__1.Key.ESCAPE).perform();
-        const webdriverCapabilities = await this.getDriver().getCapabilities();
-        const chromiumVersion = webdriverCapabilities.getBrowserVersion();
-        if (shadowRootHost.length > 0) {
-            if ((await this.getAttribute('aria-expanded')) !== 'true') {
-                await this.click();
-            }
-            let shadowRoot;
-            const webdriverCapabilities = await this.getDriver().getCapabilities();
-            const chromiumVersion = webdriverCapabilities.getBrowserVersion();
-            if (chromiumVersion && parseInt(chromiumVersion.split('.')[0]) >= 96) {
-                shadowRoot = await shadowRootHost[0].getShadowRoot();
-                return new __1.ContextMenu(await shadowRoot.findElement(EditorAction.locators.EditorAction.monacoMenuContainer)).wait();
-            }
-            else {
-                shadowRoot = (await this.getDriver().executeScript('return arguments[0].shadowRoot', shadowRootHost[0]));
-                return new __1.ContextMenu(shadowRoot).wait();
-            }
-        }
-        else if (chromiumVersion && parseInt(chromiumVersion.split('.')[0]) >= 100) {
-            await this.click();
-            const workbench = await this.getDriver().findElement(ElementWithContextMenu_1.ElementWithContextMenu.locators.Workbench.constructor);
-            return new __1.ContextMenu(workbench).wait();
-        }
-        return await super.openContextMenu();
-    }
+class EditorActionDropdown extends BaseEditorAction {
 }
 exports.EditorActionDropdown = EditorActionDropdown;
 //# sourceMappingURL=EditorAction.js.map

package/out/components/editor/SettingsEditor.js

@@ -21,11 +21,12 @@ const Editor_1 = require("./Editor");
 const selenium_webdriver_1 = require("selenium-webdriver");
 const AbstractElement_1 = require("../AbstractElement");
 const __1 = require("../..");
+const compare_versions_1 = require("compare-versions");
 /**
  * Page object representing the internal VS Code settings editor
  */
 class SettingsEditor extends Editor_1.Editor {
-    divider = SettingsEditor.versionInfo.version >= '1.83.0' ? '›' : ' › ';
+    divider = (0, compare_versions_1.satisfies)(SettingsEditor.versionInfo.version, '>=1.83.0') ? '›' : ' › ';
     constructor(view = new __1.EditorView()) {
         super(view);
     }

package/out/components/editor/TextEditor.js

@@ -25,6 +25,7 @@ const Editor_1 = require("./Editor");
 const ElementWithContextMenu_1 = require("../ElementWithContextMenu");
 const AbstractElement_1 = require("../AbstractElement");
 const Breakpoint_1 = require("./Breakpoint");
+const compare_versions_1 = require("compare-versions");
 class BreakpointError extends Error {
 }
 exports.BreakpointError = BreakpointError;
@@ -524,7 +525,9 @@ class TextEditor extends Editor_1.Editor {
         const lineNum = await margin.findElement(TextEditor.locators.TextEditor.lineNumber(line));
         await this.getDriver().actions().move({ origin: lineNum }).perform();
         const lineOverlay = await margin.findElement(TextEditor.locators.TextEditor.lineOverlay(line));
-        const breakpointContainer = TextEditor.versionInfo.version >= '1.80.0' ? await this.findElement(TextEditor.locators.TextEditor.glyphMarginWidget) : lineOverlay;
+        const breakpointContainer = (0, compare_versions_1.satisfies)(TextEditor.versionInfo.version, '>=1.80.0')
+            ? await this.findElement(TextEditor.locators.TextEditor.glyphMarginWidget)
+            : lineOverlay;
         const breakPoint = await breakpointContainer.findElements(TextEditor.locators.TextEditor.breakpoint.generalSelector);
         if (breakPoint.length > 0) {
             if (this.breakPoints.indexOf(line) !== -1) {
@@ -549,7 +552,9 @@ class TextEditor extends Editor_1.Editor {
      */
     async getPausedBreakpoint() {
         const breakpointLocators = Breakpoint_1.Breakpoint.locators.TextEditor.breakpoint;
-        const breakpointContainer = TextEditor.versionInfo.version >= '1.80.0' ? await this.findElement(TextEditor.locators.TextEditor.glyphMarginWidget) : this;
+        const breakpointContainer = (0, compare_versions_1.satisfies)(TextEditor.versionInfo.version, '>=1.80.0')
+            ? await this.findElement(TextEditor.locators.TextEditor.glyphMarginWidget)
+            : this;
         const breakpoints = await breakpointContainer.findElements(breakpointLocators.pauseSelector);
         if (breakpoints.length === 0) {
             return undefined;
@@ -559,7 +564,7 @@ class TextEditor extends Editor_1.Editor {
         }
         // get parent
         let lineElement;
-        if (TextEditor.versionInfo.version >= '1.80.0') {
+        if ((0, compare_versions_1.satisfies)(TextEditor.versionInfo.version, '>=1.80.0')) {
             const styleTopAttr = await breakpoints[0].getCssValue('top');
             lineElement = await this.findElement(TextEditor.locators.TextEditor.marginArea).findElement(TextEditor.locators.TextEditor.lineElement(styleTopAttr));
         }
@@ -589,11 +594,13 @@ class TextEditor extends Editor_1.Editor {
     async getBreakpoints() {
         const breakpoints = [];
         const breakpointLocators = Breakpoint_1.Breakpoint.locators.TextEditor.breakpoint;
-        const breakpointContainer = TextEditor.versionInfo.version >= '1.80.0' ? await this.findElement(TextEditor.locators.TextEditor.glyphMarginWidget) : this;
+        const breakpointContainer = (0, compare_versions_1.satisfies)(TextEditor.versionInfo.version, '>=1.80.0')
+            ? await this.findElement(TextEditor.locators.TextEditor.glyphMarginWidget)
+            : this;
         const breakpointsSelectors = await breakpointContainer.findElements(breakpointLocators.generalSelector);
         for (const breakpointSelector of breakpointsSelectors) {
             let lineElement;
-            if (TextEditor.versionInfo.version >= '1.80.0') {
+            if ((0, compare_versions_1.satisfies)(TextEditor.versionInfo.version, '>=1.80.0')) {
                 const styleTopAttr = await breakpointSelector.getCssValue('top');
                 lineElement = await this.findElement(TextEditor.locators.TextEditor.marginArea).findElement(TextEditor.locators.TextEditor.lineElement(styleTopAttr));
             }
@@ -767,7 +774,7 @@ class FindWidget extends AbstractElement_1.AbstractElement {
      * Close the widget.
      */
     async close() {
-        const part = TextEditor.versionInfo.version >= '1.80.0' ? 'close' : 'find';
+        const part = (0, compare_versions_1.satisfies)(TextEditor.versionInfo.version, '>=1.80.0') ? 'close' : 'find';
         await this.clickButton('Close', part);
     }
     /**

package/out/components/sidebar/ViewSection.d.ts

@@ -17,6 +17,7 @@
 import { WebElement } from 'selenium-webdriver';
 import { ContextMenu, ViewContent, ViewItem, WelcomeContentSection } from '../..';
 import { AbstractElement } from '../AbstractElement';
+import { ActionButtonElementDropdown } from '../ActionButtonElementDropdown';
 export type ViewSectionConstructor<T extends ViewSection> = {
     new (rootElement: WebElement, tree: ViewContent): T;
 };
@@ -34,12 +35,12 @@ export declare abstract class ViewSection extends AbstractElement {
      * Expand the section if collapsed
      * @returns Promise resolving when the section is expanded
      */
-    expand(): Promise<void>;
+    expand(timeout?: number): Promise<void>;
     /**
      * Collapse the section if expanded
      * @returns Promise resolving when the section is collapsed
      */
-    collapse(): Promise<void>;
+    collapse(timeout?: number): Promise<void>;
     /**
      * Finds whether the section is expanded
      * @returns Promise resolving to true/false
@@ -102,13 +103,23 @@ export declare abstract class ViewSection extends AbstractElement {
     private isHeaderHidden;
 }
 /**
- * Action button on the header of a view section
+ * Base class for action buttons on view sections.
+ * Provides shared functionality for both standard and dropdown actions.
  */
-export declare class ViewPanelAction extends AbstractElement {
+declare abstract class BaseViewPanelAction extends ActionButtonElementDropdown {
     constructor(element: WebElement, viewPart: ViewSection);
     /**
      * Get label of the action button
      */
     getLabel(): Promise<string>;
+    /**
+     * Wait for the action button to be located within a given timeout.
+     * @param timeout Time in milliseconds (default: 1000ms)
+     */
     wait(timeout?: number): Promise<this>;
 }
+export declare class ViewPanelAction extends BaseViewPanelAction {
+}
+export declare class ViewPanelActionDropdown extends BaseViewPanelAction {
+}
+export {};

package/out/components/sidebar/ViewSection.js

@@ -16,11 +16,12 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ViewPanelAction = exports.ViewSection = void 0;
+exports.ViewPanelActionDropdown = exports.ViewPanelAction = exports.ViewSection = void 0;
 const selenium_webdriver_1 = require("selenium-webdriver");
 const __1 = require("../..");
 const AbstractElement_1 = require("../AbstractElement");
 const ElementWithContextMenu_1 = require("../ElementWithContextMenu");
+const ActionButtonElementDropdown_1 = require("../ActionButtonElementDropdown");
 /**
  * Page object representing a collapsible content section of the side bar view
  */
@@ -40,28 +41,32 @@ class ViewSection extends AbstractElement_1.AbstractElement {
      * Expand the section if collapsed
      * @returns Promise resolving when the section is expanded
      */
-    async expand() {
+    async expand(timeout = 1_000) {
         if (await this.isHeaderHidden()) {
             return;
         }
         if (!(await this.isExpanded())) {
-            const panel = await this.findElement(ViewSection.locators.ViewSection.header);
-            await panel.click();
-            await this.getDriver().wait((0, __1.waitForAttributeValue)(panel, ViewSection.locators.ViewSection.headerExpanded, 'true'), 1000);
+            const header = await this.findElement(ViewSection.locators.ViewSection.header);
+            const collapseExpandButton = await header.findElement(ViewSection.locators.ViewSection.headerCollapseExpandButton);
+            await collapseExpandButton.click();
+            await this.getDriver().wait((0, __1.waitForAttributeValue)(header, ViewSection.locators.ViewSection.headerExpanded, 'true'), timeout);
+            await this.getDriver().sleep(500);
         }
     }
     /**
      * Collapse the section if expanded
      * @returns Promise resolving when the section is collapsed
      */
-    async collapse() {
+    async collapse(timeout = 1_000) {
         if (await this.isHeaderHidden()) {
             return;
         }
         if (await this.isExpanded()) {
-            const panel = await this.findElement(ViewSection.locators.ViewSection.header);
-            await panel.click();
-            await this.getDriver().wait((0, __1.waitForAttributeValue)(panel, ViewSection.locators.ViewSection.headerExpanded, 'false'), 1000);
+            const header = await this.findElement(ViewSection.locators.ViewSection.header);
+            const collapseExpandButton = await header.findElement(ViewSection.locators.ViewSection.headerCollapseExpandButton);
+            await collapseExpandButton.click();
+            await this.getDriver().wait((0, __1.waitForAttributeValue)(header, ViewSection.locators.ViewSection.headerExpanded, 'false'), timeout);
+            await this.getDriver().sleep(500);
         }
     }
     /**
@@ -95,16 +100,16 @@ class ViewSection extends AbstractElement_1.AbstractElement {
      * @returns Promise resolving to array of ViewPanelAction objects
      */
     async getActions() {
-        const actions = [];
-        if (!(await this.isHeaderHidden())) {
-            const header = await this.findElement(ViewSection.locators.ViewSection.header);
-            const act = await header.findElement(ViewSection.locators.ViewSection.actions);
-            const elements = await act.findElements(ViewSection.locators.ViewSection.button);
-            for (const element of elements) {
-                actions.push(await new ViewPanelAction(element, this).wait());
+        const actions = await this.findElement(ViewSection.locators.ViewSection.actions).findElements(ViewSection.locators.ViewSection.button);
+        return Promise.all(actions.map(async (action) => {
+            const dropdown = await action.getAttribute('aria-haspopup');
+            if (dropdown) {
+                return new ViewPanelActionDropdown(action, this);
             }
-        }
-        return actions;
+            else {
+                return new ViewPanelAction(action, this);
+            }
+        }));
     }
     /**
      * Retrieve an action button on the sections's header by its label
@@ -159,9 +164,10 @@ class ViewSection extends AbstractElement_1.AbstractElement {
 }
 exports.ViewSection = ViewSection;
 /**
- * Action button on the header of a view section
+ * Base class for action buttons on view sections.
+ * Provides shared functionality for both standard and dropdown actions.
  */
-class ViewPanelAction extends AbstractElement_1.AbstractElement {
+class BaseViewPanelAction extends ActionButtonElementDropdown_1.ActionButtonElementDropdown {
     constructor(element, viewPart) {
         super(element, viewPart);
     }
@@ -169,12 +175,21 @@ class ViewPanelAction extends AbstractElement_1.AbstractElement {
      * Get label of the action button
      */
     async getLabel() {
-        return await this.getAttribute(ViewSection.locators.ViewSection.buttonLabel);
+        return await this.getAttribute(BaseViewPanelAction.locators.ViewSection.buttonLabel);
     }
-    async wait(timeout = 1000) {
-        await this.getDriver().wait(selenium_webdriver_1.until.elementLocated(ViewSection.locators.ViewSection.actions), timeout);
+    /**
+     * Wait for the action button to be located within a given timeout.
+     * @param timeout Time in milliseconds (default: 1000ms)
+     */
+    async wait(timeout = 1_000) {
+        await this.getDriver().wait(selenium_webdriver_1.until.elementLocated(BaseViewPanelAction.locators.ViewSection.actions), timeout);
         return this;
     }
 }
+class ViewPanelAction extends BaseViewPanelAction {
+}
 exports.ViewPanelAction = ViewPanelAction;
+class ViewPanelActionDropdown extends BaseViewPanelAction {
+}
+exports.ViewPanelActionDropdown = ViewPanelActionDropdown;
 //# sourceMappingURL=ViewSection.js.map

package/out/components/sidebar/WelcomeContent.d.ts

@@ -46,13 +46,19 @@ export declare class WelcomeContentButton extends AbstractElement {
 export declare class WelcomeContentSection extends AbstractElement {
     /**
      * @param panel  The panel containing the welcome content.
-     * @param parent  The webelement in which the welcome content is embedded.
+     * @param parent  The webElement in which the welcome content is embedded.
      */
     constructor(panel: WebElement, parent: ViewSection);
     /**
      * Combination of [[getButtons]] and [[getTextSections]]: returns all entries in the welcome view in the order that they appear.
      */
     getContents(): Promise<(WelcomeContentButton | string)[]>;
+    /**
+     * Returns a specific button from the welcome view that matches the given title.
+     * @param title The title of the button to search for.
+     * @returns A `WelcomeContentButton` if found, otherwise `undefined`.
+     */
+    getButton(title: string): Promise<WelcomeContentButton | undefined>;
     /** Finds all buttons in the welcome content */
     getButtons(): Promise<WelcomeContentButton[]>;
     /**

package/out/components/sidebar/WelcomeContent.js

@@ -52,7 +52,7 @@ exports.WelcomeContentButton = WelcomeContentButton;
 class WelcomeContentSection extends AbstractElement_1.AbstractElement {
     /**
      * @param panel  The panel containing the welcome content.
-     * @param parent  The webelement in which the welcome content is embedded.
+     * @param parent  The webElement in which the welcome content is embedded.
      */
     constructor(panel, parent) {
         super(panel, parent);
@@ -72,6 +72,20 @@ class WelcomeContentSection extends AbstractElement_1.AbstractElement {
             }
         }));
     }
+    /**
+     * Returns a specific button from the welcome view that matches the given title.
+     * @param title The title of the button to search for.
+     * @returns A `WelcomeContentButton` if found, otherwise `undefined`.
+     */
+    async getButton(title) {
+        const buttons = await this.getButtons();
+        for (const btn of buttons) {
+            if ((await btn.getTitle()) === title) {
+                return btn;
+            }
+        }
+        return undefined;
+    }
     /** Finds all buttons in the welcome content */
     async getButtons() {
         return (await this.findElements(WelcomeContentSection.locators.WelcomeContent.button)).map((elem) => new WelcomeContentButton(elem, this));

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

@@ -17,6 +17,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DebugView = void 0;
+const compare_versions_1 = require("compare-versions");
 const SideBarView_1 = require("../SideBarView");
 const DebugBreakpointSection_1 = require("../tree/debug/DebugBreakpointSection");
 const DebugCallStackSection_1 = require("../tree/debug/DebugCallStackSection");
@@ -32,7 +33,7 @@ class DebugView extends SideBarView_1.SideBarView {
      * @deprecated For VS Code 1.88+ this method won't be working any more
      */
     async getLaunchConfiguration() {
-        if (DebugView.versionInfo.version >= '1.87.0' && process.platform !== 'darwin') {
+        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.`);
         }
         const action = await this.getTitlePart().findElement(DebugView.locators.DebugView.launchCombo);

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

@@ -21,6 +21,7 @@ const ScmView_1 = require("./ScmView");
 const selenium_webdriver_1 = require("selenium-webdriver");
 const ElementWithContextMenu_1 = require("../../ElementWithContextMenu");
 const ViewTitlePart_1 = require("../ViewTitlePart");
+const compare_versions_1 = require("compare-versions");
 /**
  * New SCM view for code 1.47 onwards
  */
@@ -61,7 +62,7 @@ class SingleScmProvider extends ScmView_1.ScmProvider {
         let actions = [];
         let names = [];
         const buttons = [];
-        if (ScmView_1.ScmProvider.versionInfo.version >= '1.93.0') {
+        if ((0, compare_versions_1.satisfies)(ScmView_1.ScmProvider.versionInfo.version, '>=1.93.0')) {
             const header = await view.findElement(ScmView_1.ScmView.locators.ScmView.sourceControlSection);
             actions = await header.findElements(ScmView_1.ScmProvider.locators.ScmView.action);
             names = await Promise.all(actions.map(async (action) => await action.getAttribute(ScmView_1.ScmProvider.locators.ScmView.actionLabel)));
@@ -77,7 +78,7 @@ class SingleScmProvider extends ScmView_1.ScmProvider {
         }
         const index = names.findIndex((item) => item === title);
         if (index > -1) {
-            if (ScmView_1.ScmProvider.versionInfo.version >= '1.93.0') {
+            if ((0, compare_versions_1.satisfies)(ScmView_1.ScmProvider.versionInfo.version, '>=1.93.0')) {
                 await actions[index].click();
             }
             else {

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

@@ -19,6 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VariableSectionItem = void 0;
 const selenium_webdriver_1 = require("selenium-webdriver");
 const CustomTreeItem_1 = require("../custom/CustomTreeItem");
+const compare_versions_1 = require("compare-versions");
 class VariableSectionItem extends CustomTreeItem_1.CustomTreeItem {
     constructor(element, viewPart) {
         super(element, viewPart);
@@ -45,7 +46,7 @@ class VariableSectionItem extends CustomTreeItem_1.CustomTreeItem {
      * @deprecated For VS Code 1.88+ this method won't be working any more
      */
     async getVariableNameTooltip() {
-        if (VariableSectionItem.versionInfo.version >= '1.88.0') {
+        if ((0, compare_versions_1.satisfies)(VariableSectionItem.versionInfo.version, '>=1.88.0')) {
             throw Error(`DEPRECATED METHOD! For VS Code 1.88+ this method won't be working any more.`);
         }
         const name = await this.findElement(VariableSectionItem.locators.VariableSectionItem.name.constructor);
@@ -57,7 +58,7 @@ class VariableSectionItem extends CustomTreeItem_1.CustomTreeItem {
      * @deprecated For VS Code 1.89+ this method won't be working any more
      */
     async getVariableValueTooltip() {
-        if (VariableSectionItem.versionInfo.version >= '1.89.0') {
+        if ((0, compare_versions_1.satisfies)(VariableSectionItem.versionInfo.version, '>=1.89.0')) {
             throw Error(`DEPRECATED METHOD! For VS Code 1.89+ this method won't be working any more.`);
         }
         const value = await this.findElement(VariableSectionItem.locators.VariableSectionItem.value.constructor);

package/out/components/workbench/Notification.js

@@ -20,6 +20,7 @@ exports.CenterNotification = exports.StandaloneNotification = exports.Notificati
 const ElementWithContextMenu_1 = require("../ElementWithContextMenu");
 const AbstractElement_1 = require("../AbstractElement");
 const selenium_webdriver_1 = require("selenium-webdriver");
+const compare_versions_1 = require("compare-versions");
 /**
  * Available types of notifications
  */
@@ -63,7 +64,7 @@ class Notification extends ElementWithContextMenu_1.ElementWithContextMenu {
      * @deprecated For VS Code 1.88+ this method won't be working any more
      */
     async getSource() {
-        if (Notification.versionInfo.version >= '1.88.0') {
+        if ((0, compare_versions_1.satisfies)(Notification.versionInfo.version, '>=1.88.0')) {
             throw Error(`DEPRECATED METHOD! For VS Code 1.88+ this method won't be working any more.`);
         }
         await this.expand();

package/out/components/workbench/Workbench.js

@@ -29,6 +29,7 @@ const Notification_1 = require("./Notification");
 const QuickOpenBox_1 = require("./input/QuickOpenBox");
 const SettingsEditor_1 = require("../editor/SettingsEditor");
 const InputBox_1 = require("./input/InputBox");
+const compare_versions_1 = require("compare-versions");
 /**
  * Handler for general workbench related actions
  */
@@ -125,7 +126,7 @@ class Workbench extends AbstractElement_1.AbstractElement {
         }
         const driver = this.getDriver();
         await driver.actions().keyDown(Workbench.ctlKey).keyDown(selenium_webdriver_1.Key.SHIFT).sendKeys('p').perform();
-        if (Workbench.versionInfo.version >= '1.44.0') {
+        if ((0, compare_versions_1.satisfies)(Workbench.versionInfo.version, '>=1.44.0')) {
             return await InputBox_1.InputBox.create();
         }
         return await QuickOpenBox_1.QuickOpenBox.create();

package/out/locators/locators.d.ts

@@ -288,6 +288,7 @@ export interface Locators {
         titleText: string;
         header: By;
         headerExpanded: string;
+        headerCollapseExpandButton: By;
         actions: By;
         actionConstructor: (label: string) => By;
         button: By;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redhat-developer/page-objects",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Page Object API implementation for a VS Code editor used by ExTester framework.",
   "main": "out/index.js",
   "types": "out/index.d.ts",
@@ -40,12 +40,12 @@
     "clipboardy": "^4.0.0",
     "clone-deep": "^4.0.1",
     "compare-versions": "^6.1.1",
-    "fs-extra": "^11.2.0",
-    "type-fest": "^4.31.0"
+    "fs-extra": "^11.3.0",
+    "type-fest": "^4.35.0"
   },
   "peerDependencies": {
     "selenium-webdriver": ">=4.6.1",
     "typescript": ">=4.6.2"
   },
-  "gitHead": "ee887332c09744c7446d3182f6ae3946c2b5a050"
+  "gitHead": "bf17db769fb699fe9a47325ff6e0c94dc821ae0f"
 }