agent-js-playwright-mt v1.0.9

@reportportal/agent-js-playwright

Agent for integration Playwright with ReportPortal.

• More about Playwright
• More about ReportPortal

Installation

Install the agent in your project:

npm install --save-dev @reportportal/agent-js-playwright

Configuration

1. Create playwright.config.ts or *.config.js file with reportportal configuration:

  import { PlaywrightTestConfig } from '@playwright/test';

  const RPconfig = {
    token: '00000000-0000-0000-0000-000000000000',
    endpoint: 'https://your.reportportal.server/api/v1',
    project: 'Your project',
    launch: 'Playwright test',
    attributes: [
      {
        key: 'key',
        value: 'value',
      },
      {
        value: 'value',
      },
    ],
    description: 'Your launch description',
  };

  const config: PlaywrightTestConfig = {
    reporter: [['@reportportal/agent-js-playwright', RPconfig]],
    testDir: './tests',
  };
  export default config;

2. Add script to package.json file:

{
  "scripts": {
    "test": "npx playwright test --config=playwright.config.ts"
  }
}

Reporting

When organizing tests, specify titles for test.describe blocks, as this is necessary to build the correct structure of reports.

It is also required to specify playwright project names in playwright.config.ts when running the same tests in different playwright projects.

Attachments

Attachments can be easily added during test run via testInfo.attachments according to the Playwright docs.

import { test, expect } from '@playwright/test';

test('basic test', async ({ page }, testInfo) => {
  await page.goto('https://playwright.dev');

  // Capture a screenshot and attach it.
  const path = testInfo.outputPath('screenshot.png');
  await page.screenshot({ path });
  testInfo.attachments.push({ name: 'screenshot', path, contentType: 'image/png' });
});

Note: attachment body can be provided instead of path.

As an alternative to this approach the ReportingAPI methods can be used.

Logging

You can use the following console native methods to report logs to tests:

console.log();
console.info();
console.debug();
console.warn();
console.error();

consolelog, info,dubug report as info log.

console error, warn report as error log if message contains "error" mention. In other cases report as warn log.

As an alternative to this approach the ReportingAPI methods can be used.

Reporting API

This reporter provides Reporting API to use it directly in tests to send some additional data to the report.

To start using the ReportingApi in tests, just import it from '@reportportal/agent-js-playwright':

import { ReportingApi } from '@reportportal/agent-js-playwright';

Reporting API methods

The API provide methods for attaching data (logs, attributes, testCaseId, status). All ReportingApi methods have an optional suite parameter. If you want to add a data to the suite, you must pass the suite name as the last parameter.

addAttributes

Add attributes (tags) to the current test. Should be called inside of corresponding test. ReportingApi.addAttributes(attributes: Array<Attribute>, suite?: string); required: attributes optional: suite Example:

test('should have the correct attributes', () => {
  ReportingApi.addAttributes([
    {
      key: 'testKey',
      value: 'testValue',
    },
    {
      value: 'testValueTwo',
    },
  ]);
  expect(true).toBe(true);
});

setTestCaseId

Set test case id to the current test (About test case id). Should be called inside of corresponding test. ReportingApi.setTestCaseId(id: string, suite?: string); required: id optional: suite If testCaseId not specified, it will be generated automatically based on codeRef. Example:

test('should have the correct testCaseId', () => {
  ReportingApi.setTestCaseId('itemTestCaseId');
  expect(true).toBe(true);
});

log

Send logs to report portal for the current test. Should be called inside of corresponding test. ReportingApi.log(level: LOG_LEVELS, message: string, file?: Attachment, suite?: string); required: level, message optional: file, suite where level can be one of the following: TRACE, DEBUG, WARN, INFO, ERROR, FATAL Example:

test('should contain logs with attachments',() => {
  const fileName = 'test.jpg';
  const fileContent = fs.readFileSync(path.resolve(__dirname, './attachments', fileName));
  const attachment = {
    name: fileName,
    type: 'image/jpg',
    content: fileContent.toString('base64'),
  };
  ReportingApi.log('INFO', 'info log with attachment', attachment);

  expect(true).toBe(true);
});

info, debug, warn, error, trace, fatal

Send logs with corresponding level to report portal for the current test. Should be called inside of corresponding test. ReportingApi.info(message: string, file?: Attachment, suite?: string); ReportingApi.debug(message: string, file?: Attachment, suite?: string); ReportingApi.warn(message: string, file?: Attachment, suite?: string); ReportingApi.error(message: string, file?: Attachment, suite?: string); ReportingApi.trace(message: string, file?: Attachment, suite?: string); ReportingApi.fatal(message: string, file?: Attachment, suite?: string); required: message optional: file, suite Example:

