vue3-yuanma/packages/runtime-core/src/renderer.ts

2270 lines
60 KiB
TypeScript
Raw Normal View History

import {
Text,
Fragment,
Comment,
cloneIfMounted,
2019-05-28 05:27:31 +00:00
normalizeVNode,
VNode,
VNodeArrayChildren,
createVNode,
isSameVNodeType,
Static,
VNodeNormalizedRef,
VNodeHook
2019-05-28 09:19:47 +00:00
} from './vnode'
import {
2019-09-06 16:58:31 +00:00
ComponentInternalInstance,
createComponentInstance,
2020-01-24 03:23:10 +00:00
Data,
setupComponent
2019-05-28 09:19:47 +00:00
} from './component'
2019-09-06 15:25:11 +00:00
import {
filterSingleRoot,
2019-09-06 15:25:11 +00:00
renderComponentRoot,
shouldUpdateComponent,
updateHOCHostEl
2019-09-06 15:25:11 +00:00
} from './componentRenderUtils'
2019-06-03 05:44:45 +00:00
import {
isString,
EMPTY_OBJ,
EMPTY_ARR,
isReservedProp,
2019-09-11 00:53:28 +00:00
isFunction,
PatchFlags,
ShapeFlags,
NOOP,
hasOwn,
invokeArrayFns,
isArray
2019-06-03 05:44:45 +00:00
} from '@vue/shared'
import {
queueJob,
queuePostFlushCb,
flushPostFlushCbs,
invalidateJob,
flushPreFlushCbs,
SchedulerJob,
SchedulerCb
} from './scheduler'
import { effect, stop, ReactiveEffectOptions, isRef } from '@vue/reactivity'
import { updateProps } from './componentProps'
import { updateSlots } from './componentSlots'
2019-08-30 14:36:30 +00:00
import { pushWarningContext, popWarningContext, warn } from './warning'
import { createAppAPI, CreateAppFunction } from './apiCreateApp'
import {
SuspenseBoundary,
queueEffectWithSuspense,
SuspenseImpl
} from './components/Suspense'
import { TeleportImpl, TeleportVNode } from './components/Teleport'
import { isKeepAlive, KeepAliveContext } from './components/KeepAlive'
import { registerHMR, unregisterHMR, isHmrUpdating } from './hmr'
import {
ErrorCodes,
callWithErrorHandling,
callWithAsyncErrorHandling
} from './errorHandling'
import { createHydrationFunctions, RootHydrateFunction } from './hydration'
import { invokeDirectiveHook } from './directives'
import { startMeasure, endMeasure } from './profiling'
import { ComponentPublicInstance } from './componentPublicInstance'
import { devtoolsComponentRemoved, devtoolsComponentUpdated } from './devtools'
import { initFeatureFlags } from './featureFlags'
2019-09-11 00:53:28 +00:00
export interface Renderer<HostElement = RendererElement> {
render: RootRenderFunction<HostElement>
createApp: CreateAppFunction<HostElement>
}
export interface HydrationRenderer extends Renderer<Element> {
hydrate: RootHydrateFunction
}
export type RootRenderFunction<HostElement = RendererElement> = (
vnode: VNode | null,
container: HostElement
) => void
export interface RendererOptions<
HostNode = RendererNode,
HostElement = RendererElement
> {
patchProp(
2019-09-06 20:58:32 +00:00
el: HostElement,
key: string,
prevValue: any,
nextValue: any,
2019-12-16 18:33:10 +00:00
isSVG?: boolean,
2019-09-06 20:58:32 +00:00
prevChildren?: VNode<HostNode, HostElement>[],
2019-09-06 16:58:31 +00:00
parentComponent?: ComponentInternalInstance | null,
parentSuspense?: SuspenseBoundary | null,
unmountChildren?: UnmountChildrenFn
): void
forcePatchProp?(el: HostElement, key: string): boolean
2019-09-06 20:58:32 +00:00
insert(el: HostNode, parent: HostElement, anchor?: HostNode | null): void
remove(el: HostNode): void
createElement(
type: string,
isSVG?: boolean,
isCustomizedBuiltIn?: string
): HostElement
createText(text: string): HostNode
createComment(text: string): HostNode
setText(node: HostNode, text: string): void
2019-09-06 20:58:32 +00:00
setElementText(node: HostElement, text: string): void
parentNode(node: HostNode): HostElement | null
nextSibling(node: HostNode): HostNode | null
querySelector?(selector: string): HostElement | null
setScopeId?(el: HostElement, id: string): void
cloneNode?(node: HostNode): HostNode
insertStaticContent?(
content: string,
parent: HostElement,
anchor: HostNode | null,
isSVG: boolean
): HostElement[]
}
// Renderer Node can technically be any object in the context of core renderer
// logic - they are never directly operated on and always passed to the node op
// functions provided via options, so the internal constraint is really just
// a generic object.
export interface RendererNode {
[key: string]: any
}
export interface RendererElement extends RendererNode {}
// An object exposing the internals of a renderer, passed to tree-shakeable
2020-02-15 16:40:09 +00:00
// features so that they can be decoupled from this file. Keys are shortened
// to optimize bundle size.
export interface RendererInternals<
HostNode = RendererNode,
HostElement = RendererElement
> {
p: PatchFn
um: UnmountFn
r: RemoveFn
m: MoveFn
mt: MountComponentFn
mc: MountChildrenFn
pc: PatchChildrenFn
pbc: PatchBlockChildrenFn
n: NextFn
2020-02-15 16:40:09 +00:00
o: RendererOptions<HostNode, HostElement>
}
2020-02-24 17:01:26 +00:00
// These functions are created inside a closure and therefore their types cannot
// be directly exported. In order to avoid maintaining function signatures in
// two places, we declare them once here and use them inside the closure.
type PatchFn = (
n1: VNode | null, // null means this is a mount
n2: VNode,
container: RendererElement,
anchor?: RendererNode | null,
parentComponent?: ComponentInternalInstance | null,
parentSuspense?: SuspenseBoundary | null,
isSVG?: boolean,
optimized?: boolean
) => void
type MountChildrenFn = (
children: VNodeArrayChildren,
container: RendererElement,
anchor: RendererNode | null,
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2020-02-15 16:40:09 +00:00
isSVG: boolean,
optimized: boolean,
start?: number
) => void
type PatchChildrenFn = (
n1: VNode | null,
n2: VNode,
container: RendererElement,
anchor: RendererNode | null,
2020-02-15 16:40:09 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2020-02-15 16:40:09 +00:00
isSVG: boolean,
optimized?: boolean
) => void
type PatchBlockChildrenFn = (
oldChildren: VNode[],
newChildren: VNode[],
fallbackContainer: RendererElement,
2020-02-15 16:40:09 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2020-02-15 16:40:09 +00:00
isSVG: boolean
) => void
type MoveFn = (
vnode: VNode,
container: RendererElement,
anchor: RendererNode | null,
type: MoveType,
parentSuspense?: SuspenseBoundary | null
) => void
type NextFn = (vnode: VNode) => RendererNode | null
type UnmountFn = (
vnode: VNode,
2020-02-15 16:40:09 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2020-02-15 16:40:09 +00:00
doRemove?: boolean
) => void
type RemoveFn = (vnode: VNode) => void
type UnmountChildrenFn = (
children: VNode[],
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
doRemove?: boolean,
start?: number
) => void
export type MountComponentFn = (
initialVNode: VNode,
container: RendererElement,
anchor: RendererNode | null,
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
isSVG: boolean,
optimized: boolean
) => void
type ProcessTextOrCommentFn = (
n1: VNode | null,
n2: VNode,
container: RendererElement,
anchor: RendererNode | null
2020-02-15 16:40:09 +00:00
) => void
export type SetupRenderEffectFn = (
instance: ComponentInternalInstance,
initialVNode: VNode,
container: RendererElement,
anchor: RendererNode | null,
parentSuspense: SuspenseBoundary | null,
isSVG: boolean,
optimized: boolean
) => void
export const enum MoveType {
ENTER,
LEAVE,
REORDER
}
const prodEffectOptions = {
scheduler: queueJob
}
function createDevEffectOptions(
instance: ComponentInternalInstance
): ReactiveEffectOptions {
return {
scheduler: queueJob,
onTrack: instance.rtc ? e => invokeArrayFns(instance.rtc!, e) : void 0,
onTrigger: instance.rtg ? e => invokeArrayFns(instance.rtg!, e) : void 0
}
}
export const queuePostRenderEffect = __FEATURE_SUSPENSE__
? queueEffectWithSuspense
: queuePostFlushCb
2020-05-21 21:37:23 +00:00
export const setRef = (
rawRef: VNodeNormalizedRef,
oldRawRef: VNodeNormalizedRef | null,
parentComponent: ComponentInternalInstance,
parentSuspense: SuspenseBoundary | null,
2020-05-21 21:37:23 +00:00
vnode: VNode | null
) => {
let value: ComponentPublicInstance | RendererNode | null
if (!vnode) {
value = null
} else {
if (vnode.shapeFlag & ShapeFlags.STATEFUL_COMPONENT) {
value = vnode.component!.proxy
} else {
value = vnode.el
}
}
2020-05-21 21:37:23 +00:00
const [owner, ref] = rawRef
if (__DEV__ && !owner) {
warn(
`Missing ref owner context. ref cannot be used on hoisted vnodes. ` +
`A vnode with ref must be created inside the render function.`
)
return
}
const oldRef = oldRawRef && oldRawRef[1]
const refs = owner.refs === EMPTY_OBJ ? (owner.refs = {}) : owner.refs
const setupState = owner.setupState
// unset old ref
if (oldRef != null && oldRef !== ref) {
if (isString(oldRef)) {
refs[oldRef] = null
if (hasOwn(setupState, oldRef)) {
2020-08-14 13:52:30 +00:00
setupState[oldRef] = null
2020-05-21 21:37:23 +00:00
}
} else if (isRef(oldRef)) {
oldRef.value = null
}
}
if (isString(ref)) {
const doSet = () => {
refs[ref] = value
if (hasOwn(setupState, ref)) {
setupState[ref] = value
}
}
// #1789: for non-null values, set them after render
// null values means this is unmount and it should not overwrite another
// ref with the same key
if (value) {
;(doSet as SchedulerCb).id = -1
queuePostRenderEffect(doSet, parentSuspense)
} else {
doSet()
2020-05-21 21:37:23 +00:00
}
} else if (isRef(ref)) {
const doSet = () => {
ref.value = value
}
if (value) {
;(doSet as SchedulerCb).id = -1
queuePostRenderEffect(doSet, parentSuspense)
} else {
doSet()
}
2020-05-21 21:37:23 +00:00
} else if (isFunction(ref)) {
callWithErrorHandling(ref, parentComponent, ErrorCodes.FUNCTION_REF, [
value,
refs
])
2020-05-21 21:37:23 +00:00
} else if (__DEV__) {
warn('Invalid template ref type:', value, `(${typeof value})`)
}
}
2019-09-06 20:58:32 +00:00
/**
* The createRenderer function accepts two generic arguments:
* HostNode and HostElement, corresponding to Node and Element types in the
* host environment. For example, for runtime-dom, HostNode would be the DOM
* `Node` interface and HostElement would be the DOM `Element` interface.
*
* Custom renderers can pass in the platform specific types like this:
*
* ``` js
* const { render, createApp } = createRenderer<Node, Element>({
* patchProp,
* ...nodeOps
* })
* ```
*/
export function createRenderer<
HostNode = RendererNode,
HostElement = RendererElement
2020-02-14 04:31:03 +00:00
>(options: RendererOptions<HostNode, HostElement>) {
return baseCreateRenderer<HostNode, HostElement>(options)
}
// Separate API for creating hydration-enabled renderer.
// Hydration logic is only used when calling this function, making it
// tree-shakable.
export function createHydrationRenderer(
options: RendererOptions<Node, Element>
) {
return baseCreateRenderer(options, createHydrationFunctions)
}
// overload 1: no hydration
function baseCreateRenderer<
HostNode = RendererNode,
HostElement = RendererElement
>(options: RendererOptions<HostNode, HostElement>): Renderer<HostElement>
// overload 2: with hydration
function baseCreateRenderer(
options: RendererOptions<Node, Element>,
createHydrationFns: typeof createHydrationFunctions
): HydrationRenderer
// implementation
function baseCreateRenderer(
options: RendererOptions,
createHydrationFns?: typeof createHydrationFunctions
): any {
// compile-time feature flags check
if (__ESM_BUNDLER__ && !__TEST__) {
initFeatureFlags()
}
2018-09-19 15:35:38 +00:00
const {
2019-05-27 07:28:56 +00:00
insert: hostInsert,
remove: hostRemove,
2019-05-25 15:51:20 +00:00
patchProp: hostPatchProp,
forcePatchProp: hostForcePatchProp,
2019-05-25 15:51:20 +00:00
createElement: hostCreateElement,
createText: hostCreateText,
createComment: hostCreateComment,
setText: hostSetText,
setElementText: hostSetElementText,
2019-05-28 05:27:31 +00:00
parentNode: hostParentNode,
2019-05-29 08:10:25 +00:00
nextSibling: hostNextSibling,
setScopeId: hostSetScopeId = NOOP,
cloneNode: hostCloneNode,
insertStaticContent: hostInsertStaticContent
} = options
2019-05-25 15:51:20 +00:00
// Note: functions inside this closure should use `const xxx = () => {}`
// style in order to prevent being inlined by minifiers.
const patch: PatchFn = (
n1,
n2,
container,
anchor = null,
parentComponent = null,
parentSuspense = null,
isSVG = false,
optimized = false
) => {
2019-05-25 15:51:20 +00:00
// patching & not same type, unmount old tree
2020-03-18 22:14:51 +00:00
if (n1 && !isSameVNodeType(n1, n2)) {
anchor = getNextHostNode(n1)
unmount(n1, parentComponent, parentSuspense, true)
n1 = null
2019-05-25 15:51:20 +00:00
}
if (n2.patchFlag === PatchFlags.BAIL) {
optimized = false
n2.dynamicChildren = null
}
const { type, ref, shapeFlag } = n2
2019-05-28 09:19:47 +00:00
switch (type) {
case Text:
processText(n1, n2, container, anchor)
break
case Comment:
processCommentNode(n1, n2, container, anchor)
2019-05-28 09:19:47 +00:00
break
case Static:
if (n1 == null) {
mountStaticNode(n2, container, anchor, isSVG)
2020-04-30 18:38:13 +00:00
} else if (__DEV__) {
patchStaticNode(n1, n2, container, isSVG)
2020-04-30 18:38:13 +00:00
}
break
2019-05-28 09:19:47 +00:00
case Fragment:
2019-06-03 01:43:28 +00:00
processFragment(
n1,
n2,
container,
anchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
2019-05-28 09:19:47 +00:00
break
default:
if (shapeFlag & ShapeFlags.ELEMENT) {
processElement(
2019-09-09 20:28:32 +00:00
n1,
n2,
container,
anchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-09-09 20:28:32 +00:00
isSVG,
optimized
)
} else if (shapeFlag & ShapeFlags.COMPONENT) {
processComponent(
2019-06-03 01:43:28 +00:00
n1,
n2,
container,
anchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
} else if (shapeFlag & ShapeFlags.TELEPORT) {
;(type as typeof TeleportImpl).process(
n1 as TeleportVNode,
n2 as TeleportVNode,
2020-02-15 16:40:09 +00:00
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized,
internals
)
} else if (__FEATURE_SUSPENSE__ && shapeFlag & ShapeFlags.SUSPENSE) {
;(type as typeof SuspenseImpl).process(
2019-06-03 01:43:28 +00:00
n1,
n2,
container,
anchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized,
internals
2019-06-03 01:43:28 +00:00
)
2019-08-30 14:36:30 +00:00
} else if (__DEV__) {
warn('Invalid VNode type:', type, `(${typeof type})`)
2019-05-28 09:19:47 +00:00
}
2018-09-19 15:35:38 +00:00
}
// set ref
if (ref != null && parentComponent) {
setRef(ref, n1 && n1.ref, parentComponent, parentSuspense, n2)
}
2018-09-19 15:35:38 +00:00
}
const processText: ProcessTextOrCommentFn = (n1, n2, container, anchor) => {
2019-05-25 15:51:20 +00:00
if (n1 == null) {
2019-05-27 07:28:56 +00:00
hostInsert(
(n2.el = hostCreateText(n2.children as string)),
container,
anchor
)
} else {
const el = (n2.el = n1.el!)
2019-05-25 15:51:20 +00:00
if (n2.children !== n1.children) {
hostSetText(el, n2.children as string)
2018-11-02 05:21:38 +00:00
}
2018-09-19 15:35:38 +00:00
}
}
const processCommentNode: ProcessTextOrCommentFn = (
2020-02-15 16:40:09 +00:00
n1,
n2,
container,
anchor
) => {
2019-05-25 15:51:20 +00:00
if (n1 == null) {
hostInsert(
(n2.el = hostCreateComment((n2.children as string) || '')),
container,
anchor
)
2018-11-02 05:21:38 +00:00
} else {
// there's no support for dynamic comments
2019-05-25 15:51:20 +00:00
n2.el = n1.el
2018-09-19 15:35:38 +00:00
}
}
const mountStaticNode = (
n2: VNode,
container: RendererElement,
anchor: RendererNode | null,
isSVG: boolean
) => {
// static nodes are only present when used with compiler-dom/runtime-dom
// which guarantees presence of hostInsertStaticContent.
;[n2.el, n2.anchor] = hostInsertStaticContent!(
n2.children as string,
container,
anchor,
isSVG
)
}
/**
* Dev / HMR only
*/
const patchStaticNode = (
n1: VNode,
n2: VNode,
container: RendererElement,
isSVG: boolean
) => {
// static nodes are only patched during dev for HMR
if (n2.children !== n1.children) {
const anchor = hostNextSibling(n1.anchor!)
// remove existing
removeStaticNode(n1)
// insert new
;[n2.el, n2.anchor] = hostInsertStaticContent!(
n2.children as string,
container,
anchor,
isSVG
)
} else {
n2.el = n1.el
n2.anchor = n1.anchor
}
}
/**
* Dev / HMR only
*/
const moveStaticNode = (
vnode: VNode,
container: RendererElement,
anchor: RendererNode | null
) => {
let cur = vnode.el
const end = vnode.anchor!
while (cur && cur !== end) {
const next = hostNextSibling(cur)
hostInsert(cur, container, anchor)
cur = next
}
hostInsert(end, container, anchor)
}
/**
* Dev / HMR only
*/
const removeStaticNode = (vnode: VNode) => {
let cur = vnode.el
while (cur && cur !== vnode.anchor) {
const next = hostNextSibling(cur)
hostRemove(cur)
cur = next
}
hostRemove(vnode.anchor!)
}
const processElement = (
n1: VNode | null,
n2: VNode,
container: RendererElement,
anchor: RendererNode | null,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean,
optimized: boolean
) => {
isSVG = isSVG || (n2.type as string) === 'svg'
2019-05-25 15:51:20 +00:00
if (n1 == null) {
2019-09-10 16:08:30 +00:00
mountElement(
n2,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized
2019-09-10 16:08:30 +00:00
)
2018-09-19 15:35:38 +00:00
} else {
patchElement(n1, n2, parentComponent, parentSuspense, isSVG, optimized)
2018-09-19 15:35:38 +00:00
}
}
const mountElement = (
vnode: VNode,
container: RendererElement,
anchor: RendererNode | null,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
isSVG: boolean,
optimized: boolean
) => {
let el: RendererElement
let vnodeHook: VNodeHook | undefined | null
const {
type,
props,
shapeFlag,
transition,
scopeId,
patchFlag,
dirs
} = vnode
if (
!__DEV__ &&
2020-03-18 22:14:51 +00:00
vnode.el &&
hostCloneNode !== undefined &&
patchFlag === PatchFlags.HOISTED
) {
// If a vnode has non-null el, it means it's being reused.
// Only static vnodes can be reused, so its mounted DOM nodes should be
// exactly the same, and we can simply do a clone here.
// only do this in production since cloned trees cannot be HMR updated.
el = vnode.el = hostCloneNode(vnode.el)
} else {
el = vnode.el = hostCreateElement(
vnode.type as string,
isSVG,
props && props.is
)
// mount children first, since some props may rely on child content
// being already rendered, e.g. `<select value>`
if (shapeFlag & ShapeFlags.TEXT_CHILDREN) {
hostSetElementText(el, vnode.children as string)
} else if (shapeFlag & ShapeFlags.ARRAY_CHILDREN) {
mountChildren(
vnode.children as VNodeArrayChildren,
el,
null,
parentComponent,
parentSuspense,
isSVG && type !== 'foreignObject',
optimized || !!vnode.dynamicChildren
)
}
if (dirs) {
invokeDirectiveHook(vnode, null, parentComponent, 'created')
}
// props
2020-03-18 22:14:51 +00:00
if (props) {
for (const key in props) {
2020-02-13 22:47:00 +00:00
if (!isReservedProp(key)) {
hostPatchProp(
el,
key,
null,
props[key],
isSVG,
vnode.children as VNode[],
parentComponent,
parentSuspense,
unmountChildren
)
2020-02-13 22:47:00 +00:00
}
}
2020-03-18 22:14:51 +00:00
if ((vnodeHook = props.onVnodeBeforeMount)) {
invokeVNodeHook(vnodeHook, parentComponent, vnode)
}
}
// scopeId
setScopeId(el, scopeId, vnode, parentComponent)
2019-12-16 18:33:10 +00:00
}
if (__DEV__ || __FEATURE_PROD_DEVTOOLS__) {
Object.defineProperty(el, '__vnode', {
value: vnode,
enumerable: false
})
Object.defineProperty(el, '__vueParentComponent', {
value: parentComponent,
enumerable: false
})
}
if (dirs) {
invokeDirectiveHook(vnode, null, parentComponent, 'beforeMount')
}
// #1583 For inside suspense + suspense not resolved case, enter hook should call when suspense resolved
// #1689 For inside suspense + suspense resolved case, just call it
const needCallTransitionHooks =
(!parentSuspense || (parentSuspense && parentSuspense!.isResolved)) &&
transition &&
!transition.persisted
if (needCallTransitionHooks) {
transition!.beforeEnter(el)
}
hostInsert(el, container, anchor)
if (
2020-03-18 22:14:51 +00:00
(vnodeHook = props && props.onVnodeMounted) ||
needCallTransitionHooks ||
2020-03-18 22:14:51 +00:00
dirs
) {
queuePostRenderEffect(() => {
vnodeHook && invokeVNodeHook(vnodeHook, parentComponent, vnode)
needCallTransitionHooks && transition!.enter(el)
dirs && invokeDirectiveHook(vnode, null, parentComponent, 'mounted')
2019-09-11 00:53:28 +00:00
}, parentSuspense)
2019-08-31 21:06:39 +00:00
}
2018-09-19 15:35:38 +00:00
}
const setScopeId = (
el: RendererElement,
scopeId: string | false | null,
vnode: VNode,
parentComponent: ComponentInternalInstance | null
) => {
if (scopeId) {
hostSetScopeId(el, scopeId)
}
if (parentComponent) {
const treeOwnerId = parentComponent.type.__scopeId
// vnode's own scopeId and the current patched component's scopeId is
// different - this is a slot content node.
if (treeOwnerId && treeOwnerId !== scopeId) {
hostSetScopeId(el, treeOwnerId + '-s')
}
let subTree = parentComponent.subTree
if (__DEV__ && subTree.type === Fragment) {
subTree =
filterSingleRoot(subTree.children as VNodeArrayChildren) || subTree
}
if (vnode === subTree) {
setScopeId(
el,
parentComponent.vnode.scopeId,
parentComponent.vnode,
parentComponent.parent
)
}
}
}
const mountChildren: MountChildrenFn = (
2020-02-15 16:40:09 +00:00
children,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized,
start = 0
) => {
2019-05-25 15:51:20 +00:00
for (let i = start; i < children.length; i++) {
const child = (children[i] = optimized
? cloneIfMounted(children[i] as VNode)
: normalizeVNode(children[i]))
2019-09-10 16:08:30 +00:00
patch(
null,
child,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized
2019-09-10 16:08:30 +00:00
)
2018-09-19 15:35:38 +00:00
}
}
const patchElement = (
n1: VNode,
n2: VNode,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean,
optimized: boolean
) => {
const el = (n2.el = n1.el!)
let { patchFlag, dynamicChildren, dirs } = n2
// #1426 take the old vnode's patch flag into account since user may clone a
// compiler-generated vnode, which de-opts to FULL_PROPS
patchFlag |= n1.patchFlag & PatchFlags.FULL_PROPS
const oldProps = n1.props || EMPTY_OBJ
2019-05-28 09:19:47 +00:00
const newProps = n2.props || EMPTY_OBJ
let vnodeHook: VNodeHook | undefined | null
2018-09-19 15:35:38 +00:00
2020-03-18 22:14:51 +00:00
if ((vnodeHook = newProps.onVnodeBeforeUpdate)) {
invokeVNodeHook(vnodeHook, parentComponent, n2, n1)
}
2020-03-18 22:14:51 +00:00
if (dirs) {
invokeDirectiveHook(n2, n1, parentComponent, 'beforeUpdate')
2019-09-01 02:17:46 +00:00
}
if (__DEV__ && isHmrUpdating) {
// HMR updated, force full diff
patchFlag = 0
optimized = false
dynamicChildren = null
2019-12-13 22:57:21 +00:00
}
if (patchFlag > 0) {
2019-05-25 15:51:20 +00:00
// the presence of a patchFlag means this element's render code was
// generated by the compiler and can take the fast path.
// in this path old node and new node are guaranteed to have the same shape
// (i.e. at the exact same position in the source template)
2019-08-22 15:12:37 +00:00
if (patchFlag & PatchFlags.FULL_PROPS) {
// element props contain dynamic keys, full diff needed
2019-09-10 16:08:30 +00:00
patchProps(
el,
n2,
oldProps,
newProps,
parentComponent,
parentSuspense,
isSVG
)
} else {
// class
// this flag is matched when the element has dynamic class bindings.
2019-08-22 15:12:37 +00:00
if (patchFlag & PatchFlags.CLASS) {
if (oldProps.class !== newProps.class) {
hostPatchProp(el, 'class', null, newProps.class, isSVG)
}
2018-09-19 15:35:38 +00:00
}
// style
// this flag is matched when the element has dynamic style bindings
2019-08-22 15:12:37 +00:00
if (patchFlag & PatchFlags.STYLE) {
hostPatchProp(el, 'style', oldProps.style, newProps.style, isSVG)
}
2019-05-25 15:51:20 +00:00
// props
// This flag is matched when the element has dynamic prop/attr bindings
// other than class and style. The keys of dynamic prop/attrs are saved for
// faster iteration.
// Note dynamic keys like :[foo]="bar" will cause this optimization to
// bail out and go through a full diff because we need to unset the old key
2019-08-22 15:12:37 +00:00
if (patchFlag & PatchFlags.PROPS) {
// if the flag is present then dynamicProps must be non-null
2019-10-05 14:09:34 +00:00
const propsToUpdate = n2.dynamicProps!
for (let i = 0; i < propsToUpdate.length; i++) {
const key = propsToUpdate[i]
const prev = oldProps[key]
const next = newProps[key]
if (
next !== prev ||
(hostForcePatchProp && hostForcePatchProp(el, key))
) {
hostPatchProp(
el,
key,
prev,
next,
2019-06-03 01:43:28 +00:00
isSVG,
n1.children as VNode[],
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
unmountChildren
)
}
2018-09-19 15:35:38 +00:00
}
}
}
2019-05-25 15:51:20 +00:00
// text
// This flag is matched when the element has only dynamic text children.
2019-08-22 15:12:37 +00:00
if (patchFlag & PatchFlags.TEXT) {
2019-05-25 15:51:20 +00:00
if (n1.children !== n2.children) {
hostSetElementText(el, n2.children as string)
2018-09-19 15:35:38 +00:00
}
}
} else if (!optimized && dynamicChildren == null) {
2019-05-25 15:51:20 +00:00
// unoptimized, full diff
2019-09-10 16:08:30 +00:00
patchProps(
el,
n2,
oldProps,
newProps,
parentComponent,
parentSuspense,
isSVG
)
2018-09-19 15:35:38 +00:00
}
const areChildrenSVG = isSVG && n2.type !== 'foreignObject'
2020-03-18 22:14:51 +00:00
if (dynamicChildren) {
patchBlockChildren(
n1.dynamicChildren!,
dynamicChildren,
el,
parentComponent,
parentSuspense,
areChildrenSVG
)
if (__DEV__ && parentComponent && parentComponent.type.__hmrId) {
traverseStaticChildren(n1, n2)
}
2019-05-25 15:51:20 +00:00
} else if (!optimized) {
// full diff
patchChildren(
n1,
n2,
el,
null,
parentComponent,
parentSuspense,
areChildrenSVG
)
}
2019-09-01 02:17:46 +00:00
2020-03-18 22:14:51 +00:00
if ((vnodeHook = newProps.onVnodeUpdated) || dirs) {
queuePostRenderEffect(() => {
vnodeHook && invokeVNodeHook(vnodeHook, parentComponent, n2, n1)
dirs && invokeDirectiveHook(n2, n1, parentComponent, 'updated')
2019-09-11 00:53:28 +00:00
}, parentSuspense)
2019-09-01 02:17:46 +00:00
}
}
// The fast path for blocks.
const patchBlockChildren: PatchBlockChildrenFn = (
2020-02-15 16:40:09 +00:00
oldChildren,
newChildren,
fallbackContainer,
parentComponent,
parentSuspense,
isSVG
) => {
for (let i = 0; i < newChildren.length; i++) {
const oldVNode = oldChildren[i]
const newVNode = newChildren[i]
// Determine the container (parent element) for the patch.
const container =
// - In the case of a Fragment, we need to provide the actual parent
// of the Fragment itself so it can move its children.
oldVNode.type === Fragment ||
// - In the case of different nodes, there is going to be a replacement
// which also requires the correct parent container
!isSameVNodeType(oldVNode, newVNode) ||
// - In the case of a component, it could contain anything.
oldVNode.shapeFlag & ShapeFlags.COMPONENT ||
oldVNode.shapeFlag & ShapeFlags.TELEPORT
? hostParentNode(oldVNode.el!)!
: // In other cases, the parent container is not actually used so we
// just pass the block element here to avoid a DOM parentNode call.
fallbackContainer
patch(
oldVNode,
newVNode,
container,
null,
parentComponent,
parentSuspense,
isSVG,
true
)
}
}
const patchProps = (
el: RendererElement,
vnode: VNode,
2019-10-22 15:26:48 +00:00
oldProps: Data,
newProps: Data,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean
) => {
2019-05-25 15:51:20 +00:00
if (oldProps !== newProps) {
for (const key in newProps) {
2019-06-03 05:44:45 +00:00
if (isReservedProp(key)) continue
2019-05-25 15:51:20 +00:00
const next = newProps[key]
const prev = oldProps[key]
if (
next !== prev ||
(hostForcePatchProp && hostForcePatchProp(el, key))
) {
hostPatchProp(
el,
key,
prev,
next,
2019-06-03 01:43:28 +00:00
isSVG,
vnode.children as VNode[],
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
unmountChildren
)
2018-09-26 21:10:34 +00:00
}
2018-09-19 15:35:38 +00:00
}
2019-05-28 09:19:47 +00:00
if (oldProps !== EMPTY_OBJ) {
2019-05-25 15:51:20 +00:00
for (const key in oldProps) {
if (!isReservedProp(key) && !(key in newProps)) {
hostPatchProp(
el,
key,
oldProps[key],
null,
2019-06-03 01:43:28 +00:00
isSVG,
vnode.children as VNode[],
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
unmountChildren
)
2019-05-25 15:51:20 +00:00
}
}
}
2018-09-19 15:35:38 +00:00
}
}
const processFragment = (
n1: VNode | null,
n2: VNode,
container: RendererElement,
anchor: RendererNode | null,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean,
optimized: boolean
) => {
const fragmentStartAnchor = (n2.el = n1 ? n1.el : hostCreateText(''))!
const fragmentEndAnchor = (n2.anchor = n1 ? n1.anchor : hostCreateText(''))!
2019-12-13 22:57:21 +00:00
2019-12-16 22:57:34 +00:00
let { patchFlag, dynamicChildren } = n2
if (patchFlag > 0) {
optimized = true
2019-11-04 16:24:37 +00:00
}
2019-12-13 22:57:21 +00:00
if (__DEV__ && isHmrUpdating) {
2019-12-13 22:57:21 +00:00
// HMR updated, force full diff
patchFlag = 0
optimized = false
2019-12-16 22:57:34 +00:00
dynamicChildren = null
2019-12-13 22:57:21 +00:00
}
2019-05-25 15:51:20 +00:00
if (n1 == null) {
2019-05-27 07:28:56 +00:00
hostInsert(fragmentStartAnchor, container, anchor)
hostInsert(fragmentEndAnchor, container, anchor)
// a fragment can only have array children
2019-09-07 21:10:57 +00:00
// since they are either generated by the compiler, or implicitly created
// from arrays.
2019-06-03 01:43:28 +00:00
mountChildren(
n2.children as VNodeArrayChildren,
2019-06-03 01:43:28 +00:00
container,
fragmentEndAnchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
isSVG,
optimized
2019-06-03 01:43:28 +00:00
)
2018-09-19 15:35:38 +00:00
} else {
if (
patchFlag > 0 &&
patchFlag & PatchFlags.STABLE_FRAGMENT &&
dynamicChildren
) {
// a stable fragment (template root or <template v-for>) doesn't need to
// patch children order, but it may contain dynamicChildren.
patchBlockChildren(
n1.dynamicChildren!,
2019-12-16 22:57:34 +00:00
dynamicChildren,
container,
parentComponent,
parentSuspense,
isSVG
)
if (__DEV__ && parentComponent && parentComponent.type.__hmrId) {
traverseStaticChildren(n1, n2)
}
} else {
// keyed / unkeyed, or manual fragments.
// for keyed & unkeyed, since they are compiler generated from v-for,
2019-12-13 10:49:01 +00:00
// each child is guaranteed to be a block so the fragment will never
// have dynamicChildren.
patchChildren(
n1,
n2,
container,
fragmentEndAnchor,
parentComponent,
parentSuspense,
isSVG,
optimized
)
}
2018-09-19 15:35:38 +00:00
}
}
const processComponent = (
n1: VNode | null,
n2: VNode,
container: RendererElement,
anchor: RendererNode | null,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean,
optimized: boolean
) => {
2019-05-28 05:27:31 +00:00
if (n1 == null) {
2019-11-03 01:26:25 +00:00
if (n2.shapeFlag & ShapeFlags.COMPONENT_KEPT_ALIVE) {
;(parentComponent!.ctx as KeepAliveContext).activate(
2019-10-30 02:28:38 +00:00
n2,
container,
anchor,
isSVG,
optimized
2019-10-30 02:28:38 +00:00
)
} else {
mountComponent(
n2,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized
2019-10-30 02:28:38 +00:00
)
}
2019-05-28 05:27:31 +00:00
} else {
2020-06-12 20:31:31 +00:00
updateComponent(n1, n2, optimized)
2019-05-28 05:27:31 +00:00
}
}
const mountComponent: MountComponentFn = (
initialVNode,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized
) => {
const instance: ComponentInternalInstance = (initialVNode.component = createComponentInstance(
2019-08-28 16:13:36 +00:00
initialVNode,
parentComponent,
parentSuspense
2019-05-28 11:36:15 +00:00
))
2019-08-28 16:13:36 +00:00
if (__DEV__ && instance.type.__hmrId) {
registerHMR(instance)
}
2019-08-30 14:36:30 +00:00
if (__DEV__) {
pushWarningContext(initialVNode)
startMeasure(instance, `mount`)
2019-08-30 14:36:30 +00:00
}
2019-10-30 02:28:38 +00:00
// inject renderer internals for keepAlive
if (isKeepAlive(initialVNode)) {
;(instance.ctx as KeepAliveContext).renderer = internals
2019-10-30 02:28:38 +00:00
}
2019-08-28 16:13:36 +00:00
// resolve props and slots for setup context
if (__DEV__) {
startMeasure(instance, `init`)
}
setupComponent(instance)
if (__DEV__) {
endMeasure(instance, `init`)
}
2019-08-28 16:13:36 +00:00
2019-09-09 20:00:50 +00:00
// setup() is async. This component relies on async logic to be resolved
// before proceeding
2019-09-09 20:28:32 +00:00
if (__FEATURE_SUSPENSE__ && instance.asyncDep) {
2019-09-10 16:08:30 +00:00
if (!parentSuspense) {
if (__DEV__) warn('async setup() is used without a suspense boundary!')
return
2019-09-09 20:00:50 +00:00
}
parentSuspense.registerDep(instance, setupRenderEffect)
2020-02-14 04:31:03 +00:00
// Give it a placeholder if this is not hydration
if (!initialVNode.el) {
const placeholder = (instance.subTree = createVNode(Comment))
processCommentNode(null, placeholder, container!, anchor)
}
2019-09-09 20:00:50 +00:00
return
}
2019-09-10 16:08:30 +00:00
setupRenderEffect(
instance,
initialVNode,
container,
anchor,
2020-02-14 04:31:03 +00:00
parentSuspense,
isSVG,
optimized
2019-09-10 16:08:30 +00:00
)
2019-09-09 20:00:50 +00:00
if (__DEV__) {
popWarningContext()
endMeasure(instance, `mount`)
2019-09-09 20:00:50 +00:00
}
}
2020-06-12 20:31:31 +00:00
const updateComponent = (n1: VNode, n2: VNode, optimized: boolean) => {
const instance = (n2.component = n1.component)!
2020-06-12 20:31:31 +00:00
if (shouldUpdateComponent(n1, n2, optimized)) {
if (
__FEATURE_SUSPENSE__ &&
instance.asyncDep &&
!instance.asyncResolved
) {
// async & still pending - just update props and slots
// since the component's reactive effect for render isn't set-up yet
if (__DEV__) {
pushWarningContext(n2)
}
updateComponentPreRender(instance, n2, optimized)
if (__DEV__) {
popWarningContext()
}
return
} else {
// normal update
instance.next = n2
// in case the child component is also queued, remove it to avoid
// double updating the same child component in the same flush.
invalidateJob(instance.update)
// instance.update is the reactive effect runner.
instance.update()
}
} else {
// no update needed. just copy over properties
n2.component = n1.component
n2.el = n1.el
instance.vnode = n2
}
}
const setupRenderEffect: SetupRenderEffectFn = (
instance,
initialVNode,
container,
anchor,
parentSuspense,
isSVG,
optimized
) => {
2019-08-28 16:13:36 +00:00
// create reactive effect for rendering
2019-10-22 15:52:29 +00:00
instance.update = effect(function componentEffect() {
2019-11-23 04:32:53 +00:00
if (!instance.isMounted) {
let vnodeHook: VNodeHook | null | undefined
const { el, props } = initialVNode
const { bm, m, parent } = instance
2019-10-22 15:52:29 +00:00
// beforeMount hook
2020-03-18 22:14:51 +00:00
if (bm) {
invokeArrayFns(bm)
2019-10-22 15:52:29 +00:00
}
// onVnodeBeforeMount
2020-03-18 22:14:51 +00:00
if ((vnodeHook = props && props.onVnodeBeforeMount)) {
invokeVNodeHook(vnodeHook, parent, initialVNode)
}
// render
if (__DEV__) {
startMeasure(instance, `render`)
}
const subTree = (instance.subTree = renderComponentRoot(instance))
if (__DEV__) {
endMeasure(instance, `render`)
}
if (el && hydrateNode) {
if (__DEV__) {
startMeasure(instance, `hydrate`)
}
2020-02-14 04:31:03 +00:00
// vnode has adopted host node - perform hydration instead of mount.
hydrateNode(
initialVNode.el as Node,
subTree,
instance,
parentSuspense
)
if (__DEV__) {
endMeasure(instance, `hydrate`)
}
2020-02-14 04:31:03 +00:00
} else {
if (__DEV__) {
startMeasure(instance, `patch`)
}
2020-02-14 04:31:03 +00:00
patch(
null,
subTree,
container,
2020-02-14 04:31:03 +00:00
anchor,
instance,
parentSuspense,
isSVG
)
if (__DEV__) {
endMeasure(instance, `patch`)
}
2020-02-14 04:31:03 +00:00
initialVNode.el = subTree.el
}
2019-10-22 15:52:29 +00:00
// mounted hook
2020-03-18 22:14:51 +00:00
if (m) {
queuePostRenderEffect(m, parentSuspense)
}
// onVnodeMounted
2020-03-18 22:14:51 +00:00
if ((vnodeHook = props && props.onVnodeMounted)) {
queuePostRenderEffect(() => {
invokeVNodeHook(vnodeHook!, parent, initialVNode)
}, parentSuspense)
2019-10-22 15:52:29 +00:00
}
2019-10-31 01:41:28 +00:00
// activated hook for keep-alive roots.
// #1742 activated hook must be accessed after first render
// since the hook may be injected by a child keep-alive
const { a } = instance
2019-10-31 03:32:29 +00:00
if (
2020-03-18 22:14:51 +00:00
a &&
initialVNode.shapeFlag & ShapeFlags.COMPONENT_SHOULD_KEEP_ALIVE
2019-10-31 03:32:29 +00:00
) {
queuePostRenderEffect(a, parentSuspense)
2019-10-31 01:41:28 +00:00
}
2019-11-23 04:32:53 +00:00
instance.isMounted = true
2019-10-22 15:52:29 +00:00
} else {
// updateComponent
// This is triggered by mutation of component's own state (next: null)
// OR parent calling processComponent (next: VNode)
let { next, bu, u, parent, vnode } = instance
let originNext = next
let vnodeHook: VNodeHook | null | undefined
2019-10-22 15:52:29 +00:00
if (__DEV__) {
pushWarningContext(next || instance.vnode)
}
2019-08-30 14:36:30 +00:00
2020-03-18 22:14:51 +00:00
if (next) {
updateComponentPreRender(instance, next, optimized)
} else {
next = vnode
2019-10-22 15:52:29 +00:00
}
next.el = vnode.el
2019-10-22 15:52:29 +00:00
// beforeUpdate hook
2020-03-18 22:14:51 +00:00
if (bu) {
invokeArrayFns(bu)
}
// onVnodeBeforeUpdate
2020-03-18 22:14:51 +00:00
if ((vnodeHook = next.props && next.props.onVnodeBeforeUpdate)) {
invokeVNodeHook(vnodeHook, parent, next, vnode)
2019-10-22 15:52:29 +00:00
}
// render
if (__DEV__) {
startMeasure(instance, `render`)
}
const nextTree = renderComponentRoot(instance)
if (__DEV__) {
endMeasure(instance, `render`)
}
const prevTree = instance.subTree
instance.subTree = nextTree
2019-10-22 15:52:29 +00:00
// reset refs
// only needed if previous patch had refs
if (instance.refs !== EMPTY_OBJ) {
instance.refs = {}
}
if (__DEV__) {
startMeasure(instance, `patch`)
}
2019-10-22 15:52:29 +00:00
patch(
prevTree,
nextTree,
// parent may have changed if it's in a teleport
hostParentNode(prevTree.el!)!,
2019-10-22 15:52:29 +00:00
// anchor may have changed if it's in a fragment
getNextHostNode(prevTree),
instance,
parentSuspense,
isSVG
)
if (__DEV__) {
endMeasure(instance, `patch`)
}
next.el = nextTree.el
if (originNext === null) {
2019-10-22 15:52:29 +00:00
// self-triggered update. In case of HOC, update parent component
// vnode el. HOC is indicated by parent instance's subTree pointing
// to child component's vnode
updateHOCHostEl(instance, nextTree.el)
}
// updated hook
2020-03-18 22:14:51 +00:00
if (u) {
queuePostRenderEffect(u, parentSuspense)
}
// onVnodeUpdated
2020-03-18 22:14:51 +00:00
if ((vnodeHook = next.props && next.props.onVnodeUpdated)) {
queuePostRenderEffect(() => {
invokeVNodeHook(vnodeHook!, parent, next!, vnode)
}, parentSuspense)
2019-10-22 15:52:29 +00:00
}
if (__DEV__ || __FEATURE_PROD_DEVTOOLS__) {
devtoolsComponentUpdated(instance)
}
2019-10-22 15:52:29 +00:00
if (__DEV__) {
popWarningContext()
2019-08-30 14:36:30 +00:00
}
2019-10-22 15:52:29 +00:00
}
}, __DEV__ ? createDevEffectOptions(instance) : prodEffectOptions)
// #1801 mark it to allow recursive updates
;(instance.update as SchedulerJob).allowRecurse = true
2019-05-28 05:27:31 +00:00
}
const updateComponentPreRender = (
instance: ComponentInternalInstance,
nextVNode: VNode,
optimized: boolean
) => {
nextVNode.component = instance
const prevProps = instance.vnode.props
instance.vnode = nextVNode
instance.next = null
updateProps(instance, nextVNode.props, prevProps, optimized)
updateSlots(instance, nextVNode.children)
// props update may have triggered pre-flush watchers.
// flush them before the render update.
flushPreFlushCbs(undefined, instance.update)
}
const patchChildren: PatchChildrenFn = (
2020-02-15 16:40:09 +00:00
n1,
n2,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized = false
) => {
2019-05-25 15:51:20 +00:00
const c1 = n1 && n1.children
const prevShapeFlag = n1 ? n1.shapeFlag : 0
2019-05-25 15:51:20 +00:00
const c2 = n2.children
2018-09-19 15:35:38 +00:00
const { patchFlag, shapeFlag } = n2
// fast path
if (patchFlag > 0) {
if (patchFlag & PatchFlags.KEYED_FRAGMENT) {
2019-05-25 15:51:20 +00:00
// this could be either fully-keyed or mixed (some keyed some not)
// presence of patchFlag means children are guaranteed to be arrays
patchKeyedChildren(
c1 as VNode[],
c2 as VNodeArrayChildren,
container,
anchor,
2019-06-03 01:43:28 +00:00
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
2019-05-25 15:51:20 +00:00
return
} else if (patchFlag & PatchFlags.UNKEYED_FRAGMENT) {
2019-05-25 15:51:20 +00:00
// unkeyed
patchUnkeyedChildren(
c1 as VNode[],
c2 as VNodeArrayChildren,
container,
anchor,
2019-06-03 01:43:28 +00:00
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
return
}
}
// children has 3 possibilities: text, array or no children.
2019-08-22 15:12:37 +00:00
if (shapeFlag & ShapeFlags.TEXT_CHILDREN) {
2019-05-25 15:51:20 +00:00
// text children fast path
2019-08-22 15:12:37 +00:00
if (prevShapeFlag & ShapeFlags.ARRAY_CHILDREN) {
unmountChildren(c1 as VNode[], parentComponent, parentSuspense)
2018-09-19 15:35:38 +00:00
}
2019-08-23 19:27:17 +00:00
if (c2 !== c1) {
hostSetElementText(container, c2 as string)
}
2019-05-25 15:51:20 +00:00
} else {
if (prevShapeFlag & ShapeFlags.ARRAY_CHILDREN) {
// prev children was array
2019-08-22 15:12:37 +00:00
if (shapeFlag & ShapeFlags.ARRAY_CHILDREN) {
// two arrays, cannot assume anything, do full diff
patchKeyedChildren(
c1 as VNode[],
c2 as VNodeArrayChildren,
container,
anchor,
2019-06-03 01:43:28 +00:00
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
} else {
// no new children, just unmount old
unmountChildren(c1 as VNode[], parentComponent, parentSuspense, true)
}
} else {
// prev children was text OR null
// new children is array OR null
if (prevShapeFlag & ShapeFlags.TEXT_CHILDREN) {
hostSetElementText(container, '')
}
// mount new if array
if (shapeFlag & ShapeFlags.ARRAY_CHILDREN) {
mountChildren(
c2 as VNodeArrayChildren,
container,
anchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
isSVG,
optimized
)
}
2018-11-02 05:09:00 +00:00
}
}
2018-09-26 22:34:21 +00:00
}
const patchUnkeyedChildren = (
c1: VNode[],
c2: VNodeArrayChildren,
container: RendererElement,
anchor: RendererNode | null,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean,
optimized: boolean
) => {
2019-05-28 09:19:47 +00:00
c1 = c1 || EMPTY_ARR
c2 = c2 || EMPTY_ARR
2019-05-25 15:51:20 +00:00
const oldLength = c1.length
const newLength = c2.length
const commonLength = Math.min(oldLength, newLength)
let i
for (i = 0; i < commonLength; i++) {
const nextChild = (c2[i] = optimized
? cloneIfMounted(c2[i] as VNode)
: normalizeVNode(c2[i]))
2019-06-03 01:43:28 +00:00
patch(
c1[i],
nextChild,
container,
null,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
2018-09-26 22:34:21 +00:00
}
2019-05-25 15:51:20 +00:00
if (oldLength > newLength) {
// remove old
2019-09-10 16:08:30 +00:00
unmountChildren(c1, parentComponent, parentSuspense, true, commonLength)
2019-05-25 15:51:20 +00:00
} else {
// mount new
2019-09-10 16:08:30 +00:00
mountChildren(
c2,
container,
anchor,
parentComponent,
parentSuspense,
isSVG,
optimized,
2019-09-10 16:08:30 +00:00
commonLength
)
2018-09-26 22:34:21 +00:00
}
}
2019-05-25 15:51:20 +00:00
// can be all-keyed or mixed
const patchKeyedChildren = (
c1: VNode[],
c2: VNodeArrayChildren,
container: RendererElement,
parentAnchor: RendererNode | null,
2019-09-06 16:58:31 +00:00
parentComponent: ComponentInternalInstance | null,
parentSuspense: SuspenseBoundary | null,
2019-06-03 01:43:28 +00:00
isSVG: boolean,
optimized: boolean
) => {
2019-05-27 05:48:40 +00:00
let i = 0
2019-05-27 07:28:56 +00:00
const l2 = c2.length
let e1 = c1.length - 1 // prev ending index
let e2 = l2 - 1 // next ending index
2019-05-27 05:48:40 +00:00
// 1. sync from start
// (a b) c
// (a b) d e
while (i <= e1 && i <= e2) {
const n1 = c1[i]
const n2 = (c2[i] = optimized
? cloneIfMounted(c2[i] as VNode)
: normalizeVNode(c2[i]))
if (isSameVNodeType(n1, n2)) {
2019-06-03 01:43:28 +00:00
patch(
n1,
n2,
container,
null,
2019-06-03 01:43:28 +00:00
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
2019-05-27 05:48:40 +00:00
} else {
break
}
i++
}
// 2. sync from end
// a (b c)
// d e (b c)
while (i <= e1 && i <= e2) {
const n1 = c1[e1]
const n2 = (c2[e2] = optimized
? cloneIfMounted(c2[e2] as VNode)
: normalizeVNode(c2[e2]))
if (isSameVNodeType(n1, n2)) {
2019-06-03 01:43:28 +00:00
patch(
n1,
n2,
container,
null,
2019-06-03 01:43:28 +00:00
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
2019-05-27 05:48:40 +00:00
} else {
break
}
e1--
e2--
}
// 3. common sequence + mount
// (a b)
// (a b) c
// i = 2, e1 = 1, e2 = 2
// (a b)
// c (a b)
// i = 0, e1 = -1, e2 = 0
if (i > e1) {
if (i <= e2) {
const nextPos = e2 + 1
const anchor = nextPos < l2 ? (c2[nextPos] as VNode).el : parentAnchor
2019-05-27 05:48:40 +00:00
while (i <= e2) {
2019-06-03 01:43:28 +00:00
patch(
null,
2019-12-22 21:24:24 +00:00
(c2[i] = optimized
? cloneIfMounted(c2[i] as VNode)
2019-12-22 21:24:24 +00:00
: normalizeVNode(c2[i])),
2019-06-03 01:43:28 +00:00
container,
anchor,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG
)
2019-05-27 05:48:40 +00:00
i++
}
}
}
// 4. common sequence + unmount
// (a b) c
// (a b)
// i = 2, e1 = 2, e2 = 1
// a (b c)
// (b c)
// i = 0, e1 = 0, e2 = -1
else if (i > e2) {
while (i <= e1) {
2019-09-10 16:08:30 +00:00
unmount(c1[i], parentComponent, parentSuspense, true)
2019-05-27 05:48:40 +00:00
i++
}
}
2019-05-27 07:28:56 +00:00
// 5. unknown sequence
2019-05-27 07:59:02 +00:00
// [i ... e1 + 1]: a b [c d e] f g
// [i ... e2 + 1]: a b [e d c h] f g
// i = 2, e1 = 4, e2 = 5
2019-05-27 05:48:40 +00:00
else {
2019-05-27 07:59:02 +00:00
const s1 = i // prev starting index
const s2 = i // next starting index
2019-05-27 07:28:56 +00:00
// 5.1 build key:index map for newChildren
const keyToNewIndexMap: Map<string | number, number> = new Map()
2019-05-27 07:28:56 +00:00
for (i = s2; i <= e2; i++) {
const nextChild = (c2[i] = optimized
? cloneIfMounted(c2[i] as VNode)
: normalizeVNode(c2[i]))
2019-05-27 07:28:56 +00:00
if (nextChild.key != null) {
2019-08-30 14:36:30 +00:00
if (__DEV__ && keyToNewIndexMap.has(nextChild.key)) {
warn(
`Duplicate keys found during update:`,
JSON.stringify(nextChild.key),
`Make sure keys are unique.`
)
}
2019-05-27 07:28:56 +00:00
keyToNewIndexMap.set(nextChild.key, i)
}
}
// 5.2 loop through old children left to be patched and try to patch
// matching nodes & remove nodes that are no longer present
let j
let patched = 0
const toBePatched = e2 - s2 + 1
let moved = false
2019-05-27 07:59:02 +00:00
// used to track whether any node has moved
2019-05-27 07:28:56 +00:00
let maxNewIndexSoFar = 0
2019-05-27 07:59:02 +00:00
// works as Map<newIndex, oldIndex>
// Note that oldIndex is offset by +1
// and oldIndex = 0 is a special value indicating the new node has
// no corresponding old node.
// used for determining longest stable subsequence
const newIndexToOldIndexMap = new Array(toBePatched)
for (i = 0; i < toBePatched; i++) newIndexToOldIndexMap[i] = 0
2019-05-27 07:28:56 +00:00
for (i = s1; i <= e1; i++) {
const prevChild = c1[i]
if (patched >= toBePatched) {
2019-05-27 07:59:02 +00:00
// all new children have been patched so this can only be a removal
2019-09-10 16:08:30 +00:00
unmount(prevChild, parentComponent, parentSuspense, true)
2019-05-27 07:28:56 +00:00
continue
}
let newIndex
if (prevChild.key != null) {
newIndex = keyToNewIndexMap.get(prevChild.key)
} else {
// key-less node, try to locate a key-less node of the same type
2019-05-27 07:59:02 +00:00
for (j = s2; j <= e2; j++) {
if (
newIndexToOldIndexMap[j - s2] === 0 &&
isSameVNodeType(prevChild, c2[j] as VNode)
) {
2019-05-27 07:28:56 +00:00
newIndex = j
break
}
}
}
if (newIndex === undefined) {
2019-09-10 16:08:30 +00:00
unmount(prevChild, parentComponent, parentSuspense, true)
2019-05-27 07:28:56 +00:00
} else {
newIndexToOldIndexMap[newIndex - s2] = i + 1
if (newIndex >= maxNewIndexSoFar) {
maxNewIndexSoFar = newIndex
} else {
moved = true
}
2019-06-03 01:43:28 +00:00
patch(
prevChild,
c2[newIndex] as VNode,
2019-06-03 01:43:28 +00:00
container,
null,
parentComponent,
2019-09-10 16:08:30 +00:00
parentSuspense,
2019-06-03 01:43:28 +00:00
isSVG,
optimized
)
2019-05-27 07:28:56 +00:00
patched++
}
}
2019-05-27 07:59:02 +00:00
// 5.3 move and mount
// generate longest stable subsequence only when nodes have moved
2019-05-27 07:28:56 +00:00
const increasingNewIndexSequence = moved
? getSequence(newIndexToOldIndexMap)
2019-05-28 09:19:47 +00:00
: EMPTY_ARR
2019-05-27 07:28:56 +00:00
j = increasingNewIndexSequence.length - 1
2019-05-27 07:59:02 +00:00
// looping backwards so that we can use last patched node as anchor
2019-05-27 07:28:56 +00:00
for (i = toBePatched - 1; i >= 0; i--) {
const nextIndex = s2 + i
const nextChild = c2[nextIndex] as VNode
2019-05-27 07:28:56 +00:00
const anchor =
nextIndex + 1 < l2 ? (c2[nextIndex + 1] as VNode).el : parentAnchor
2019-05-27 07:28:56 +00:00
if (newIndexToOldIndexMap[i] === 0) {
// mount new
2019-09-10 16:08:30 +00:00
patch(
null,
nextChild,
container,
anchor,
parentComponent,
parentSuspense,
isSVG
)
2019-05-27 07:28:56 +00:00
} else if (moved) {
2019-05-27 07:59:02 +00:00
// move if:
// There is no stable subsequence (e.g. a reverse)
// OR current node is not among the stable sequence
2019-05-27 07:28:56 +00:00
if (j < 0 || i !== increasingNewIndexSequence[j]) {
move(nextChild, container, anchor, MoveType.REORDER)
2019-05-27 07:28:56 +00:00
} else {
j--
}
}
}
}
}
const move: MoveFn = (
vnode,
container,
anchor,
2020-03-28 03:12:52 +00:00
moveType,
parentSuspense = null
) => {
2020-03-28 03:12:52 +00:00
const { el, type, transition, children, shapeFlag } = vnode
if (shapeFlag & ShapeFlags.COMPONENT) {
move(vnode.component!.subTree, container, anchor, moveType)
2019-05-28 05:27:31 +00:00
return
}
2020-03-28 03:12:52 +00:00
if (__FEATURE_SUSPENSE__ && shapeFlag & ShapeFlags.SUSPENSE) {
vnode.suspense!.move(container, anchor, moveType)
return
}
2020-03-28 03:12:52 +00:00
if (shapeFlag & ShapeFlags.TELEPORT) {
;(type as typeof TeleportImpl).move(vnode, container, anchor, internals)
2020-03-28 03:12:52 +00:00
return
}
if (type === Fragment) {
hostInsert(el!, container, anchor)
for (let i = 0; i < (children as VNode[]).length; i++) {
move((children as VNode[])[i], container, anchor, moveType)
2019-05-27 07:28:56 +00:00
}
2019-10-05 14:09:34 +00:00
hostInsert(vnode.anchor!, container, anchor)
2020-03-28 03:12:52 +00:00
return
}
// static node move can only happen when force updating HMR
if (__DEV__ && type === Static) {
moveStaticNode(vnode, container, anchor)
return
}
2020-03-28 03:12:52 +00:00
// single nodes
const needTransition =
moveType !== MoveType.REORDER &&
shapeFlag & ShapeFlags.ELEMENT &&
transition
if (needTransition) {
if (moveType === MoveType.ENTER) {
transition!.beforeEnter(el!)
hostInsert(el!, container, anchor)
queuePostRenderEffect(() => transition!.enter(el!), parentSuspense)
} else {
const { leave, delayLeave, afterLeave } = transition!
const remove = () => hostInsert(el!, container, anchor)
const performLeave = () => {
leave(el!, () => {
remove()
afterLeave && afterLeave()
})
}
if (delayLeave) {
delayLeave(el!, remove, performLeave)
} else {
2020-03-28 03:12:52 +00:00
performLeave()
}
}
2020-03-28 03:12:52 +00:00
} else {
hostInsert(el!, container, anchor)
2019-05-27 05:48:40 +00:00
}
2018-09-26 22:34:21 +00:00
}
const unmount: UnmountFn = (
vnode,
parentComponent,
parentSuspense,
doRemove = false
) => {
const {
type,
props,
ref,
children,
dynamicChildren,
shapeFlag,
patchFlag,
dirs
} = vnode
// unset ref
2020-03-18 22:14:51 +00:00
if (ref != null && parentComponent) {
setRef(ref, null, parentComponent, parentSuspense, null)
}
if (shapeFlag & ShapeFlags.COMPONENT_SHOULD_KEEP_ALIVE) {
;(parentComponent!.ctx as KeepAliveContext).deactivate(vnode)
return
}
const shouldInvokeDirs = shapeFlag & ShapeFlags.ELEMENT && dirs
let vnodeHook: VNodeHook | undefined | null
if ((vnodeHook = props && props.onVnodeBeforeUnmount)) {
invokeVNodeHook(vnodeHook, parentComponent, vnode)
}
if (shapeFlag & ShapeFlags.COMPONENT) {
unmountComponent(vnode.component!, parentSuspense, doRemove)
} else {
if (__FEATURE_SUSPENSE__ && shapeFlag & ShapeFlags.SUSPENSE) {
vnode.suspense!.unmount(parentSuspense, doRemove)
return
}
if (shouldInvokeDirs) {
invokeDirectiveHook(vnode, null, parentComponent, 'beforeUnmount')
}
2019-09-01 02:17:46 +00:00
if (
dynamicChildren &&
// #1153: fast path should not be taken for non-stable (v-for) fragments
(type !== Fragment ||
(patchFlag > 0 && patchFlag & PatchFlags.STABLE_FRAGMENT))
) {
// fast path for block nodes: only need to unmount dynamic children.
unmountChildren(dynamicChildren, parentComponent, parentSuspense)
} else if (shapeFlag & ShapeFlags.ARRAY_CHILDREN) {
unmountChildren(children as VNode[], parentComponent, parentSuspense)
}
// an unmounted teleport should always remove its children
if (shapeFlag & ShapeFlags.TELEPORT) {
;(vnode.type as typeof TeleportImpl).remove(vnode, internals)
}
if (doRemove) {
remove(vnode)
}
}
if ((vnodeHook = props && props.onVnodeUnmounted) || shouldInvokeDirs) {
queuePostRenderEffect(() => {
vnodeHook && invokeVNodeHook(vnodeHook, parentComponent, vnode)
shouldInvokeDirs &&
invokeDirectiveHook(vnode, null, parentComponent, 'unmounted')
}, parentSuspense)
}
}
const remove: RemoveFn = vnode => {
const { type, el, anchor, transition } = vnode
if (type === Fragment) {
removeFragment(el!, anchor!)
return
}
if (__DEV__ && type === Static) {
removeStaticNode(vnode)
return
}
const performRemove = () => {
hostRemove(el!)
2020-03-18 22:14:51 +00:00
if (transition && !transition.persisted && transition.afterLeave) {
transition.afterLeave()
}
}
if (
vnode.shapeFlag & ShapeFlags.ELEMENT &&
2020-03-18 22:14:51 +00:00
transition &&
!transition.persisted
) {
const { leave, delayLeave } = transition
const performLeave = () => leave(el!, performRemove)
if (delayLeave) {
delayLeave(vnode.el!, performRemove, performLeave)
} else {
performLeave()
}
} else {
performRemove()
2019-09-01 02:17:46 +00:00
}
}
2019-09-01 02:17:46 +00:00
const removeFragment = (cur: RendererNode, end: RendererNode) => {
// For fragments, directly remove all contained DOM nodes.
// (fragment child nodes cannot have transition)
let next
while (cur !== end) {
next = hostNextSibling(cur)!
hostRemove(cur)
cur = next
2018-09-26 22:34:21 +00:00
}
hostRemove(end)
2018-09-26 22:34:21 +00:00
}
const unmountComponent = (
2019-09-06 16:58:31 +00:00
instance: ComponentInternalInstance,
parentSuspense: SuspenseBoundary | null,
2019-09-06 16:58:31 +00:00
doRemove?: boolean
) => {
if (__DEV__ && instance.type.__hmrId) {
unregisterHMR(instance)
}
const { bum, effects, update, subTree, um } = instance
2019-05-29 15:44:59 +00:00
// beforeUnmount hook
2020-03-18 22:14:51 +00:00
if (bum) {
invokeArrayFns(bum)
2019-05-29 15:44:59 +00:00
}
if (effects) {
for (let i = 0; i < effects.length; i++) {
stop(effects[i])
}
}
// update may be null if a component is unmounted before its async
// setup has resolved.
2020-03-18 22:14:51 +00:00
if (update) {
stop(update)
unmount(subTree, instance, parentSuspense, doRemove)
}
2019-05-29 15:44:59 +00:00
// unmounted hook
2020-03-18 22:14:51 +00:00
if (um) {
queuePostRenderEffect(um, parentSuspense)
}
queuePostRenderEffect(() => {
instance.isUnmounted = true
}, parentSuspense)
// A component with async dep inside a pending suspense is unmounted before
// its async dep resolves. This should remove the dep from the suspense, and
// cause the suspense to resolve immediately if that was the last dep.
if (
__FEATURE_SUSPENSE__ &&
2020-03-18 22:14:51 +00:00
parentSuspense &&
!parentSuspense.isResolved &&
!parentSuspense.isUnmounted &&
2020-03-18 22:14:51 +00:00
instance.asyncDep &&
!instance.asyncResolved
) {
parentSuspense.deps--
if (parentSuspense.deps === 0) {
parentSuspense.resolve()
}
}
2020-07-16 22:18:52 +00:00
if (__DEV__ || __FEATURE_PROD_DEVTOOLS__) {
devtoolsComponentRemoved(instance)
}
}
const unmountChildren: UnmountChildrenFn = (
children,
parentComponent,
parentSuspense,
doRemove = false,
start = 0
) => {
2019-05-25 15:51:20 +00:00
for (let i = start; i < children.length; i++) {
2019-09-10 16:08:30 +00:00
unmount(children[i], parentComponent, parentSuspense, doRemove)
2018-11-02 05:21:38 +00:00
}
2018-09-19 15:35:38 +00:00
}
const getNextHostNode: NextFn = vnode => {
if (vnode.shapeFlag & ShapeFlags.COMPONENT) {
return getNextHostNode(vnode.component!.subTree)
2019-09-12 05:52:14 +00:00
}
if (__FEATURE_SUSPENSE__ && vnode.shapeFlag & ShapeFlags.SUSPENSE) {
return vnode.suspense!.next()
2019-09-12 05:52:14 +00:00
}
2020-03-28 03:12:52 +00:00
return hostNextSibling((vnode.anchor || vnode.el)!)
2019-05-28 05:27:31 +00:00
}
/**
* #1156
* When a component is HMR-enabled, we need to make sure that all static nodes
* inside a block also inherit the DOM element from the previous tree so that
* HMR updates (which are full updates) can retrieve the element for patching.
*
* Dev only.
*/
const traverseStaticChildren = (n1: VNode, n2: VNode) => {
const ch1 = n1.children
const ch2 = n2.children
if (isArray(ch1) && isArray(ch2)) {
for (let i = 0; i < ch1.length; i++) {
// this is only called in the optimized path so array children are
// guaranteed to be vnodes
const c1 = ch1[i] as VNode
const c2 = (ch2[i] = cloneIfMounted(ch2[i] as VNode))
if (c2.shapeFlag & ShapeFlags.ELEMENT && !c2.dynamicChildren) {
if (c2.patchFlag <= 0 || c2.patchFlag === PatchFlags.HYDRATE_EVENTS) {
c2.el = c1.el
}
traverseStaticChildren(c1, c2)
}
}
}
}
const render: RootRenderFunction = (vnode, container) => {
2019-05-29 05:43:46 +00:00
if (vnode == null) {
2019-09-06 20:58:32 +00:00
if (container._vnode) {
2019-09-10 16:08:30 +00:00
unmount(container._vnode, null, null, true)
2019-05-29 05:43:46 +00:00
}
} else {
2019-09-06 20:58:32 +00:00
patch(container._vnode || null, vnode, container)
2019-05-29 05:43:46 +00:00
}
2019-05-28 11:36:15 +00:00
flushPostFlushCbs()
2019-09-06 20:58:32 +00:00
container._vnode = vnode
}
const internals: RendererInternals = {
2020-02-15 16:40:09 +00:00
p: patch,
um: unmount,
m: move,
r: remove,
2020-02-15 16:40:09 +00:00
mt: mountComponent,
mc: mountChildren,
pc: patchChildren,
pbc: patchBlockChildren,
n: getNextHostNode,
o: options
}
let hydrate: ReturnType<typeof createHydrationFunctions>[0] | undefined
let hydrateNode: ReturnType<typeof createHydrationFunctions>[1] | undefined
if (createHydrationFns) {
2020-02-15 16:40:09 +00:00
;[hydrate, hydrateNode] = createHydrationFns(internals as RendererInternals<
Node,
Element
>)
}
2019-09-06 20:58:32 +00:00
return {
render,
2020-02-13 22:47:00 +00:00
hydrate,
createApp: createAppAPI(render, hydrate)
}
}
2019-05-27 07:28:56 +00:00
export function invokeVNodeHook(
hook: VNodeHook,
instance: ComponentInternalInstance | null,
vnode: VNode,
prevVNode: VNode | null = null
) {
callWithAsyncErrorHandling(hook, instance, ErrorCodes.VNODE_HOOK, [
vnode,
prevVNode
])
}
2019-05-27 07:28:56 +00:00
// https://en.wikipedia.org/wiki/Longest_increasing_subsequence
function getSequence(arr: number[]): number[] {
const p = arr.slice()
const result = [0]
let i, j, u, v, c
2019-05-27 07:28:56 +00:00
const len = arr.length
for (i = 0; i < len; i++) {
const arrI = arr[i]
if (arrI !== 0) {
j = result[result.length - 1]
if (arr[j] < arrI) {
p[i] = j
result.push(i)
continue
}
u = 0
v = result.length - 1
while (u < v) {
c = ((u + v) / 2) | 0
if (arr[result[c]] < arrI) {
u = c + 1
} else {
v = c
}
}
if (arrI < arr[result[u]]) {
if (u > 0) {
p[i] = result[u - 1]
}
result[u] = i
}
}
}
u = result.length
v = result[u - 1]
while (u-- > 0) {
result[u] = v
v = p[v]
}
return result
}