feat(routeFromHAR): add shouldSave option to control when to save HAR files

[mskelton]

This adds a function to allow conditionally saving HAR files. This can be combined with testInfo to save HAR files only if a test passes, etc.

Example usage

it('welcome', async ({ page }, testInfo) => {
  const harPath = testInfo.outputPath('har.har');
  await page.routeFromHAR(harPath, {
    update: true,
    shouldSave: () => testInfo.status === 'passed'
  });

  await page.goto('/welcome');
  await expect(page.getByRole('heading')).toHaveText('Welcome');
});

Fixes #33559, inspired by #28796

[github-actions]

Test results for "tests 1"

36907 passed, 650 skipped
✔️✔️✔️

Merge workflow run.