-
Notifications
You must be signed in to change notification settings - Fork 8.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[Endpoint] Host Details Policy Response Panel #63518
Changes from 14 commits
9950f9b
a79bc42
a6ea3fa
9e6c3f5
ed9f2c5
8b5182d
72e1c5e
0c9df52
f00bcbb
9b45f61
11e6f0c
135e014
469655f
a29a22f
9069a40
9bfbb22
c99b360
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,138 @@ | ||
/* | ||
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one | ||
* or more contributor license agreements. Licensed under the Elastic License; | ||
* you may not use this file except in compliance with the Elastic License. | ||
*/ | ||
|
||
import { Dispatch } from 'redux'; | ||
import { AppAction, GlobalState, MiddlewareFactory } from '../types'; | ||
|
||
type UnionOfActionTypeToAction<S extends AppAction = AppAction> = S extends unknown | ||
? { [K in S['type']]: S } | ||
: never; | ||
|
||
type UnionToIntersection<U> = (U extends unknown | ||
? (k: U) => void | ||
: never) extends (k: infer I) => void | ||
? I | ||
: never; | ||
|
||
type ActionsMap<A extends AppAction = AppAction> = UnionToIntersection< | ||
UnionOfActionTypeToAction<A> | ||
>; | ||
|
||
/** | ||
* Utilities for testing Redux middleware | ||
*/ | ||
export interface MiddlewareActionSpyHelper<S = GlobalState, A extends AppAction = AppAction> { | ||
/** | ||
* Returns a promise that is fulfilled when the given action is dispatched or a timeout occurs. | ||
* The `action` will given to the promise `resolve` thus allowing for checks to be done. | ||
* The use of this method instead of a `sleep()` type of delay should avoid test case instability | ||
* especially when run in a CI environment. | ||
* | ||
* @param actionType | ||
*/ | ||
waitForAction: <T extends keyof ActionsMap<A>>(actionType: T) => Promise<ActionsMap<A>[T]>; | ||
/** | ||
* A property holding the information around the calls that were processed by the internal | ||
* `actionSpyMiddlware`. This property holds the information typically found in Jets's mocked | ||
* function `mock` property - [see here for more information](https://jestjs.io/docs/en/mock-functions#mock-property) | ||
* | ||
* **Note**: this property will only be set **after* the `actionSpyMiddlware` has been | ||
* initialized (ex. via `createStore()`. Attempting to reference this property before that time | ||
* will throw an error. | ||
* Also - do not hold on to references to this property value if `jest.clearAllMocks()` or | ||
* `jest.resetAllMocks()` is called between usages of the value. | ||
*/ | ||
dispatchSpy: jest.Mock<Dispatch<A>>['mock']; | ||
/** | ||
* Redux middleware that enables spying on the action that are dispatched through the store | ||
*/ | ||
actionSpyMiddleware: ReturnType<MiddlewareFactory<S>>; | ||
} | ||
|
||
/** | ||
* Creates a new instance of middleware action helpers | ||
* Note: in most cases (testing concern specific middleware) this function should be given | ||
* the state type definition, else, the global state will be used. | ||
* | ||
* @example | ||
* // Use in Policy List middleware testing | ||
* const middlewareSpyUtils = createSpyMiddleware<PolicyListState>(); | ||
* store = createStore( | ||
* policyListReducer, | ||
* applyMiddleware( | ||
* policyListMiddlewareFactory(fakeCoreStart, depsStart), | ||
* middlewareSpyUtils.actionSpyMiddleware | ||
* ) | ||
* ); | ||
* // Reference `dispatchSpy` ONLY after creating the store that includes `actionSpyMiddleware` | ||
* const { waitForAction, dispatchSpy } = middlewareSpyUtils; | ||
* // | ||
* // later in test | ||
* // | ||
* it('...', async () => { | ||
* //... | ||
* await waitForAction('serverReturnedPolicyListData'); | ||
* // do assertions | ||
* // or check how action was called | ||
* expect(dispatchSpy.calls.length).toBe(2) | ||
* }); | ||
*/ | ||
export const createSpyMiddleware = < | ||
S = GlobalState, | ||
A extends AppAction = AppAction | ||
>(): MiddlewareActionSpyHelper<S, A> => { | ||
type ActionWatcher = (action: A) => void; | ||
|
||
const watchers = new Set<ActionWatcher>(); | ||
let spyDispatch: jest.Mock<Dispatch<A>>; | ||
|
||
return { | ||
waitForAction: async actionType => { | ||
// Error is defined here so that we get a better stack trace that points to the test from where it was used | ||
const err = new Error(`action '${actionType}' was not dispatched within the allocated time`); | ||
|
||
return new Promise<ActionsMap<A>[typeof actionType]>((resolve, reject) => { | ||
const watch: ActionWatcher = action => { | ||
if (action.type === actionType) { | ||
watchers.delete(watch); | ||
clearTimeout(timeout); | ||
resolve((action as unknown) as ActionsMap<A>[typeof actionType]); | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I had to this this casting here (which I think is safe being that we are inside of the |
||
} | ||
}; | ||
|
||
// We timeout before jest's default 5s, so that a better error stack is returned | ||
const timeout = setTimeout(() => { | ||
watchers.delete(watch); | ||
reject(err); | ||
}, 4500); | ||
watchers.add(watch); | ||
}); | ||
}, | ||
|
||
get dispatchSpy() { | ||
if (!spyDispatch) { | ||
throw new Error( | ||
'Spy Middleware has not been initialized. Access this property only after using `actionSpyMiddleware` in a redux store' | ||
); | ||
} | ||
return spyDispatch.mock; | ||
}, | ||
|
||
actionSpyMiddleware: api => { | ||
return next => { | ||
spyDispatch = jest.fn(action => { | ||
next(action); | ||
// loop through the list of watcher (if any) and call them with this action | ||
for (const watch of watchers) { | ||
watch(action); | ||
} | ||
return action; | ||
}); | ||
return spyDispatch; | ||
}; | ||
}, | ||
}; | ||
}; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@oatkiller could you review and comment on this change?
This goes along with a change to the
appStoreMiddleware()
(see further below). It enables us to inject theactionSpyMiddleware
into the application store for testing purposes.Let me know your thoughts
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I generally think this makes sense. One thought though:
When looking at the
appStoreFactory
, I see these comments:Based on those, could we replace:
with:
Let me know your thoughts
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the comments. Yeah, that makes sense. I assume that would be (from our
types.ts
) -ReturnType<MiddlewareFactory>
so that it is correctly typed for the dispatch signature.