Skip to content

v1.5.0 — BackOffice validated, checkout & order lifecycle, visual regression, HTTP presets

Choose a tag to compare

View all tags
@PrestaEdit PrestaEdit released this 07 Jul 07:41
· 60 commits to main since this release
v1.5.0
6089f56

Second minor release after 1.3.0. Turns the framework from nav-validated 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 — every increment validated live. Ships visual regression testing, HTTP presets (cookies, Basic Auth, User-Agent), a new RGPD FrontOffice page, cold-start resilience, and fixes several long-standing bugs in the core primitives.

✨ Added — reusable scenarios

  • CheckoutOrder — logged-in customer places an order end-to-end (login → cart → checkout tunnel → confirmation → order found in BackOffice). Live 5/5.
  • GuestCheckout — pure guest checkout with new address (personal info + address + shipping + payment + confirmation). Live 4/4.
  • ManageOrder — opens an order in the BackOffice, changes its status, adds an internal note, sets a tracking number, each verified.
  • OrderLifecycle suite — composes CheckoutOrder → ManageOrder: create then manage. Live 9/9.
  • EditProduct — self-cleaning: create a product, open it from the list, change its price, verify, delete. Live 4/4.
  • CreateProductAndVerify — BackOffice product creation + FrontOffice visibility check (cross-page BO → FO).

✨ Added — page objects & helpers

  • FrontOffice: Cart (goToCart, proceedToCheckout), Checkout (multi-step tunnel + guest steps checkoutAsGuest/fillNewAddress), OrderConfirmation (isConfirmed, getOrderReference), Rgpd (cookie-consent banner handling for the FrontOffice).
  • BackOffice: OrderView (updateStatus/hasStatusInHistory, setInternalNote/getInternalNote, addTracking/getTracking), Orders extended with openOrder, filterByReference, getOrderReferenceInList.
  • Products: real PS 9 create flow (goToNewProduct bypasses the JS type-choice modal), createProduct (name + price + quantity + activate + save), deleteProduct, openProduct, updatePrice, getFormPrice, getCreatedProductId, getCreatedProductUrl (reads the canonical FO URL from the BO Preview link).
  • FrontOfficePage::goToUrl($url) — navigate to an absolute FO URL with a clean session; Product::goToProductPath($path) — reach a product by canonical path.
  • Urls French catalog (src/Urls/fr.json): login=connexion, cart=panier?action=show, order=commande.

✨ Added — visual regression testing

  • CommonPage::visualCheckpoint($label, $fullPage = true) — take a screenshot, compare against a stored baseline, record pass/fail into the run.
  • Visual\VisualComparator — the underlying image diff engine.
  • Reports\VisualReport — renders an HTML report (reports/visual/index.html) plus a visual-results.json side-file, wired to bin/prestaflow run --visual-report[=path].
  • VIEWPORT capture mode via $fullPage = false (in addition to full-page).
  • Baselines stored in a persistent folder (outside the ephemeral screens/).

✨ Added — HTTP presets (env-driven)

  • PRESTAFLOW_USER_AGENT — sets the browser's User-Agent for the whole run.
  • PRESTAFLOW_COOKIES — preload cookies before the first navigation (awaited to be deterministic).
  • HTTP Basic Auth via env — installed at the connection level so it survives every createPage() (persistent headers are automatically re-applied by goToPage).

🔧 Changed — CommonPage primitives (behavioural supersets)

  • getInputValue now reads the live .value property via JS. Fixes <textarea> reads and any field whose current value differs from the initial value attribute.
  • selectOption/selectValue now use querySelector + dispatch change. Handle compound CSS selectors and drive select2 (previously only worked with a bare #id/.class).
  • New setValueByJs($selector, $value) — reliable JS value-set (fires input+change) for fields on inactive tabs or otherwise not focusable.
  • setValue (real click+type) intentionally unchanged.

🐛 Fixed

  • BackOffice login/menu against a live PS 9: correct selectors, French/English tolerance, sidebar sub-links resolve their real <a> href instead of clicking a wrapping <li>.
  • Flaky BO login: waitForPageReload() rewritten to Page::waitForReload(Page::LOAD, 10000) in a bounded try/catch (was evaluating a bogus JS string and hanging on chrome-php's 30s default).
  • Browser lifecycle across suites: keep the keep-alive browser open between suites; close it once per run in ExecuteSuite and clean the socket — series runs are now stable.
  • Session isolation per suite: before() clears cookies via CDP Network.clearBrowserCookies.
  • click() gets a JS-click fallback when a coordinate click can't reach the element (collapsed menu, etc.).
  • Self-signed HTTPS: Chrome launched with ignoreCertificateErrors — no more "connection not private" screen against local Valet TLS.
  • selectOption no longer writes a stray temp.log debug file at every call.
  • Product create field leak: price and quantity live on inactive Pricing/Stocks tabs; the old click+type couldn't focus them and leaked the text into the name field (products came out named PF Edit Test9.9910 with price 0). Now driven via setValueByJs.
  • BackOffice orders row link properly scoped to a[href*="/orders/"][href*="/view"] (the customer link also ends in /view).
  • Tracking read/write: the shipping-edit modal must be opened to populate its form (carrier + CSRF token); the read re-opens the modal (its field pre-fills). The Carriers-tab display cell is lazy and unreliable to read headlessly.
  • Locale propagation: scenarios now push their locale to the suite ($testSuite->params['locale']) before importing pages, so importPage resolves French friendly URLs on the FR demo shop (otherwise /login, /cart, /order fell back to English and 404'd).

🐛 Fixed — cold-start & network resilience

  • Retry the browser launch at cold start — avoids false-green runs when the initial CDP handshake fails ("Message could not be sent. Reason: the connection is closed").
  • Retry close+createPage+navigate in goToPage — swallows the sporadic cold-start getTargetInfo() on null from target enumeration.
  • Retry getPage() on the same flake.
  • Basic Auth: enable Network domain before setBasicAuthHeader (otherwise the header was silently dropped); install it at the connection level so it survives goToPage's createPage.
  • Re-apply persistent HTTP headers after every createPage() (Basic Auth / User-Agent leak-through fix).
  • await setCookies() in cookie presets — deterministic before navigation.
  • Autoload from bin/prestaflow: prefer getcwd() (project autoload) before the library's own vendor — fixes running the library installed as a Composer dep.
  • Composer symlink installs: project path resolution now handles repo symlinks correctly.
  • PRESTAFLOW_USER_AGENT is now honored in getBrowser().

🧰 CI / DX

  • CI-ready runs: non-zero exit on failure, --junit report.
  • New --visual-report[=path] option — HTML + JSON visual-regression report.
  • Vendored nunzion/php-expect (upstream became unreliable).
  • Screenshots on failure (helper + JUnit <system-out> attachment).

🧪 Tests

  • 78 browser-free structural tests / 377 assertions covering the page objects, scenarios, CommonPage primitives, VisualComparator, VisualReport.
  • New suites additionally validated live against a local PrestaShop 9.0.0-rc.1 (French demo shop): ProductsCrud 4/4 · CreateProductAndVerify 4/4 · CheckoutOrder 5/5 · OrderLifecycle 9/9 · GuestCheckout 4/4 · EditProduct 4/4. All three critical suites re-run green after the main merge — zero regression.

Full changelog: v1.3.0…v1.5.0

Test-shop notes for reviewers: uses the PrestaShop demo customer John DOE (pub@prestashop.com) with an address on file; offline payment modules must be enabled AND allowed for the destination country. For visual-regression baselines, use --visual-report and commit the persistent baseline folder alongside the suites.

Assets 2
Loading