salesforce-utam

Salesforce testing for Playwright, built on playwright-utam: passwordless org authentication through the sf CLI, Lightning-aware fixtures and navigation, and the full UTAM page-object ecosystem.

Usage

import { test, expect } from 'salesforce-utam';
import HighlightsPanel from 'salesforce-pageobjects/force/pageObjects/highlightsPanel';

test.use({ sfOptions: { targetOrg: 'my-org' } });

test('record page', async ({ sf, utam }) => {
  await sf.goToRecord('Account', accountId);
  const highlights = await utam.load(HighlightsPanel);
  expect(await highlights.getPrimaryField()).toContain('Acme');
});

Requires the Salesforce CLI with an authenticated org:

npm install --global @salesforce/cli
sf org login web --alias my-org

What's included

• test / expect — Playwright test extended with sf (logged-in Lightning page helper), sfOrg (connection info), and utam (UTAM loader) fixtures.
• SalesforcePage — login, goToPath, goToRecord, goToObjectHome, goToApp, waitForReady (spinner-settled), waitForToast.
• salesforceStorageState — produce a storageState file for Playwright projects.
• getOrgConnection / frontdoorUrl — sf CLI session plumbing.
• soql / createRecord / deleteRecord — CLI-backed test-data helpers.

Authentication uses the CLI's access token via frontdoor.jsp (the mechanism behind sf org open); no username or password ever appears in test code.