Dec 18, 2025 · Dec 17, 2025
diff --git a/packages/runtime-core/__tests__/components/KeepAlive.spec.ts b/packages/runtime-core/__tests__/components/KeepAlive.spec.ts
    expect(deactivatedHome).toHaveBeenCalledTimes(0)
    expect(unmountedHome).toHaveBeenCalledTimes(1)
  })

  test('should work with async component when update `include` props', async () => {
    let resolve: (comp: Component) => void
    const AsyncComp = defineAsyncComponent(
      () =>
        new Promise(r => {
          resolve = r as any
        }),
    )

    const toggle = ref(true)
    const instanceRef = ref<any>(null)
    const keepaliveInclude = ref(['Foo'])
    const App = {
      render: () => {
        return h(KeepAlive, { include: keepaliveInclude.value }, () =>
          toggle.value ? h(AsyncComp, { ref: instanceRef }) : null,
        )
      },
    }

    render(h(App), root)
    // async component has not been resolved
    expect(serializeInner(root)).toBe('<!---->')

    resolve!({
      name: 'Foo',
      data: () => ({ count: 0 }),
      render() {
        return h('p', this.count)
      },
    })

    await timeout()
    // resolved
    expect(serializeInner(root)).toBe('<p>0</p>')

    // change state + toggle out + update `include` props
    instanceRef.value.count++
    toggle.value = false
    keepaliveInclude.value = ['Foo']
    await nextTick()
    expect(serializeInner(root)).toBe('<!---->')

    // toggle in, state should be maintained
    toggle.value = true
    await nextTick()
    expect(serializeInner(root)).toBe('<p>1</p>')
  })
 })
diff --git a/packages/runtime-core/src/components/KeepAlive.ts b/packages/runtime-core/src/components/KeepAlive.ts

 functionpruneCache(filter:(name:string)=>boolean){
 cache.forEach((vnode,key)=>{
 constname=getComponentName(vnode.typeasConcreteComponent)
 // for async components, name check should be based in its loaded
 // inner component if available
 constname=getComponentName(
 isAsyncWrapper(vnode)
            ?(vnode.typeasComponentOptions).__asyncResolved||{}
            :(vnode.typeasConcreteComponent),
 )
 if(name&&!filter(name)){
 pruneCacheEntry(key)
 }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -1173,4 +1173,53 @@ describe('KeepAlive', () => {
		expect(deactivatedHome).toHaveBeenCalledTimes(0)
		expect(unmountedHome).toHaveBeenCalledTimes(1)
		})

		test('should work with async component when update `include` props', async () => {
		let resolve: (comp: Component) => void
		const AsyncComp = defineAsyncComponent(
		() =>
		new Promise(r => {
		resolve = r as any
		}),
		)

		const toggle = ref(true)
		const instanceRef = ref<any>(null)
		const keepaliveInclude = ref(['Foo'])
		const App = {
		render: () => {
		return h(KeepAlive, { include: keepaliveInclude.value }, () =>
		toggle.value ? h(AsyncComp, { ref: instanceRef }) : null,
		)
		},
		}

		render(h(App), root)
		// async component has not been resolved
		expect(serializeInner(root)).toBe('<!---->')

		resolve!({
		name: 'Foo',
		data: () => ({ count: 0 }),
		render() {
		return h('p', this.count)
		},
		})

		await timeout()
		// resolved
		expect(serializeInner(root)).toBe('<p>0</p>')

		// change state + toggle out + update `include` props
		instanceRef.value.count++
		toggle.value = false
		keepaliveInclude.value = ['Foo']
		await nextTick()
		expect(serializeInner(root)).toBe('<!---->')

		// toggle in, state should be maintained
		toggle.value = true
		await nextTick()
		expect(serializeInner(root)).toBe('<p>1</p>')
		})
		})
Original file line number	Diff line number	Diff line change
Expand Up		@@ -202,7 +202,13 @@ const KeepAliveImpl: ComponentOptions = {

		functionpruneCache(filter:(name:string)=>boolean){
		cache.forEach((vnode,key)=>{
		constname=getComponentName(vnode.typeasConcreteComponent)
		// for async components, name check should be based in its loaded
		// inner component if available
		constname=getComponentName(
		isAsyncWrapper(vnode)
		?(vnode.typeasComponentOptions).__asyncResolved\|\|{}
		:(vnode.typeasConcreteComponent),
		)
		if(name&&!filter(name)){
		pruneCacheEntry(key)
		}
Expand Down