test('should contain logs with attachments', () => {
    ReportingApi.info('Log message');
    ReportingApi.debug('Log message');
    ReportingApi.warn('Log message');
    ReportingApi.error('Log message');
    ReportingApi.trace('Log message');
    ReportingApi.fatal('Log message');
    
    expect(true).toBe(true);
});

launchLog

Send logs to report portal for the current launch. Should be called inside of the any test or suite. ReportingApi.launchLog(level: LOG_LEVELS, message: string, file?: Attachment); required: level, message optional: file where level can be one of the following: TRACE, DEBUG, WARN, INFO, ERROR, FATAL Example:

test('should contain logs with attachments', async () => {
  const fileName = 'test.jpg';
  const fileContent = fs.readFileSync(path.resolve(__dirname, './attachments', fileName));
  const attachment = {
    name: fileName,
    type: 'image/jpg',
    content: fileContent.toString('base64'),
  };
  ReportingApi.launchLog('INFO', 'info log with attachment', attachment);

  await expect(true).toBe(true);
});

launchInfo, launchDebug, launchWarn, launchError, launchTrace, launchFatal

Send logs with corresponding level to report portal for the current launch. Should be called inside of the any test or suite. ReportingApi.launchInfo(message: string, file?: Attachment); ReportingApi.launchDebug(message: string, file?: Attachment); ReportingApi.launchWarn(message: string, file?: Attachment); ReportingApi.launchError(message: string, file?: Attachment); ReportingApi.launchTrace(message: string, file?: Attachment); ReportingApi.launchFatal(message: string, file?: Attachment); required: message optional: file Example:

test('should contain logs with attachments', () => {
    ReportingApi.launchInfo('Log message');
    ReportingApi.launchDebug('Log message');
    ReportingApi.launchWarn('Log message');
    ReportingApi.launchError('Log message');
    ReportingApi.launchTrace('Log message');
    ReportingApi.launchFatal('Log message');
    
    expect(true).toBe(true);
});

setStatus

Assign corresponding status to the current test item. Should be called inside of corresponding test. ReportingApi.setStatus(status: string, suite?: string); required: status optional: suite where status must be one of the following: passed, failed, stopped, skipped, interrupted, cancelled Example:

test('should have status FAILED', () => {
    ReportingApi.setStatus('failed');
    
    expect(true).toBe(true);
});

setStatusFailed, setStatusPassed, setStatusSkipped, setStatusStopped, setStatusInterrupted, setStatusCancelled

Assign corresponding status to the current test item. Should be called inside of corresponding test. ReportingApi.setStatusFailed(suite?: string); ReportingApi.setStatusPassed(suite?: string); ReportingApi.setStatusSkipped(suite?: string); ReportingApi.setStatusStopped(suite?: string); ReportingApi.setStatusInterrupted(suite?: string); ReportingApi.setStatusCancelled(suite?: string); optional: suite Example:

test('should call ReportingApi to set statuses', () => {
    ReportingAPI.setStatusFailed();
    ReportingAPI.setStatusPassed();
    ReportingAPI.setStatusSkipped();
    ReportingAPI.setStatusStopped();
    ReportingAPI.setStatusInterrupted();
    ReportingAPI.setStatusCancelled();
});

setLaunchStatus

Assign corresponding status to the current launch. Should be called inside of the any test or suite. ReportingApi.setLaunchStatus(status: string); required: status where status must be one of the following: passed, failed, stopped, skipped, interrupted, cancelled Example:

test('launch should have status FAILED',  () => {
    ReportingApi.setLaunchStatus('failed');
    expect(true).toBe(true);
});

setLaunchStatusFailed, setLaunchStatusPassed, setLaunchStatusSkipped, setLaunchStatusStopped, setLaunchStatusInterrupted, setLaunchStatusCancelled

Assign corresponding status to the current test item. Should be called inside of the any test or suite. ReportingApi.setLaunchStatusFailed(); ReportingApi.setLaunchStatusPassed(); ReportingApi.setLaunchStatusSkipped(); ReportingApi.setLaunchStatusStopped(); ReportingApi.setLaunchStatusInterrupted(); ReportingApi.setLaunchStatusCancelled(); Example:

test('should call ReportingApi to set launch statuses', () => {
    ReportingAPI.setLaunchStatusFailed();
    ReportingAPI.setLaunchStatusPassed();
    ReportingAPI.setLaunchStatusSkipped();
    ReportingAPI.setLaunchStatusStopped();
    ReportingAPI.setLaunchStatusInterrupted();
    ReportingAPI.setLaunchStatusCancelled();
});

Integration with Sauce Labs

To integrate with Sauce Labs just add attributes for the test case:

[{
 "key": "SLID",
 "value": "# of the job in Sauce Labs"
}, {
 "key": "SLDC",
 "value": "EU (your job region in Sauce Labs)"
}]