Class AftJestTest

expects to be passed a context scope from an executing Jest test. for Jest, the JestExpect type contains this so you can use an expect like follows:

test('perform some testing', () => {
    const t = new AftJestTest(expect, () => doStuff());
})

Param

the expect object from within a Jest test

Hierarchy

  • AftTest
    • AftJestTest

Constructors

constructor

Properties

description test

Accessors

aftCfg buildInfoManager elapsed policyManager reporter results status testIds

Methods

_done _generateTestResult _generateTestResults _logResultStatus _parseOptionsAndSetDefaults _started _submitRemainingResults _submitResult _testIdHasResult fail pass pending run shouldRun skipped verify

Constructors

constructor

  • expects to be passed a context scope from an executing Jest test. for Jest, the JestExpect type contains this so you can use an expect like follows:

    test('perform some testing', () => {
        const t = new AftJestTest(expect, () => doStuff());
    })

    Parameters

    • Optional scope: any

      the expect object from within a Jest test

    • Optional testFunction: AftTestFunction
    • Optional options: AftTestOptions

    Returns AftJestTest

Properties

Readonly description

description: string

Readonly test

test: AssertionResult

reference to the Jest.TestCaseResult

NOTE:

this is only set from inside the Jest Reporter plugin and not available within a Jest test function

Accessors

aftCfg

  • get aftCfg(): AftConfig

  • Returns AftConfig

buildInfoManager

  • get buildInfoManager(): BuildInfoManager

  • a BuildInfoManager instance used to generate a Build Number and Build Name from the first loaded BuildInfoPlugin

    Returns BuildInfoManager

elapsed

  • get elapsed(): number

  • returns the amount of time, in milliseconds, elapsed since the AftTest was started either by calling the run function or using aftTest(description, testFunction, options) helper function until it ended or now if not yet done

    NOTE

    this includes the time taken to query any PolicyPlugin instances

    Returns number

policyManager

  • get policyManager(): PolicyManager

  • a PolicyManager instance used to determine if this AftTest should run by querying all loaded PolicyPlugin instances

    Returns PolicyManager

reporter

  • get reporter(): ReportingManager

  • a ReportingManager that uses the description property of this AftTest as the name or the ReportingManager passed in via AftTestOptions

    Returns ReportingManager

results

  • get results(): TestResult[]

  • returns an array of TestResult objects for each result already submitted via a call to verify, pass, fail or pending or the completion of the testFunction execution within the run function

    NOTE:

    one result is submitted for each associated Test ID or just one overall result if no Test IDs are associated with this instance if withFileSystemCache is enabled this includes searching the filesystem cache for any logged test results for the AftTest.description and returning the results as an array of TestResult objects with each object corresponding to a Test ID referenced in the test name

    Returns TestResult[]

    an array of TestResult objects where each entry corresponds to a referenced Test ID parsed from the AftTest.description

status

  • get status(): TestStatus

  • returns the overall status of this AftTest. this value is only updated when a AftTest.fail(...) call is made or a AftTest.verify(actual, expected) check fails or when the test completes without error. otherwise the value will be 'untested'

    Returns TestStatus

testIds

  • get testIds(): string[]

  • an array of string values representing the associated test IDs for this AftTest. for each test ID a unique result can and will be reported during or on the completion of running the testFunction

    ex: ["C1234", "C2345"]

    Returns string[]

Methods

Protected _done

  • _done(): Promise<void>

  • Returns Promise<void>

Protected _generateTestResult

  • _generateTestResult(status, resultMessage, testId?): Promise<TestResult>

  • Parameters

    • status: TestStatus
    • resultMessage: string
    • Optional testId: string

    Returns Promise<TestResult>

Protected _generateTestResults

  • _generateTestResults(status, logMessage, ...testIds): Promise<TestResult[]>

  • Parameters

    • status: TestStatus
    • logMessage: string
    • Rest ...testIds: string[]

    Returns Promise<TestResult[]>

Protected _logResultStatus

  • _logResultStatus(status, message?): Promise<void>

  • Parameters

    • status: TestStatus
    • Optional message: string

    Returns Promise<void>

