Interface SpawnOpts

Options for t.spawn()

All of the normal Base and Extra options are also allowed.

interface SpawnOpts {
    args?: string[];
    at?: null | CallSiteLike | CallSiteLikeJSON;
    bail?: boolean;
    buffered?: boolean;
    childId?: number;
    command?: string;
    context?: any;
    cwd?: string;
    debug?: boolean;
    diagnostic?: boolean;
    diff?: string;
    doNotWant?: any;
    env?: {
        [k: string]: string;
    } | ProcessEnv;
    error?: any;
    errorOrigin?: {
        at?: null | CallSiteLike | CallSiteLikeJSON;
        source?: string;
        stack?: string;
    };
    exitCode?: null | number;
    expired?: string;
    failSkip?: boolean;
    failTodo?: boolean;
    found?: any;
    indent?: string;
    message?: string;
    name?: string;
    omitVersion?: boolean;
    parent?: Base<TapBaseEvents> | TestBase;
    parser?: Parser;
    passes?: boolean;
    pattern?: any;
    preserveWhitespace?: boolean;
    signal?: null | string;
    silent?: boolean;
    skip?: string | boolean;
    source?: string;
    stack?: string;
    stdio?: StdioOptions;
    strict?: boolean;
    tapChildBuffer?: string;
    test?: string;
    time?: number;
    timeout?: number;
    todo?: string | boolean;
    type?: string;
    wanted?: any;
}

Hierarchy (view full)

Properties

args? at? bail? buffered? childId? command? context? cwd? debug? diagnostic? diff? doNotWant? env? error? errorOrigin? exitCode? expired? failSkip? failTodo? found? message? name? omitVersion? parent? passes? pattern? preserveWhitespace? signal? silent? skip? source? stack? stdio? strict? test? time? timeout? todo? type? wanted?

Internal Machinery

indent? parser? tapChildBuffer?

Properties

Optional Internal args

args?: string[]

arguments to subprocess (set by second argument to t.spawn)

Optional at

at?: null | CallSiteLike | CallSiteLikeJSON

Optional bail

bail?: boolean

Bail out on the first failure

Optional buffered

buffered?: boolean

True if this test should be buffered, and only processed once complete.

Defaults to true when t.jobs is set to a value greater than 1.

If set false in that case, then the test will NOT be run in parallel, so this provides a way to control the parallelism within a test suite.

Optional childId

childId?: number

Numeric identifier attached to child tests. Most of the time, this is set based on the TAP_CHILD_ID environment variable.

Optional Internal command

command?: string

the command to run (set by first argument to t.spawn)

Optional context

context?: any

Any arbitrary data that is provided to this test object. Often, this is set in a t.before() or t.beforeEach() method. Scalar values are inherited by child tests. Object values are extended in child tests using Object.create().

If not set in the options, this is initialized to a null-prototyped object, so that usage like t.context.foo = 'bar' will work as expected.

This is initialized and set on the Test object in the runMain method, not at construction time. If set explicitly on the Test object in a before hook, then any context specified on options or inherited from the parent test will be ignored.

Optional cwd

cwd?: string

the current working directory of the subprocess

Optional debug

debug?: boolean

True to output LOTS AND LOTS of noisy debugging information. Set at the top level by the TAP_DEBUG environment variable.

Optional diagnostic

diagnostic?: boolean

Optional diff

diff?: string

Optional doNotWant

doNotWant?: any

Optional env

env?: {
    [k: string]: string;
} | ProcessEnv

Environment variables for the subprocess Defaults to process.env

Type declaration

  • [k: string]: string

Optional error

error?: any

Optional errorOrigin

errorOrigin?: {
    at?: null | CallSiteLike | CallSiteLikeJSON;
    source?: string;
    stack?: string;
}

Type declaration

Optional Internal exitCode

exitCode?: null | number

Set on exit. The exit code of the process, or null if terminated with a signal.

Optional expired

expired?: string

Optional failSkip

failSkip?: boolean

treat skip tests as failures, default false

Optional failTodo

failTodo?: boolean

treat todo tests as failures, default false

Optional found

found?: any

Optional message

message?: string

Optional name

name?: string

The name of this test

Optional omitVersion

omitVersion?: boolean

Do not emit the TAP version 14 line.

Optional parent

parent?: Base<TapBaseEvents> | TestBase

Parent test of this test

Optional passes

passes?: boolean

track passes in the results lists, default false

Optional pattern

pattern?: any

Optional preserveWhitespace

preserveWhitespace?: boolean

Do not elide empty lines and other unnecessary whitespace

Optional Internal signal

signal?: null | string

Set on exit. Terminating signal, or null of not terminated with a signal.

Optional silent

silent?: boolean

Setting silent:true in a subtest option makes it completely excluded from test output, UNLESS it fails.

This was used historically for a few things which are now implemented with a more sophisticated promise management system, but can be handy in some rare situations.

Optional skip

skip?: string | boolean

Skip this test entirely, emitting a # SKIP directive

Optional source

source?: string

Optional stack

stack?: string

The stack where this test was initiated

Optional stdio

stdio?: StdioOptions

ChildProcess stdio option. Standard output is always set to 'pipe', because that's how it communicates test results, and file descriptor 3 is set to an IPC channel for sending timeout signals.

Optional strict

strict?: boolean

Treat any unknown non-TAP data as an error May be set at run-time by the TAP stream using pragma +strict

Optional test

test?: string

Optional time

time?: number

The amount of time that this test took to complete.

Typically, this is not set explicitly, but inferred from the actual time spent. However in some cases, it may be reported by the top-level # time=... comment in a TAP subprocess stream.

Optional timeout

timeout?: number

Amount of time in milliseconds before this test times out

Optional todo

todo?: string | boolean

Mark this test as to be done later, emitting a # TODO directive

Optional type

type?: string

Optional wanted

wanted?: any

Internal Machinery

Optional Internal indent

indent?: string

Number of spaces that this test is indented.

Optional Internal parser

parser?: Parser

Parser to use for this TAP stream.

Optional Internal tapChildBuffer

tapChildBuffer?: string

The TAP data from a buffered test.

Settings

Member Visibility

Theme

On This Page

argsatbailbufferedchildIdcommandcontextcwddebugdiagnosticdiffdoNotWantenverrorerrorOriginexitCodeexpiredfailSkipfailTodofoundmessagenameomitVersionparentpassespatternpreserveWhitespacesignalsilentskipsourcestackstdiostricttesttimetimeouttodotypewantedindentparsertapChildBuffer

Generated using TypeDoc