migrate-protractor-to-codeceptjs

Installation
SKILL.md

Migrate Protractor → CodeceptJS 4

Protractor was end-of-lifed in April 2023. CodeceptJS 4 is a strong target: it speaks WebDriver natively (the runtime Protractor was built on) and also supports Playwright, which is faster, less flaky, and recommended for new work. The migration also retires three legacies that were already deprecated in Protractor itself: the Selenium ControlFlow, the Angular synchronization hook (waitForAngular), and .then() promise chains for queueing browser work.

Three foundational differences to internalize:

  1. No more promise chains. Protractor's .then() chains queued work on the Selenium ControlFlow; CodeceptJS auto-queues I.* calls via an internal recorder, so tests read synchronously. await is only needed for grabs (await I.grabTextFrom(...)).
  2. Helpers, not browser / driver. I.* dispatches to a configured helper. Playwright recommended; WebDriver is also available if the suite must keep running against a Selenium Grid — test code is identical either way.
  3. Auto-wait, not Angular-wait. Drop browser.waitForAngular() and browser.ignoreSynchronization. The Playwright and WebDriver helpers wait on DOM and element stability, which covers Angular's render cycle without a framework-specific hook.

Authoritative references: node_modules/codeceptjs/docs/basics.md, locators.md, playwright.md, webdriver.md, custom-helpers.md, pageobjects.md.

When to trigger

Any of:

Installs
9
GitHub Stars
1
First Seen
13 days ago
migrate-protractor-to-codeceptjs — codeceptjs/skills