sf apex run test command: can the "Test Results" and "Apex Code Coverage by Class" rows be sorted?

[AndrewStopchenko-SO]

The problem

When running Apex Tests in a VSCode project, the results seem to pass-through the sf apex run test output. But items in the Test Results and Apex Code Coverage by Class tables don't seem to follow any particular sorting at the moment.

Here is an example of the sf apex run test -c -y output for the dreamhouse-lwc sample project:

=== Test Results
TEST NAME                                                 OUTCOME  MESSAGE  RUNTIME (MS)
────────────────────────────────────────────────────────  ───────  ───────  ────────────
TestPropertyController.testGetPagedPropertyList           Pass              1293        
TestPropertyController.testGetPicturesNoResults           Pass              42          
TestPropertyController.testGetPicturesWithResults         Pass              363         
TestSampleDataController.importSampleData                 Pass              241         
FileUtilitiesTest.createFileFailsWhenIncorrectBase64Data  Pass              97          
FileUtilitiesTest.createFileFailsWhenIncorrectFilename    Pass              28          
FileUtilitiesTest.createFileFailsWhenIncorrectRecordId    Pass              269         
FileUtilitiesTest.createFileSucceedsWhenCorrectInput      Pass              286         
GeocodingServiceTest.blankAddress                         Pass              23          
GeocodingServiceTest.errorResponse                        Pass              5           
GeocodingServiceTest.successResponse                      Pass              5           


=== Apex Code Coverage by Class
CLASSES               PERCENT  UNCOVERED LINES
────────────────────  ───────  ───────────────
PagedResult           100%                    
SampleDataController  100%                    
FileUtilities         100%                    
GeocodingService      100%                    
PropertyController    100%                    




=== Test Summary
NAME                 VALUE                        
───────────────────  ─────────────────────────────
Outcome              Passed                       
Tests Ran            11                           
Pass Rate            100%                         
Fail Rate            0%                           
Skip Rate            0%                           
Test Run Id          707DP00003RFnrN              
Test Setup Time      0 ms                         
Test Execution Time  2652 ms                      
Test Total Time      2652 ms                      
Org Id               00DDP000006EfNL2A0           
Username             test-tsrbq87ylkae@example.com
Org Wide Coverage    100%                         

This demo project has just 5 ApexClasses that are being tested, and all of them have 100% coverage, but Apex Classes are not sorted alphabetically by the class name:

• PagedResult
• SampleDataController
• FileUtilities
• GeocodingService
• PropertyController

Imagine scanning through a list of 50+ (shuffled) classes when working on a bigger project, while trying to raise test coverage for a particular Apex class?.. That's my day-to-day if trying to use test results output with VSCode extensions. 😅

Workaround

I often go to the Developer Console > "Tests" bottom tab > "Overall Code Coverage" table, as it allows sorting the aggregated test results by either ClassName, or by Coverage% values. Both sorting options are useful: developer might be interested in finding particular class' Coverage% (then need to sort by ClassName and find the needed row), or, could sort the rows by Coverage% asc/desc to check classes with least/most coverage.

Suggested sorting for CLI command output

• "Test Results" table:

  • [1] sort by Outcome desc, so that any "Fail" rows appear in the output last. On larger projects, the list of entries might be very long thus Fail rows printed first might get cut-off by the terminal
  • [2] sort by Test Name asc (which is ${ApexClassName}.${testMethodName})

• "Apex Code Coverage by Class" table:

  • by default, sorts by ClassName asc.
  • (optional) allow sorting by Coverage% value in asc/desc order (passing some extra flag?).