70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
|
# React Inversion Of Control Web Part with Unit Tests using Jest and Enzyme
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
This web part is provided as an example of implementing an IoC (Inversion of Control) pattern in the context of a SharePoint Framework web part.
|
||
|
|
|
||
|
|
Following this pattern greatly improves the modularity, maintainability, and testability of the code.
|
||
|
|
|
||
|
|
The example includes 100% test coverage, using Jest and Enzyme, of .ts and .tsx files, excluding *WebPart.ts files. A dependency injector class specific to a web part class is used to map web part properties to component properties and create dependencies. This pattern is designed to remove logic from the *WebPart.ts file, the only ts file that isn't unit tested, and hence ensure that all relevant web part logic is tested.
|
||
|
|
|
||
|
|
Included in the coverage is a cache and logger class, along with a service class that fetches data asychronously using @PnP/sp and dynamic bundling.
|
||
|
|
|
||
|
|
The example also includes a pipeline definition .yaml file for Azure DevOps CI build pipeline (/pipelines/) which includes the build, running tests, and posting the test coverage results.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Used SharePoint Framework Version
|
||
|
|
|
||
|
|
|
||
|
|
## Applies to
|
||
|
|
|
||
|
|
* [SharePoint Framework](https:/dev.office.com/sharepoint)
|
||
|
|
* [Office 365 tenant](https://dev.office.com/sharepoint/docs/spfx/set-up-your-development-environment)
|
||
|
|
|
||
|
|
|
||
|
|
## Solution
|
||
|
|
|
||
|
|
Solution|Author(s)
|
||
|
|
--------|---------
|
||
|
|
react-ioc-tests | Paul Ryan
|
||
|
|
|
||
|
|
## Version history
|
||
|
|
|
||
|
|
Version|Date|Comments
|
||
|
|
-------|----|--------
|
||
|
|
1.0|March 20, 2019|Initial release
|
||
|
|
|
||
|
|
## Disclaimer
|
||
|
|
**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Minimal Path to Awesome
|
||
|
|
|
||
|
|
- Clone this repository
|
||
|
|
- in the command line run:
|
||
|
|
- `npm install`
|
||
|
|
- *`npm test`*
|
||
|
|
- `gulp serve`
|
||
|
|
|
||
|
|
## Features
|
||
|
|
This web part is provided as an example of implementing an IoC (Inversion of Control) pattern in the context of a SharePoint Framework web part.
|
||
|
|
This Web Part illustrates the following concepts on top of the SharePoint Framework:
|
||
|
|
|
||
|
|
- Inversion of Control pattern
|
||
|
|
- Unit testing with Jest and Enzyme
|
||
|
|
- Azure DevOps CI Build Pipeline yaml definition file, includes running tests and checking code coverage
|
||
|
|
|
||
|
|
## References
|
||
|
|
|
||
|
|
https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-jest-testing
|
||
|
|
|
||
|
|
https://blog.velingeorgiev.com/unit-test-your-sharepoint-framework-solution-with-jest
|
||
|
|
|
||
|
|
https://www.eliostruyf.com/sharepoint-framework-unit-tests-with-jest/
|
||
|
|
|
||
|
|
https://github.com/estruyf/spfx-testing-jest
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-ioc-tests" />
|