What's New

A curated tour of what each version brings, with direct links to the guides.

For the raw GitHub release notes, see Release Notes.

#Coming next

Landed on main, not tagged in a release yet — will be folded into the next version's section once cut.

• CommonPage::scrollToAnchor($selector, $settleMs = 400) — frame a viewport-only visual capture on a business anchor rather than the top of the page (headers, promo banners…). See Frame a viewport capture on an anchor.

#1.5.0

BackOffice validated, checkout & order lifecycle end-to-end, visual regression, HTTP presets.

Turns the library into a proven end-to-end driver against a live PrestaShop 9: real product create/edit, guest and logged-in checkout, and full order lifecycle in the BackOffice — each increment validated live.

#Ready-to-use scenarios

Drop these into a suite as-is or subclass them to customise. Each is validated live against PrestaShop 9. See Scenario → Ready-to-use scenarios.

• CheckoutOrder — logged-in checkout end-to-end, then order found in BO.
• GuestCheckout — pure guest checkout with a new address.
• ManageOrder — change status, add note, set tracking on an existing order.
• OrderLifecycle — composes CheckoutOrder → ManageOrder.
• EditProduct — self-cleaning: create → open → edit price → verify → delete.
• CreateProductAndVerify — BO product creation + FO visibility check.

#Page objects

Documented in Actions.

• FrontOffice: Cart, Checkout (multi-step tunnel + guest steps), OrderConfirmation, Rgpd, Product::goToProductPath, FrontOfficePage::goToUrl.
• BackOffice: OrderView (status / note / tracking), Orders (openOrder, filterByReference), Products (openProduct, updatePrice, getFormPrice, plus the real PS 9 two-step create flow).

#Visual regression

New: Visual regression guide.

• CommonPage::visualCheckpoint($label, $fullPage = true) — screenshot vs. baseline.
• CLI bin/prestaflow run --visual-report[=path] — HTML + JSON report.
• Full-page or viewport capture, persistent baseline folder, PRESTAFLOW_TZ for the report stamp.

#HTTP presets

New: HTTP presets guide. Env-driven, applied before the first navigation and re-applied across page re-creations.

• PRESTAFLOW_USER_AGENT — set the browser UA (pass anti-bot protections).
• PRESTAFLOW_COOKIES — preload cookies (JSON) to skip a cookie-consent banner.
• PRESTAFLOW_BASIC_USER / PRESTAFLOW_BASIC_PASS — HTTP Basic Auth for a preproduction.

See the updated Configuration reference table.

#Fixed primitives (behavioural supersets)

Same API, wider coverage — see the notes under Actions → Inputs.

• getInputValue now reads the live .value in JS (fixes <textarea> and dynamic values).
• selectOption / selectValue handle compound CSS selectors and drive select2.
• New setValueByJs for fields on inactive tabs.

#Notable fixes

• Reliable BackOffice login against a live PS 9, bounded waitForPageReload, session isolation per suite.
• Cold-start resilience: retry the browser launch, goToPage, getPage.
• Basic Auth headers survive createPage() (re-applied by goToPage).
• Product create no longer leaks price / quantity into the name field (JS value-set on inactive-tab fields).

#1.4.0

Cookie presets & configurable User-Agent.

• PRESTAFLOW_COOKIES (env, JSON) — preload cookies before the first navigation (helpful to neutralise an RGPD banner). See the HTTP presets guide.
• New FrontOffice\Rgpd page — dismisses a Knowband ___kbgdcc consent banner (with a generic fallback).
• PRESTAFLOW_USER_AGENT — getBrowser() now honors it (no more hardcoded PrestaFlow UA). Useful to pass anti-bot protections (Cloudflare Browser Integrity Check…).

Fully backwards-compatible.

#1.3.0

CI-ready reporting, factorized pages, hardened screenshots, BackOffice navigation groundwork.

• CI: non-zero exit on failure + JUnit report (--junit). See the GitHub Actions guide.
• 1B — Page factorization: all pages now share a versioned Common/ base with thin per-version stubs — every page resolves for all supported PrestaShop versions.
• 1C — Screenshots on failure: hardened capture helper, JUnit <system-out> attachment.
• BackOffice navigation: BackOfficePage::goToSubMenu() for reliable admin menu clicks; first BackOffice Products and Orders pages. See Actions → Back Office.
• Vendored nunzion/php-expect (upstream became unreliable).

#Earlier releases

For 1.2.x and earlier, see the raw Release Notes page.