Pool Test

Pool Test Skill

Use this skill when writing unit tests for a pool:* command.

Steps

1. Create the test file at test/commands/pool/<name>.test.ts
2. Follow the sandbox pattern — use TestContext and stubSfCommandUx
3. Run tests — pnpm run test:only
4. Check coverage — review nyc output for uncovered branches

Test Template

import { TestContext } from '@salesforce/core/testSetup';
import { expect } from 'chai';
import { stubSfCommandUx } from '@salesforce/sf-plugins-core';
import <Name> from '../../../../src/commands/pool/<name>.js';

describe('pool <name>', () => {
  const $$ = new TestContext();
  let sfCommandStubs: ReturnType<typeof stubSfCommandUx>;

  beforeEach(() => {
    sfCommandStubs = stubSfCommandUx($$.SANDBOX);
  });

  afterEach(() => {
    $$.restore();
  });

  it('returns expected result', async () => {
    // arrange: stub org connections, config reads, etc.

    // act
    const result = await <Name>.run(['--target-dev-hub', '[email protected]']);

    // assert
    expect(result).to.exist;
  });

  it('handles missing config gracefully', async () => {
    try {
      await <Name>.run(['--target-dev-hub', '[email protected]']);
      expect.fail('should have thrown');
    } catch (err) {
      expect(err).to.have.property('name', 'SfError');
    }
  });
});