import { GlIcon } from '@gitlab/ui'; import { mount } from '@vue/test-utils'; import { extendedWrapper } from 'helpers/vue_test_utils_helper'; import FeatureCard from '~/security_configuration/components/feature_card.vue'; import ManageViaMr from '~/vue_shared/security_configuration/components/manage_via_mr.vue'; import { makeFeature } from './utils'; describe('FeatureCard component', () => { let feature; let wrapper; const createComponent = (propsData) => { wrapper = extendedWrapper( mount(FeatureCard, { propsData, stubs: { ManageViaMr: true, }, }), ); }; const findLinks = ({ text, href }) => wrapper.findAll(`a[href="${href}"]`).filter((link) => link.text() === text); const findEnableLinks = () => findLinks({ text: `Enable ${feature.shortName ?? feature.name}`, href: feature.configurationPath, }); const findConfigureLinks = () => findLinks({ text: `Configure ${feature.shortName ?? feature.name}`, href: feature.configurationPath, }); const findManageViaMr = () => wrapper.findComponent(ManageViaMr); const findConfigGuideLinks = () => findLinks({ text: 'Configuration guide', href: feature.configurationHelpPath }); const findSecondarySection = () => wrapper.findByTestId('secondary-feature'); const expectAction = (action) => { const expectEnableAction = action === 'enable'; const expectConfigureAction = action === 'configure'; const expectCreateMrAction = action === 'create-mr'; const expectGuideAction = action === 'guide'; const enableLinks = findEnableLinks(); expect(enableLinks.exists()).toBe(expectEnableAction); if (expectEnableAction) { expect(enableLinks).toHaveLength(1); expect(enableLinks.at(0).props('category')).toBe('primary'); } const configureLinks = findConfigureLinks(); expect(configureLinks.exists()).toBe(expectConfigureAction); if (expectConfigureAction) { expect(configureLinks).toHaveLength(1); expect(configureLinks.at(0).props('category')).toBe('secondary'); } const manageViaMr = findManageViaMr(); expect(manageViaMr.exists()).toBe(expectCreateMrAction); if (expectCreateMrAction) { expect(manageViaMr.props('feature')).toBe(feature); } const configGuideLinks = findConfigGuideLinks(); expect(configGuideLinks.exists()).toBe(expectGuideAction); if (expectGuideAction) { expect(configGuideLinks).toHaveLength(1); } }; afterEach(() => { wrapper.destroy(); feature = undefined; }); describe('basic structure', () => { beforeEach(() => { feature = makeFeature(); createComponent({ feature }); }); it('shows the name', () => { expect(wrapper.text()).toContain(feature.name); }); it('shows the description', () => { expect(wrapper.text()).toContain(feature.description); }); it('shows the help link', () => { const links = findLinks({ text: 'Learn more', href: feature.helpPath }); expect(links.exists()).toBe(true); expect(links).toHaveLength(1); }); }); describe('status', () => { describe.each` context | available | configured | expectedStatus ${'a configured feature'} | ${true} | ${true} | ${'Enabled'} ${'an unconfigured feature'} | ${true} | ${false} | ${'Not enabled'} ${'an available feature with unknown status'} | ${true} | ${undefined} | ${''} ${'an unavailable feature'} | ${false} | ${false} | ${'Available with Ultimate'} ${'an unavailable feature with unknown status'} | ${false} | ${undefined} | ${'Available with Ultimate'} `('given $context', ({ available, configured, expectedStatus }) => { beforeEach(() => { feature = makeFeature({ available, configured }); createComponent({ feature }); }); it(`shows the status "${expectedStatus}"`, () => { expect(wrapper.findByTestId('feature-status').text()).toBe(expectedStatus); }); if (configured) { it('shows a success icon', () => { expect(wrapper.findComponent(GlIcon).props('name')).toBe('check-circle-filled'); }); } }); }); describe('actions', () => { describe.each` context | available | configured | configurationPath | canEnableByMergeRequest | action ${'unavailable'} | ${false} | ${false} | ${null} | ${false} | ${null} ${'available'} | ${true} | ${false} | ${null} | ${false} | ${'guide'} ${'configured'} | ${true} | ${true} | ${null} | ${false} | ${'guide'} ${'available, can enable by MR'} | ${true} | ${false} | ${null} | ${true} | ${'create-mr'} ${'configured, can enable by MR'} | ${true} | ${true} | ${null} | ${true} | ${'guide'} ${'available with config path'} | ${true} | ${false} | ${'foo'} | ${false} | ${'enable'} ${'available with config path, can enable by MR'} | ${true} | ${false} | ${'foo'} | ${true} | ${'enable'} ${'configured with config path'} | ${true} | ${true} | ${'foo'} | ${false} | ${'configure'} ${'configured with config path, can enable by MR'} | ${true} | ${true} | ${'foo'} | ${true} | ${'configure'} `( 'given $context feature', ({ available, configured, configurationPath, canEnableByMergeRequest, action }) => { beforeEach(() => { feature = makeFeature({ available, configured, configurationPath, canEnableByMergeRequest, }); createComponent({ feature }); }); it(`shows ${action} action`, () => { expectAction(action); }); }, ); }); describe('secondary feature', () => { describe('basic structure', () => { describe('given no secondary', () => { beforeEach(() => { feature = makeFeature(); createComponent({ feature }); }); it('does not show a secondary feature', () => { expect(findSecondarySection().exists()).toBe(false); }); }); describe('given a secondary', () => { beforeEach(() => { feature = makeFeature({ secondary: { name: 'secondary name', description: 'secondary description', configurationText: 'manage secondary', }, }); createComponent({ feature }); }); it('shows a secondary feature', () => { const secondaryText = findSecondarySection().text(); expect(secondaryText).toContain(feature.secondary.name); expect(secondaryText).toContain(feature.secondary.description); }); }); }); describe('actions', () => { describe('given available feature with secondary', () => { beforeEach(() => { feature = makeFeature({ available: true, secondary: { name: 'secondary name', description: 'secondary description', configurationPath: '/secondary', configurationText: 'manage secondary', }, }); createComponent({ feature }); }); it('shows the secondary action', () => { const links = findLinks({ text: feature.secondary.configurationText, href: feature.secondary.configurationPath, }); expect(links.exists()).toBe(true); expect(links).toHaveLength(1); }); }); describe.each` context | available | secondaryConfigPath ${'available feature without config path'} | ${true} | ${null} ${'unavailable feature with config path'} | ${false} | ${'/secondary'} `('given $context', ({ available, secondaryConfigPath }) => { beforeEach(() => { feature = makeFeature({ available, secondary: { name: 'secondary name', description: 'secondary description', configurationPath: secondaryConfigPath, configurationText: 'manage secondary', }, }); createComponent({ feature }); }); it('does not show the secondary action', () => { const links = findLinks({ text: feature.secondary.configurationText, href: feature.secondary.configurationPath, }); expect(links.exists()).toBe(false); }); }); }); }); });