v7.0.0-beta.2 release
This commit is contained in:
1 parent
6595fd0eb5
commit
fa8eba7a0d
1165 files changed
+107118
-762127
No files matched your search
@@ -63,8 +63,9 @@ export class ModuleAssetLoader {
|
||||
/**
|
||||
* 활성화된 모듈들의 에셋을 로드합니다.
|
||||
*
|
||||
* 우선순위 순으로 정렬하여 순차적으로 로드합니다.
|
||||
* CSS는 병렬로 로드하고, JS는 순차적으로 로드합니다.
|
||||
* CSS/JS 모두 병렬 fetch로 로드합니다. JS는 `script.async = false` +
|
||||
* 정렬된 DOM append 순서로 **실행 순서는 priority 정렬대로** 보장됩니다.
|
||||
* (HTML 사양: async=false 스크립트는 삽입 순서대로 실행)
|
||||
*
|
||||
* @param extensions 모듈 에셋 배열
|
||||
*/
|
||||
@@ -79,20 +80,18 @@ export class ModuleAssetLoader {
|
||||
|
||||
logger.log('Loading module assets:', sortedExtensions.map(e => e.identifier));
|
||||
|
||||
// CSS를 먼저 병렬로 로드 (렌더링 블로킹 방지)
|
||||
// CSS 병렬 로드 (렌더링 블로킹 방지)
|
||||
const cssPromises = sortedExtensions
|
||||
.filter(ext => ext.css)
|
||||
.map(ext => this.loadCSS(ext.identifier, ext.css!));
|
||||
|
||||
await Promise.all(cssPromises);
|
||||
logger.log('All CSS assets loaded');
|
||||
// JS 병렬 fetch (script.async=false로 실행 순서는 append 순서대로 유지)
|
||||
// 정렬된 순서로 순차 append하여 우선순위 기반 실행 순서를 보장
|
||||
const jsPromises = sortedExtensions
|
||||
.filter(ext => ext.js)
|
||||
.map(ext => this.loadJS(ext.identifier, ext.js!));
|
||||
|
||||
// JS를 순차적으로 로드 (의존성 순서 보장)
|
||||
for (const ext of sortedExtensions) {
|
||||
if (ext.js) {
|
||||
await this.loadJS(ext.identifier, ext.js);
|
||||
}
|
||||
}
|
||||
await Promise.all([...cssPromises, ...jsPromises]);
|
||||
|
||||
logger.log('All module assets loaded successfully');
|
||||
}
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
/**
|
||||
* ModuleAssetLoader 테스트
|
||||
*
|
||||
* 확장 에셋의 병렬 fetch + 실행 순서 보장(priority 정렬) 동작을 검증합니다.
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
|
||||
import { ModuleAssetLoader, type ModuleAsset } from '../ModuleAssetLoader';
|
||||
|
||||
describe('ModuleAssetLoader', () => {
|
||||
let loader: ModuleAssetLoader;
|
||||
let originalCreateElement: typeof document.createElement;
|
||||
|
||||
beforeEach(() => {
|
||||
loader = new ModuleAssetLoader();
|
||||
originalCreateElement = document.createElement.bind(document);
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
vi.restoreAllMocks();
|
||||
document.head.querySelectorAll('[id^="module-js-"],[id^="module-css-"]')
|
||||
.forEach(el => el.remove());
|
||||
});
|
||||
|
||||
describe('loadActiveExtensionAssets', () => {
|
||||
it('JS 에셋을 priority 오름차순으로 DOM에 append한다 (실행 순서 보장)', async () => {
|
||||
const appendOrder: string[] = [];
|
||||
|
||||
const createElementSpy = vi.spyOn(document, 'createElement').mockImplementation((tag: string) => {
|
||||
const el = originalCreateElement(tag);
|
||||
if (tag === 'script') {
|
||||
Object.defineProperty(el, 'src', {
|
||||
set(v) {
|
||||
(el as any)._src = v;
|
||||
},
|
||||
get() {
|
||||
return (el as any)._src;
|
||||
},
|
||||
});
|
||||
}
|
||||
return el;
|
||||
});
|
||||
|
||||
const appendSpy = vi.spyOn(document.head, 'appendChild').mockImplementation(((node: any) => {
|
||||
if (node.tagName === 'SCRIPT') {
|
||||
appendOrder.push(node.id);
|
||||
// onload 즉시 호출 (fetch 완료 시뮬레이션)
|
||||
queueMicrotask(() => node.onload?.());
|
||||
} else if (node.tagName === 'LINK') {
|
||||
queueMicrotask(() => node.onload?.());
|
||||
}
|
||||
return node;
|
||||
}) as any);
|
||||
|
||||
const extensions: ModuleAsset[] = [
|
||||
{ identifier: 'ext-c', js: '/c.js', priority: 30 },
|
||||
{ identifier: 'ext-a', js: '/a.js', priority: 10 },
|
||||
{ identifier: 'ext-b', js: '/b.js', priority: 20 },
|
||||
];
|
||||
|
||||
await loader.loadActiveExtensionAssets(extensions);
|
||||
|
||||
expect(appendOrder).toEqual([
|
||||
'module-js-ext-a',
|
||||
'module-js-ext-b',
|
||||
'module-js-ext-c',
|
||||
]);
|
||||
|
||||
createElementSpy.mockRestore();
|
||||
appendSpy.mockRestore();
|
||||
});
|
||||
|
||||
it('모든 스크립트에 async=false가 설정되어야 한다 (실행 순서 보장 계약)', async () => {
|
||||
const createdScripts: HTMLScriptElement[] = [];
|
||||
|
||||
const appendSpy = vi.spyOn(document.head, 'appendChild').mockImplementation(((node: any) => {
|
||||
if (node.tagName === 'SCRIPT') {
|
||||
createdScripts.push(node);
|
||||
queueMicrotask(() => node.onload?.());
|
||||
}
|
||||
return node;
|
||||
}) as any);
|
||||
|
||||
const extensions: ModuleAsset[] = [
|
||||
{ identifier: 'ext-1', js: '/1.js', priority: 100 },
|
||||
{ identifier: 'ext-2', js: '/2.js', priority: 100 },
|
||||
];
|
||||
|
||||
await loader.loadActiveExtensionAssets(extensions);
|
||||
|
||||
expect(createdScripts).toHaveLength(2);
|
||||
createdScripts.forEach(s => expect(s.async).toBe(false));
|
||||
|
||||
appendSpy.mockRestore();
|
||||
});
|
||||
|
||||
it('JS 에셋 fetch를 병렬로 착수한다 (Phase 1 병렬화 회귀 방지)', async () => {
|
||||
// 첫 번째 append 시점에 아직 두 번째 append도 큐잉되어야 함
|
||||
// (순차 await 방식이면 첫 onload 이후에만 두 번째 append가 발생)
|
||||
const appendTimestamps: number[] = [];
|
||||
let firstAppendResolved = false;
|
||||
const resolvers: Array<() => void> = [];
|
||||
|
||||
const appendSpy = vi.spyOn(document.head, 'appendChild').mockImplementation(((node: any) => {
|
||||
if (node.tagName === 'SCRIPT') {
|
||||
appendTimestamps.push(performance.now());
|
||||
// onload는 수동 트리거 (모두 append 된 뒤 일괄 resolve)
|
||||
resolvers.push(() => node.onload?.());
|
||||
}
|
||||
return node;
|
||||
}) as any);
|
||||
|
||||
const extensions: ModuleAsset[] = [
|
||||
{ identifier: 'p-1', js: '/1.js', priority: 100 },
|
||||
{ identifier: 'p-2', js: '/2.js', priority: 100 },
|
||||
{ identifier: 'p-3', js: '/3.js', priority: 100 },
|
||||
];
|
||||
|
||||
const loadPromise = loader.loadActiveExtensionAssets(extensions);
|
||||
|
||||
// 마이크로태스크 1회 flush — 모든 script가 append 되어야 함
|
||||
await Promise.resolve();
|
||||
await Promise.resolve();
|
||||
|
||||
expect(appendTimestamps).toHaveLength(3);
|
||||
expect(resolvers).toHaveLength(3);
|
||||
|
||||
// 수동으로 onload 호출해 loadPromise 완료
|
||||
resolvers.forEach(r => r());
|
||||
await loadPromise;
|
||||
|
||||
expect(firstAppendResolved).toBe(false); // placeholder, 실제 검증은 length 체크로 완료
|
||||
appendSpy.mockRestore();
|
||||
});
|
||||
|
||||
it('CSS와 JS를 모두 병렬로 로드한다', async () => {
|
||||
const linkAppends: string[] = [];
|
||||
const scriptAppends: string[] = [];
|
||||
|
||||
const appendSpy = vi.spyOn(document.head, 'appendChild').mockImplementation(((node: any) => {
|
||||
if (node.tagName === 'LINK') {
|
||||
linkAppends.push(node.id);
|
||||
queueMicrotask(() => node.onload?.());
|
||||
} else if (node.tagName === 'SCRIPT') {
|
||||
scriptAppends.push(node.id);
|
||||
queueMicrotask(() => node.onload?.());
|
||||
}
|
||||
return node;
|
||||
}) as any);
|
||||
|
||||
const extensions: ModuleAsset[] = [
|
||||
{ identifier: 'ext-1', js: '/1.js', css: '/1.css', priority: 100 },
|
||||
{ identifier: 'ext-2', js: '/2.js', css: '/2.css', priority: 100 },
|
||||
];
|
||||
|
||||
await loader.loadActiveExtensionAssets(extensions);
|
||||
|
||||
expect(linkAppends).toEqual(['module-css-ext-1', 'module-css-ext-2']);
|
||||
expect(scriptAppends).toEqual(['module-js-ext-1', 'module-js-ext-2']);
|
||||
|
||||
appendSpy.mockRestore();
|
||||
});
|
||||
|
||||
it('빈 배열은 no-op', async () => {
|
||||
await expect(loader.loadActiveExtensionAssets([])).resolves.toBeUndefined();
|
||||
});
|
||||
});
|
||||
});
|
||||
Reference in new issue
Block a user