Edit

Share via

pac test

  • Article

(Preview) Execution of automated tests for a Power App

[This article is pre-release documentation and is subject to change.]

Important

  • The run command is in public preview.
  • Preview features aren't meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.

Note

  • pac cli version 1.43 introduces incompatible changes to the pac test command. Please refer to the migration guide to use the new features.
  • With pac cli version 1.27, the pac tests command was changed to pac test. tests will continue to work, but we recommend using test going forward.

Learn more about test engine (preview)

Commands

Command Description
pac test run (Preview) Execute tests defined in a Test Plan file

pac test run

(Preview) Execute tests defined in a Test Plan file

Example

The following example runs the test plan for a canvas application defined within the testplan.te.yaml in the environment with ID 00aa00aa-bb11-cc22-dd33-44ee44ee44ee that exists in the tenant with ID aaaabbbb-0000-cccc-1111-dddd2222eeee

pac test run `
   -p "canvas" `
   -test "testplan.te.yaml" `
   -t aaaabbbb-0000-cccc-1111-dddd2222eeee `
   -env 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Required Parameters for test run

--environment-id -env

Environment ID for the app to be tested.

--tenant -t

Tenant ID for the app being tested

--test-plan-file -test

Path to the Test Plan file

Optional Parameters for test run

--auth -a

The certificate provider for the user authentication for app being tested

Use one of these values:

  • None
  • Certenv
  • Certstore

--___domain -d

The player ___domain for the app being tested for Canvas provider or endpoint for other provider types.

--log-level -l

Log detail level

Use one of these values:

  • Trace
  • Debug
  • Information
  • Warning
  • Error
  • Critical
  • None

--output-directory -o

Path to save test output and logs

--provider -p

The application type being tested

Use one of these values:

  • Canvas
  • Mda
  • Portal
  • Powerfx

--queryparams -q

Query parameters for the app being tested

--use-static-context -c

Enable use of static context for Playwright browser

This parameter requires no value. It's a switch.

--user-auth -u

The user authentication type for app being tested

Use one of these values:

  • Storagestate
  • Dataverse

See also

Microsoft Power Platform CLI Command Groups
Microsoft Power Platform CLI overview