aer
Aer Test

aer test

Run test methods in Apex source from one or more directories

aer test [directories...] [flags]

Options

      --all-exceptions             show details about all caught exceptions
  -p, --assign-perms strings       assign permission sets to the default sandbox user (canonical Name or NamespacePrefix__Name, repeatable)
      --bootstrap-db string        bootstrap SQLite database to seed before running tests
      --bootstrap-tables strings   comma-separated list of tables to copy from bootstrap database (default: all tables)
      --coverage string            write Apex code coverage to file
      --coverage-format string     coverage output format: cobertura, json (default: auto-detect from file extension)
      --critical                   include tests marked @IsTest(critical=true); when used alone, runs only critical tests
      --db string                  SQLite database file to use (for debugging, default: in-memory)
      --debug                      enable DAP debug mode
  -d, --default-namespace string   treat loaded code as if it belongs to the specified namespace
  -n, --dry-run                    show tests that would be run without executing them
      --faketime string            starting time for DateTime.now() and Date.today(); time advances normally from this point (RFC3339 format, e.g., 2025-10-26T18:00:00-05:00)
      --feature strings            enable optional features (PersonAccounts, HealthCloud, LiveAgent, MultiCurrency)
  -f, --filter strings             filter tests by name (substring match or glob pattern, can be specified multiple times)
      --filter-path strings        filter tests by source file path (prefix match or glob pattern with ** support)
      --for strings                run tests marked @IsTest(testFor=...) for the specified targets (can be specified multiple times)
  -h, --help                       help for test
      --json string[="-"]          write test results as JSONL (use --json or --json=FILE)
      --junit string               write JUnit XML test results to file
      --no-flow-conversion         disable converting record-triggered flows to generated Apex
      --package strings            package files to load (can be specified multiple times)
      --package-dir strings        directories containing .pkg files to load (can be specified multiple times)
      --profile file[="-"]         write Apex profiling data to file (use --profile without a file to open in Perfetto)
  -q, --quiet                      only output failures and summary
      --read-only                  run tests with application read-only mode (disables DML operations)
      --role string                role for the default test user; created if it does not exist
      --sandbox                    set Organization.IsSandbox to true
      --skip strings               exclude tests by name (substring match, applied after filter, can be specified multiple times)
      --skip-errors                display but skip parse and type checking errors, allowing tests to run if they don't depend on invalid files
      --timeout int                timeout in seconds for each test (0 = no timeout) (default 300)
      --timezone string            default timezone for test users (e.g., America/Los_Angeles, America/Chicago)
      --trace file[="-"]           write Apex execution trace to file (use --trace without a file to open in Perfetto)
      --watch                      watch inputs for changes and re-run specified tests

Options inherited from parent commands

  -v, --verbose count   increase verbosity (repeat for more detail)

SEE ALSO

  • aer - aer is the Apex Execution Runtime
© 2012–2026 October Swimmer.