Files
api/web/__test__/components/HeaderOsVersion.test.ts
Eli Bosley b7afaf4632 feat: add Tailwind scoping plugin and integrate into Vite config (#1722)
- Introduced a new PostCSS plugin, `scopeTailwindToUnapi`, to scope
Tailwind CSS classes to specific elements.
- Updated Vite configuration to include the new PostCSS plugin for CSS
processing.
- Enhanced theme management in the theme store to apply scoped classes
and dynamic CSS variables to multiple targets, including the document
root and elements with the `.unapi` class.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Scoped styling for embedded (.unapi) contexts and a PostCSS plugin to
automate it.
* Theme refresh after mount to propagate CSS variables to embedded
roots.
  * Exposed idempotent restart action for the Unraid API when offline.

* **Bug Fixes**
* Consistent dark mode and theme variable application across main and
embedded views.
  * Interactive element and SSO styles now apply in embedded contexts.
* Simplified changelog iframe with a reliable fallback renderer;
improved logs styling scope.

* **Tests**
* New unit tests for the scoping plugin, changelog iframe, and related
components.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-09-26 09:56:27 -04:00

186 lines
5.5 KiB
TypeScript

/**
* HeaderOsVersion Component Test Coverage
*/
import { nextTick } from 'vue';
import { setActivePinia } from 'pinia';
import { mount } from '@vue/test-utils';
import { createTestingPinia } from '@pinia/testing';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import type { TestingPinia } from '@pinia/testing';
import type { VueWrapper } from '@vue/test-utils';
import type { Error as CustomApiError } from '~/store/errors';
import type { ServerUpdateOsResponse } from '~/types/server';
import HeaderOsVersion from '~/components/HeaderOsVersion.standalone.vue';
import { useErrorsStore } from '~/store/errors';
import { useServerStore } from '~/store/server';
vi.mock('crypto-js/aes', () => ({ default: {} }));
vi.mock('@unraid/shared-callbacks', () => ({
useCallback: vi.fn(() => ({ send: vi.fn(), watcher: vi.fn() })),
}));
vi.mock('@vue/apollo-composable', () => ({
useQuery: () => ({
result: { value: {} },
loading: { value: false },
onResult: vi.fn(),
onError: vi.fn(),
}),
useLazyQuery: () => ({
result: { value: {} },
loading: { value: false },
load: vi.fn(),
refetch: vi.fn(),
onResult: vi.fn(),
onError: vi.fn(),
}),
useMutation: () => ({
mutate: vi.fn(),
onDone: vi.fn(),
onError: vi.fn(),
}),
provideApolloClient: vi.fn(),
}));
vi.mock('~/helpers/urls', async (importOriginal) => {
const actual = await importOriginal<typeof import('~/helpers/urls')>();
const mockReleaseNotesUrl = 'http://mock.release.notes/v';
const mockWebGuiToolsUpdate = '/mock/Tools/Update';
const mockWebGuiToolsDowngrade = '/mock/Tools/Downgrade';
return {
...actual,
getReleaseNotesUrl: vi.fn((version: string) => `${mockReleaseNotesUrl}${version}`),
WEBGUI_TOOLS_UPDATE: mockWebGuiToolsUpdate,
WEBGUI_TOOLS_DOWNGRADE: mockWebGuiToolsDowngrade,
};
});
vi.mock('vue-i18n', () => ({
useI18n: () => ({
t: (key: string, params?: unknown) => {
if (params && Array.isArray(params)) {
let result = key;
params.forEach((val, index) => {
result = result.replace(`{${index}}`, String(val));
});
return result;
}
const keyMap: Record<string, string> = {
'Reboot Required for Update': 'Reboot Required for Update',
'Reboot Required for Downgrade': 'Reboot Required for Downgrade',
'Updating 3rd party drivers': 'Updating 3rd party drivers',
'Update Available': 'Update Available',
'Update Released': 'Update Released',
'View release notes': 'View release notes',
};
return keyMap[key] ?? key;
},
}),
}));
describe('HeaderOsVersion', () => {
let wrapper: VueWrapper<unknown>;
let testingPinia: TestingPinia;
let serverStore: ReturnType<typeof useServerStore>;
let errorsStore: ReturnType<typeof useErrorsStore>;
const findUpdateStatusComponent = () => {
const statusElement = wrapper.find('a.group:not([title*="release notes"]), button.group');
return statusElement.exists() ? statusElement : null;
};
beforeEach(() => {
testingPinia = createTestingPinia({ createSpy: vi.fn });
setActivePinia(testingPinia);
serverStore = useServerStore();
errorsStore = useErrorsStore();
serverStore.osVersion = '6.12.0';
serverStore.rebootType = '';
serverStore.updateOsResponse = undefined;
serverStore.regExp = 0;
serverStore.updateOsIgnoredReleases = [];
errorsStore.errors = [];
wrapper = mount(HeaderOsVersion, {
global: {
plugins: [testingPinia],
},
});
});
afterEach(() => {
wrapper?.unmount();
vi.restoreAllMocks();
});
it('renders OS version button with correct version and no update status initially', () => {
// The version button is within the DropdownMenuTrigger
const versionButton = wrapper.find('[title="Version Information"]');
expect(versionButton.exists()).toBe(true);
expect(versionButton.text()).toContain('6.12.0');
// No update status button should be rendered initially
const updateButtons = wrapper.findAll('button');
const hasUpdateButton = updateButtons.some((button) => {
const title = button.attributes('title');
return title && (title.includes('Update') || title.includes('Reboot'));
});
expect(hasUpdateButton).toBe(false);
});
it('does not render update status when stateDataError is present', async () => {
const mockError: CustomApiError = {
message: 'State data fetch failed',
heading: 'Fetch Error',
level: 'error',
type: 'serverState',
};
errorsStore.errors = [mockError];
serverStore.updateOsResponse = {
version: '6.13.0',
isNewer: true,
isEligible: true,
} as ServerUpdateOsResponse;
serverStore.rebootType = '';
await nextTick();
expect(findUpdateStatusComponent()).toBeNull();
});
it('removes logo class from logo wrapper on mount', async () => {
// Create a mock logo element
const logoElement = document.createElement('div');
logoElement.classList.add('logo');
document.body.appendChild(logoElement);
// Mount component
const newWrapper = mount(HeaderOsVersion, {
global: {
plugins: [testingPinia],
},
});
// Wait for nextTick to allow onMounted to complete
await nextTick();
await nextTick(); // Double nextTick since onMounted uses nextTick internally
expect(logoElement.classList.contains('logo')).toBe(false);
// Cleanup
newWrapper.unmount();
document.body.removeChild(logoElement);
});
});