Protected _parseOptionsAndSetDefaults

  • _parseOptionsAndSetDefaults(options?): AftTestOptions

  • Parameters

    • Optional options: AftTestOptions

    Returns AftTestOptions

Protected _started

  • _started(): Promise<void>

  • Returns Promise<void>

Protected _submitRemainingResults

  • _submitRemainingResults(status, message?): Promise<void>

  • Parameters

    • status: TestStatus
    • Optional message: string

    Returns Promise<void>

Protected _submitResult

  • _submitResult(status, message?, ...testIds): Promise<void>

  • creates TestResult objects for each testId and sends these to the ReportingManager.submitResult function

    Parameters

    • status: TestStatus
    • Optional message: string
    • Rest ...testIds: string[]

    Returns Promise<void>

Protected _testIdHasResult

  • _testIdHasResult(testId): boolean

  • Parameters

    • testId: string

    Returns boolean

fail

  • executes any 'fail' event actions after submitting a 'failed' result for each associated test ID and then throws a AftTestFailError to halt execution of the testFunction (if running)

    Parameters

    • Optional message: string

      an optional message to describe why the test is being marked as 'failed'

    Returns Promise<void>

    Default

    "unknown error occurred"

pass

  • executes any 'pass' event actions after submitting a 'passed' result for each associated test ID and then throws a AftTestPassError to halt execution of the testFunction (if running)

    Returns Promise<void>

pending

  • executes any 'skipped' event actions after submitting a 'skipped' result for each associated test ID and then throws a AftTestPendingError to halt execution of the testFunction (if running)

    Parameters

    • Optional message: string

      an optional message to describe why the test is being skipped

    Returns Promise<void>

    Default

    "test skipped"

run

  • this function handles event actions and checking the PolicyManager to determine if the supplied testFunction should be run. immediately prior to executing the testFunction the _started function is called followed by execution of the testFunction and then calling _done

    NOTE

    if using the aftTest helper function then run is automatically called, otherwise it must manually be called to run the testFunction

    Returns Promise<AftJestTest>

    this AftTest instance

shouldRun

  • checks if any of the supplied test ids should be run and returns true if at least one of them should

    Returns Promise<ProcessingResult<boolean>>

    a ProcessingResult<boolean> indicating if the testing should proceed

skipped

verify

  • performs a comparison of an actual and expected result. by default any error will result in halting the execution of the AftTest and reporting a failure, but by setting the haltOnVerifyFailure option to false you can allow the test execution to continue and only report the failure at the completion of running the testFunction

    ex:

    // no message and continues on verify failure
    await aftTest('continue on failure', async (v: AftTest) => {
        await v.verify(true, false);
        // below will run because "haltOnVerifyFailure" is "false"
        // but overall status will be 'failed' because above
        // call fails
        await v.verify(true, true);
    }, {haltOnVerifyFailure: false});

    // message with test ID (failure)
    await aftTest('[C1234] error on failure', async (v: AftTest) => {
        // submits `TestResult` for test ID `C1234` with `status='failed'`
        // and `message="C1234 - expected 'false' to be 'true'"`
        await v.verify(true, false, '[C1234]');
    });

    // message with test ID (success)
    await aftTest('[C1234] successful test', async (v: AftTest) => {
        // submits `TestResult` for test ID `C1234` with `status='passed'`
        await v.verify(true, true, '[C1234]');
    });

    Parameters

    • actual: any

      the actual result from some action

    • expected: any

      the expected result from the action

    • Optional message: string

      an optional message to include before any error string when a failure occurs. this may also include any test ID(s) in the form "...[TestID]..." and if included will result in a call to pass or fail with the associated test ID(s)

    Returns Promise<ProcessingResult<boolean>>

    a ProcessingResult<boolean> where ProcessingResult.result === true equates to success and ProcessingResult.result !== true equates to failure.

    NOTE:

    if a message argument is passed to the verify call then it will be included in the message property of the returned ProcessingResult

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc