feat: add formFiller to declaratively fill forms in page objects

[foxable]

Adds formFiller, a helper to fill forms in page objects from a data object.

• Each key maps to a form input: anything with a fill method (e.g. a Locator or a nested page object) or a filler function such as (checked) => checkbox("Accept").setChecked(checked)
• undefined values are skipped
• fields are filled in the order of the fields object
• formFiller can be nested because it returns a filler function

import { formFiller, roleLocators } from "@cronn/playwright-utils";
import type { Page } from "@playwright/test";

interface Registration {
  name: string;
  email?: string;
}

function createRegistrationForm(page: Page) {
  const { button, textbox } = roleLocators(page);

  return {
    submitButton: button("Register"),
    fill: formFiller<Registration>({
      name: textbox("Name"),
      email: textbox("Email"),
    }),
  };
}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3315509

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@cronn/playwright-utils	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR