New test

Metadata saved to the .json sidecar next to the test file

Test id — becomes part of the filename and is the permanent key for history (e.g. LOGIN-001) Language — Python runs on the bundled harness; TypeScript runs on the TS engine's @playwright/test (/opt/pw-ts) Name Description

Tags (comma separated) Target version tag Timeout seconds (0 = default) Video recording

Turn video off for tests that mostly wait. The video file grows with wall-clock time whenever the page repaints — a 30-minute wait on a page with a clock or progress bar costs about 80 MB and shows almost nothing. The activity replay still captures those runs, and stays small.

enabled

Groups

Freight extras Freight in TypeScript Freight platform Freight regression Freight smoke Python and TypeScript, side by side Smoke

Weekly schedules are managed on the Schedules page.

Playwright code an `@playwright/test` spec — `test('...', async ({ page }) => ...)`

page.goto('./') — baseURL is the target URL from config.json · await test.step('label', ...) shows in Step timings · process.env.PW_SECRET_NAME reads a hub secret · expect(...) to assert.
Editor: Ctrl-F search · Ctrl-/ comment.

“Record in a browser tab” opens the Remote Recorder: the hub drives its own bundled Chromium and you interact with a live picture of it — so it works on a deployed hub (AWS/office) and from a locked-down workstation browser. Everything finishes IN that tab: stopping offers “create a new test”, which brings you back here with the code filled in. If your browser blocks the pop-up (Safari), use the “Record new test” button on the Tests page instead — it opens in this same tab.

import { test, expect } from '@playwright/test';
import { open, signIn } from './_lib/freight';

// Drag-and-drop with rules, in TypeScript -- DEMO-021's checks with
// locator.dragTo(): allowed drops land, hazardous goods at a normal door are
// refused with the reason, and the board survives a reload (it is stored on
// the server, not just drawn).
test('trucks are scheduled by drag-and-drop, within the yard rules', async ({ page }) => {
  await signIn(page);
  await open(page, 'ops/docks/');

  const arrival = async (selector: string) =>
    (await page.locator(selector).first().getAttribute('data-arrival')) as string;
  const hazmat = await arrival("#arrivals .dock-card[data-hazardous='1']");
  const heavy = await arrival("#arrivals .dock-card[data-heavy='1'][data-hazardous='0']");
  const normal = await arrival("#arrivals .dock-card[data-heavy='0'][data-hazardous='0']");
  console.log(`hazmat ${hazmat}, heavy ${heavy}, normal ${normal}`);

  const card = (id: string) => page.locator(`.dock-card[data-arrival='${id}']`);
  const cell = (at: string) => page.locator(`td[data-cell='${at}']`);
  const placed = (id: string, at: string) => cell(at).locator(`.dock-card[data-arrival='${id}']`);

  await test.step('a normal load to Door 3, 09:00', async () => {
    await card(normal).dragTo(cell('D3|09:00'));
    await expect(placed(normal, 'D3|09:00')).toBeVisible();
  });

  await test.step('hazardous goods at Door 1 are refused', async () => {
    await card(hazmat).dragTo(cell('D1|10:00'));
    await expect(page.locator('#dock-error')).toBeVisible();
    await expect(page.locator('#dock-error')).toContainText(/hazardous/i);
    await expect(placed(hazmat, 'D1|10:00')).toHaveCount(0);
  });

  await test.step('hazardous goods at Door 4 (hazmat)', async () => {
    await card(hazmat).dragTo(cell('D4|10:00'));
    await expect(placed(hazmat, 'D4|10:00')).toBeVisible();
  });

  await test.step('a heavy load to a forklift door', async () => {
    await card(heavy).dragTo(cell('D1|11:00'));
    await expect(placed(heavy, 'D1|11:00')).toBeVisible();
  });

  await test.step('the board survives a reload', async () => {
    await page.reload();
    await expect(placed(normal, 'D3|09:00')).toBeVisible();
    await expect(placed(hazmat, 'D4|10:00')).toBeVisible();
    await expect(placed(heavy, 'D1|11:00')).toBeVisible();
  });
});

Saving writes the test file (.py or .spec.ts) and its .json sidecar — the folder stays the source of truth.

New test

Metadata saved to the .json sidecar next to the test file

Groups

Playwright code an @playwright/test spec — test('...', async ({ page }) => ...)

Playwright code an `@playwright/test` spec — `test('...', async ({ page }) => ...)`