聊到 Web Components 的成熟度,很多开发者还停留在 API 调用的层面。本文想从生产环境出发,谈谈实际遇到的问题和应对思路。
基本原理
实际项目里最常见的用法是这样:
javascript
type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T
interface AppConfig {
api: { baseUrl: string; timeout: number; retries: number }
ui: { theme: 'light' | 'dark'; language: string; pageSize: number }
}
type PartialConfig = DeepPartial<AppConfig>
function mergeConfig(defaults: AppConfig, overrides: PartialConfig): AppConfig {
const result = { ...defaults }
for (const key of Object.keys(overrides) as (keyof AppConfig)[]) {
if (overrides[key] && typeof overrides[key] === 'object') {
result[key] = { ...defaults[key], ...overrides[key] } as any
}
}
return result
}
这样一来,代码的可测试性和可扩展性都会更好。
高级特性
下面给一个更完整的例子:
javascript
type UnwrapPromise<T> = T extends Promise<infer U> ? U : T
async function fetchUser(id: string) {
const res = await fetch(`/api/users/${id}`)
return res.json() as Promise<{ id: string; name: string; email: string }>
}
type User = UnwrapPromise<ReturnType<typeof fetchUser>>
// 类型安全的事件系统
interface EventMap {
login: { userId: string; timestamp: number }
logout: { userId: string }
}
class TypedEmitter<T extends Record<string, any>> {
private handlers = new Map<keyof T, Set<Function>>()
on<K extends keyof T>(event: K, handler: (payload: T[K]) => void) {
if (!this.handlers.has(event)) this.handlers.set(event, new Set())
this.handlers.get(event)!.add(handler)
}
emit<K extends keyof T>(event: K, payload: T[K]) {
this.handlers.get(event)?.forEach(h => h(payload))
}
}
上线前务必处理好边界情况,这在生产环境里尤为关键。
项目实践
重点在于吃透背后的核心逻辑:
javascript
type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T
interface AppConfig {
api: { baseUrl: string; timeout: number; retries: number }
ui: { theme: 'light' | 'dark'; language: string; pageSize: number }
}
type PartialConfig = DeepPartial<AppConfig>
function mergeConfig(defaults: AppConfig, overrides: PartialConfig): AppConfig {
const result = { ...defaults }
for (const key of Object.keys(overrides) as (keyof AppConfig)[]) {
if (overrides[key] && typeof overrides[key] === 'object') {
result[key] = { ...defaults[key], ...overrides[key] } as any
}
}
return result
}
性能优化得结合具体场景,没必要处处都做。
最佳实践
想继续改进的话,可以试试这种方式:
javascript
type UnwrapPromise<T> = T extends Promise<infer U> ? U : T
async function fetchUser(id: string) {
const res = await fetch(`/api/users/${id}`)
return res.json() as Promise<{ id: string; name: string; email: string }>
}
type User = UnwrapPromise<ReturnType<typeof fetchUser>>
// 类型安全的事件系统
interface EventMap {
login: { userId: string; timestamp: number }
logout: { userId: string }
}
class TypedEmitter<T extends Record<string, any>> {
private handlers = new Map<keyof T, Set<Function>>()
on<K extends keyof T>(event: K, handler: (payload: T[K]) => void) {
if (!this.handlers.has(event)) this.handlers.set(event, new Set())
this.handlers.get(event)!.add(handler)
}
emit<K extends keyof T>(event: K, payload: T[K]) {
this.handlers.get(event)?.forEach(h => h(payload))
}
}
小结
- 不要为了用新技术而用新技术
- 代码示例仅供参考,需根据业务场景调整
- Web Components 2026 成熟度不是银弹,需要根据项目规模和技术栈选择
- 理解底层原理比记住 API 更重要
- 生产环境使用前务必做好兼容性验证
