Testing

You can also execute the CLI command for running Apex tests (force:apex:test:run) from within third-party continuous integration tools, such as Jenkins.

To run Apex tests from the command line:

This command runs all Apex tests in the scratch org asynchronously and then outputs a job ID. Pass the ID to 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.

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

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.

Use the --tests parameter to run specific test methods using the standard notation Class.method. If you are 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.

Here’s the same example but with a namespace.

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