Run Apex Tests

Run All Apex Tests

This command runs all Apex tests in the scratch org asynchronously. Rather than display the actual test results, the command outputs the force:apex:test:report command that you then run to view the full results.

1sfdx force:apex:test:run

Run Specific Apex Tests

Use --testlevel to run a subset of tests. See Understanding Deploy in the Apex Developer Guide for the list of possible test level values.

1sfdx force:apex:test:run --testlevel RunLocalTests

Use the --synchronous parameter to run tests synchronously. The command waits to display the test results until all tests have completed.

1sfdx force:apex:test:run --synchronous --classnames TestA

Use parameters to list the test classes or suites to run, specify the output format, view code coverage results, and more. For example, the following command runs the TestA and TestB test classes, provides results in Test Anything Protocol (TAP) format, and requests code coverage results.

1sfdx force:apex:test:run --classnames "TestA,TestB" --resultformat tap --codecoverage

Use the --tests parameter to run specific test methods using the standard notation Class.method. If you’re testing a managed package, use namespace.Class.method. If you specify a test class without a method, the command runs all methods in the class. This example shows how to run two methods in the TestA class and all methods in the TestB class.

1sfdx force:apex:test:run --tests "TestA.excitingMethod,TestA.boringMethod,TestB"

Here’s the same example but with a namespace.

1sfdx force:apex:test:run --tests "ns.TestA.excitingMethod,ns.TestA.boringMethod,ns.TestB"

You can specify either --tests or --classnames with force:apex:test:run but not both.

View Test Results

Run the force:apex:test:report command to view the results. The results include the outcome of individual tests, how long each test ran, and the overall pass and fail rate.

1sfdx force:apex:test:report --testrunid 7074C00000988ax