Skip to content

docs: add 7 medium-priority undocumented SHAFT_ENGINE features#444

Merged
MohabMohie merged 4 commits into
masterfrom
copilot/handle-medium-priority-items
Apr 8, 2026
Merged

docs: add 7 medium-priority undocumented SHAFT_ENGINE features#444
MohabMohie merged 4 commits into
masterfrom
copilot/handle-medium-priority-items

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 7, 2026

Closes coverage gaps identified in the documentation gap analysis (issue #440). Adds full documentation for 7 commonly-needed SHAFT features that had no dedicated docs.

New pages

  • Keywords/GUI/Async_Element_Actionsdriver.async().element() parallel actions via Java 21 virtual threads; covers synchronize() / join() / sync() blocking semantics and when-to-use guidance
  • Keywords/GUI/didYouKnow/Mobile_Emulation — Chrome DevTools device emulation; preset device names, custom viewport/UA/DPR, properties file + CLI config

Extended existing pages

  • TestData_Management — YAML test data section: type-safe getters (getString, getInteger, getAs, getListAs), nested dot-notation keys, format comparison table updated with YAML column
  • API/Request_Builder — GraphQL section: plain query, variables, auth header, mutation; note on auto-wrapping payload
  • GUI/Element_Identification — Three new locator sections:
    • XPath Axis NavigationbyAxis().followingSibling(), .ancestor(), .child(), etc. (all 8 axes)
    • ARIA Role-Based LocatorsLocator.hasRole(Role.BUTTON), full Role enum reference
    • Smart LocatorsLocator.inputField("Email") / Locator.clickableField("Submit")
  • didYouKnow/Native_selenium_Webdriver — Upgraded from a stub; adds Wrap Existing WebDriver pattern for incremental Selenium → SHAFT migration:
WebDriver rawDriver = new ChromeDriver();
rawDriver.get("https://example.com");

// Wrap to get SHAFT fluent API, smart waits, and Allure reporting
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver(rawDriver);
driver.assertThat().browser().title().contains("Example").perform();

Sidebar

sidebars.js updated to include Async_Element_Actions and Mobile_Emulation.

Copilot AI linked an issue Apr 7, 2026 that may be closed by this pull request
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 7, 2026

Deploy Preview for shaftengine ready!

Name Link
🔨 Latest commit 50e55f4
🔍 Latest deploy log https://app.netlify.com/projects/shaftengine/deploys/69d6212488498200089495a7
😎 Deploy Preview https://deploy-preview-444--shaftengine.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 91
Accessibility: 93
Best Practices: 92
SEO: 100
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI and others added 2 commits April 7, 2026 21:15
… async element actions, XPath axis/ARIA/smart locators, mobile emulation, wrap existing WebDriver

Agent-Logs-Url: https://github.com/ShaftHQ/shafthq.github.io/sessions/e8df246f-484a-4211-84d4-026a24ba9f23

Co-authored-by: MohabMohie <19201898+MohabMohie@users.noreply.github.com>
…ze() blocking behavior, add Role import to example

Agent-Logs-Url: https://github.com/ShaftHQ/shafthq.github.io/sessions/e8df246f-484a-4211-84d4-026a24ba9f23

Co-authored-by: MohabMohie <19201898+MohabMohie@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix handling of medium priority items docs: add 7 medium-priority undocumented SHAFT_ENGINE features Apr 7, 2026
Copilot AI requested a review from MohabMohie April 7, 2026 21:18
Signed-off-by: Mohab Mohie <Mohab.MohieElDeen@outlook.com>
@MohabMohie MohabMohie marked this pull request as ready for review April 8, 2026 09:34
@MohabMohie MohabMohie merged commit ccecd69 into master Apr 8, 2026
7 of 9 checks passed
@MohabMohie MohabMohie deleted the copilot/handle-medium-priority-items branch April 8, 2026 09:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Handle medium priority items

2 participants