API Documentation / @pinia/testing / TestingOptions
Interface: TestingOptions
@pinia/testing.TestingOptions
Properties
createSpy
• Optional
createSpy: (fn?
: (...args
: any
[]) => any
) => (...args
: any
[]) => any
Function used to create a spy for actions and $patch()
. Pre-configured with jest.fn
in Jest projects or vi.fn
in Vitest projects if globals: true
is set.
Type declaration
▸ (fn?
): (...args
: any
[]) => any
Parameters
Name | Type |
---|---|
fn? | (...args : any []) => any |
Returns
fn
▸ (...args
): any
Parameters
Name | Type |
---|---|
...args | any [] |
Returns
any
fakeApp
• Optional
fakeApp: boolean
Creates an empty App and calls app.use(pinia)
with the created testing pinia. This allows you to use plugins while unit testing stores as plugins will wait for pinia to be installed in order to be executed. Defaults to false.
initialState
• Optional
initialState: StateTree
Allows defining a partial initial state of all your stores. This state gets applied after a store is created, allowing you to only set a few properties that are required in your test.
plugins
• Optional
plugins: PiniaPlugin
[]
Plugins to be installed before the testing plugin. Add any plugins used in your application that will be used while testing.
stubActions
• Optional
stubActions: boolean
When set to false, actions are only spied, but they will still get executed. When set to true, actions will be replaced with spies, resulting in their code not being executed. Defaults to true. NOTE: when providing createSpy()
, it will only make the fn
argument undefined
. You still have to handle this in createSpy()
.
stubPatch
• Optional
stubPatch: boolean
When set to true, calls to $patch()
won't change the state. Defaults to false. NOTE: when providing createSpy()
, it will only make the fn
argument undefined
. You still have to handle this in createSpy()
.
stubReset
• Optional
stubReset: boolean
When set to true, calls to $reset()
won't change the state. Defaults to false.