mgwdev-spfx-utfx

Library to help You out with unit testing

Usage no npm install needed!

<script type="module">
  import mgwdevSpfxUtfx from 'https://cdn.skypack.dev/mgwdev-spfx-utfx';
</script>

README

mgwdev-spfx-utfx

Link to the repo

This library will help You with writing unit tests for SPFx solutions. There are three supported configuration You can use

  1. integration - which uses credentials provided in config to connect with SharePoint and uses the connection to communicate with SharePoint whenever context.spHttpClient is used.
  2. integrationWithFileGeneration - same as 1) but also generated file with responses in provided path (second argument of MockHttpClientFactory.setupContextFromConfig).
  3. isolated - tests will not communicate with Your tenant. Only data provided in file will be used.

How to use it

The scenario I had in mind is following. You write Your test in integraation mode Write the logic Test passess Switch to isolated mode You have Your unit test!

Installation

npm install mgwdev-spfx-utfx --save-dev

Simpliest setup

Here is the simpliest possible test You can write. Of course You can inject context anywhere You will need web part or extension context.

/// <reference types="jest" />

import { assert } from "chai";
import { MockHttpClientFactory, TestConfiguration, IMockSPHttpClient } from "mgwdev-spfx-utfx";

jest.mock("@microsoft/sp-http", () => {
    return {
        SPHttpClient: {
            configurations: {
                v1: 1
            }
        }
    }
});
let context;
describe("Test UTFX", () => {
    beforeAll(() => {
        let mockHttpClientFactory = new MockHttpClientFactory();
        context = mockHttpClientFactory.setupContextFromConfig({
            authenticationConfiguration: {
              username: "admin@<tenant_name>.onmicrosoft.com",
              password: "<password>", 
              online: true
            },
            siteUrl : "https://<tenant_name>.sharepoint.com",
            runConfiguration: TestConfiguration.integrationWithFileGeneration
        }, "./tests/responses/Web.json");
        return context.spHttpClient.init();
    });
    test("getWebInfo (absolute)", async () => {
        let response = await context.spHttpClient.get("https://<tenant_name>.sharepoint.com/sites/tea-point/_api/web?$select=Title");
        let result = await response.json();
        assert.equal(result.Title, "Tea Point - English");
    });
    test("getWebInfo (relative)", async () => {
        let response = await context.spHttpClient.get("/sites/tea-point/_api/web?$select=Title");
        let result = await response.json();
        assert.equal(result.Title, "Tea Point - English");
    });
    afterAll(async() => {
        await context.spHttpClient.dispose();
    });
});