UNPKG

@vue/runtime-core

Version:
1,383 lines (1,363 loc) 141 kB
'use strict'; Object.defineProperty(exports, '__esModule', { value: true }); var reactivity = require('@vue/reactivity'); // Make a map and return a function for checking if a key // is in that map. // // IMPORTANT: all calls of this function must be prefixed with /*#__PURE__*/ // So that rollup can tree-shake them if necessary. function makeMap(str, expectsLowerCase) { const map = Object.create(null); const list = str.split(','); for (let i = 0; i < list.length; i++) { map[list[i]] = true; } return expectsLowerCase ? val => !!map[val.toLowerCase()] : val => !!map[val]; } // Patch flags are optimization hints generated by the compiler. // when a block with dynamicChildren is encountered during diff, the algorithm // enters "optimized mode". In this mode, we know that the vdom is produced by // a render function generated by the compiler, so the algorithm only needs to // handle updates explicitly marked by these patch flags. // runtime object for public consumption const PublicPatchFlags = { TEXT: 1 /* TEXT */, CLASS: 2 /* CLASS */, STYLE: 4 /* STYLE */, PROPS: 8 /* PROPS */, NEED_PATCH: 32 /* NEED_PATCH */, FULL_PROPS: 16 /* FULL_PROPS */, KEYED_FRAGMENT: 128 /* KEYED_FRAGMENT */, UNKEYED_FRAGMENT: 256 /* UNKEYED_FRAGMENT */, DYNAMIC_SLOTS: 512 /* DYNAMIC_SLOTS */, BAIL: -1 /* BAIL */ }; const EMPTY_OBJ = {}; const EMPTY_ARR = []; const NOOP = () => { }; /** * Always return false. */ const NO = () => false; const extend = (a, b) => { for (const key in b) { a[key] = b[key]; } return a; }; const hasOwnProperty = Object.prototype.hasOwnProperty; const hasOwn = (val, key) => hasOwnProperty.call(val, key); const isArray = Array.isArray; const isFunction = (val) => typeof val === 'function'; const isString = (val) => typeof val === 'string'; const isObject = (val) => val !== null && typeof val === 'object'; function isPromise(val) { return isObject(val) && isFunction(val.then) && isFunction(val.catch); } const objectToString = Object.prototype.toString; const toTypeString = (value) => objectToString.call(value); const isPlainObject = (val) => toTypeString(val) === '[object Object]'; const isReservedProp = /*#__PURE__*/ makeMap('key,ref,' + 'onVnodeBeforeMount,onVnodeMounted,' + 'onVnodeBeforeUpdate,onVnodeUpdated,' + 'onVnodeBeforeUnmount,onVnodeUnmounted'); function cacheStringFunction(fn) { const cache = Object.create(null); return ((str) => { const hit = cache[str]; return hit || (cache[str] = fn(str)); }); } const camelizeRE = /-(\w)/g; const camelize = cacheStringFunction((str) => { return str.replace(camelizeRE, (_, c) => (c ? c.toUpperCase() : '')); }); const hyphenateRE = /\B([A-Z])/g; const hyphenate = cacheStringFunction((str) => { return str.replace(hyphenateRE, '-$1').toLowerCase(); }); const capitalize = cacheStringFunction((str) => { return str.charAt(0).toUpperCase() + str.slice(1); }); // compare whether a value has changed, accounting for NaN. const hasChanged = (value, oldValue) => value !== oldValue && (value === value || oldValue === oldValue); function callWithErrorHandling(fn, instance, type, args) { let res; try { res = args ? fn(...args) : fn(); } catch (err) { handleError(err, instance, type); } return res; } function callWithAsyncErrorHandling(fn, instance, type, args) { if (isFunction(fn)) { const res = callWithErrorHandling(fn, instance, type, args); if (res != null && !res._isVue && isPromise(res)) { res.catch((err) => { handleError(err, instance, type); }); } return res; } for (let i = 0; i < fn.length; i++) { callWithAsyncErrorHandling(fn[i], instance, type, args); } } function handleError(err, instance, type) { const contextVNode = instance ? instance.vnode : null; if (instance) { let cur = instance.parent; // the exposed instance is the render proxy to keep it consistent with 2.x const exposedInstance = instance.proxy; // in production the hook receives only the error code const errorInfo = type; while (cur) { const errorCapturedHooks = cur.ec; if (errorCapturedHooks !== null) { for (let i = 0; i < errorCapturedHooks.length; i++) { if (errorCapturedHooks[i](err, exposedInstance, errorInfo)) { return; } } } cur = cur.parent; } // app-level handling const appErrorHandler = instance.appContext.config.errorHandler; if (appErrorHandler) { callWithErrorHandling(appErrorHandler, null, 9 /* APP_ERROR_HANDLER */, [err, exposedInstance, errorInfo]); return; } } logError(err); } function logError(err, type, contextVNode) { // default behavior is crash in prod & test, recover in dev. { throw err; } } const stack = []; function warn(msg, ...args) { // avoid props formatting or warn handler tracking deps that might be mutated // during patch, leading to infinite recursion. reactivity.pauseTracking(); const instance = stack.length ? stack[stack.length - 1].component : null; const appWarnHandler = instance && instance.appContext.config.warnHandler; const trace = getComponentTrace(); if (appWarnHandler) { callWithErrorHandling(appWarnHandler, instance, 10 /* APP_WARN_HANDLER */, [ msg + args.join(''), instance && instance.proxy, trace .map(({ vnode }) => `at <${formatComponentName(vnode)}>`) .join('\n'), trace ]); } else { const warnArgs = [`[Vue warn]: ${msg}`, ...args]; if (trace.length && // avoid spamming console during tests !false) { warnArgs.push(`\n`, ...formatTrace(trace)); } console.warn(...warnArgs); } reactivity.resumeTracking(); } function getComponentTrace() { let currentVNode = stack[stack.length - 1]; if (!currentVNode) { return []; } // we can't just use the stack because it will be incomplete during updates // that did not start from the root. Re-construct the parent chain using // instance parent pointers. const normalizedStack = []; while (currentVNode) { const last = normalizedStack[0]; if (last && last.vnode === currentVNode) { last.recurseCount++; } else { normalizedStack.push({ vnode: currentVNode, recurseCount: 0 }); } const parentInstance = currentVNode.component .parent; currentVNode = parentInstance && parentInstance.vnode; } return normalizedStack; } function formatTrace(trace) { const logs = []; trace.forEach((entry, i) => { logs.push(...(i === 0 ? [] : [`\n`]), ...formatTraceEntry(entry)); }); return logs; } function formatTraceEntry({ vnode, recurseCount }) { const postfix = recurseCount > 0 ? `... (${recurseCount} recursive calls)` : ``; const open = ` at <${formatComponentName(vnode)}`; const close = `>` + postfix; const rootLabel = vnode.component.parent == null ? `(Root)` : ``; return vnode.props ? [open, ...formatProps(vnode.props), close, rootLabel] : [open + close, rootLabel]; } const classifyRE = /(?:^|[-_])(\w)/g; const classify = (str) => str.replace(classifyRE, c => c.toUpperCase()).replace(/[-_]/g, ''); function formatComponentName(vnode, file) { const Component = vnode.type; let name = isFunction(Component) ? Component.displayName || Component.name : Component.name; if (!name && file) { const match = file.match(/([^/\\]+)\.vue$/); if (match) { name = match[1]; } } return name ? classify(name) : 'Anonymous'; } function formatProps(props) { const res = []; const keys = Object.keys(props); keys.slice(0, 3).forEach(key => { res.push(...formatProp(key, props[key])); }); if (keys.length > 3) { res.push(` ...`); } return res; } function formatProp(key, value, raw) { if (isString(value)) { value = JSON.stringify(value); return raw ? value : [`${key}=${value}`]; } else if (typeof value === 'number' || typeof value === 'boolean' || value == null) { return raw ? value : [`${key}=${value}`]; } else if (reactivity.isRef(value)) { value = formatProp(key, reactivity.toRaw(value.value), true); return raw ? value : [`${key}=Ref<`, value, `>`]; } else if (isFunction(value)) { return [`${key}=fn${value.name ? `<${value.name}>` : ``}`]; } else { value = reactivity.toRaw(value); return raw ? value : [`${key}=`, value]; } } // SFC scoped style ID management. // These are only used in esm-bundler builds, but since exports cannot be // conditional, we can only drop inner implementations in non-bundler builds. let currentScopeId = null; function pushScopeId(id) { } function popScopeId() { } function withScopeId(id) { { return undefined; } } const Fragment = Symbol( undefined); const Portal = Symbol( undefined); const Text = Symbol( undefined); const Comment = Symbol( undefined); // Since v-if and v-for are the two possible ways node structure can dynamically // change, once we consider v-if branches and each v-for fragment a block, we // can divide a template into nested blocks, and within each block the node // structure would be stable. This allows us to skip most children diffing // and only worry about the dynamic nodes (indicated by patch flags). const blockStack = []; let currentBlock = null; // Open a block. // This must be called before `createBlock`. It cannot be part of `createBlock` // because the children of the block are evaluated before `createBlock` itself // is called. The generated code typically looks like this: // // function render() { // return (openBlock(),createBlock('div', null, [...])) // } // // disableTracking is true when creating a fragment block, since a fragment // always diffs its children. function openBlock(disableTracking) { blockStack.push((currentBlock = disableTracking ? null : [])); } // Whether we should be tracking dynamic child nodes inside a block. // Only tracks when this value is > 0 // We are not using a simple boolean because this value may need to be // incremented/decremented by nested usage of v-once (see below) let shouldTrack = 1; // Block tracking sometimes needs to be disabled, for example during the // creation of a tree that needs to be cached by v-once. The compiler generates // code like this: // _cache[1] || ( // setBlockTracking(-1), // _cache[1] = createVNode(...), // setBlockTracking(1), // _cache[1] // ) function setBlockTracking(value) { shouldTrack += value; } // Create a block root vnode. Takes the same exact arguments as `createVNode`. // A block root keeps track of dynamic nodes within the block in the // `dynamicChildren` array. function createBlock(type, props, children, patchFlag, dynamicProps) { // avoid a block with patchFlag tracking itself shouldTrack--; const vnode = createVNode(type, props, children, patchFlag, dynamicProps); shouldTrack++; // save current block children on the block vnode vnode.dynamicChildren = currentBlock || EMPTY_ARR; // close block blockStack.pop(); currentBlock = blockStack[blockStack.length - 1] || null; // a block is always going to be patched, so track it as a child of its // parent block if (currentBlock !== null) { currentBlock.push(vnode); } return vnode; } function isVNode(value) { return value ? value._isVNode === true : false; } function isSameVNodeType(n1, n2) { return n1.type === n2.type && n1.key === n2.key; } function createVNode(type, props = null, children = null, patchFlag = 0, dynamicProps = null) { // class & style normalization. if (props !== null) { // for reactive or proxy objects, we need to clone it to enable mutation. if (reactivity.isReactive(props) || SetupProxySymbol in props) { props = extend({}, props); } let { class: klass, style } = props; if (klass != null && !isString(klass)) { props.class = normalizeClass(klass); } if (style != null) { // reactive state objects need to be cloned since they are likely to be // mutated if (reactivity.isReactive(style) && !isArray(style)) { style = extend({}, style); } props.style = normalizeStyle(style); } } // encode the vnode type information into a bitmap const shapeFlag = isString(type) ? 1 /* ELEMENT */ : type.__isSuspense === true ? 64 /* SUSPENSE */ : isObject(type) ? 4 /* STATEFUL_COMPONENT */ : isFunction(type) ? 2 /* FUNCTIONAL_COMPONENT */ : 0; const vnode = { _isVNode: true, type, props, key: (props !== null && props.key) || null, ref: (props !== null && props.ref) || null, scopeId: currentScopeId, children: null, component: null, suspense: null, dirs: null, transition: null, el: null, anchor: null, target: null, shapeFlag, patchFlag, dynamicProps, dynamicChildren: null, appContext: null }; normalizeChildren(vnode, children); // presence of a patch flag indicates this node needs patching on updates. // component nodes also should always be patched, because even if the // component doesn't need to update, it needs to persist the instance on to // the next vnode so that it can be properly unmounted later. if (shouldTrack > 0 && currentBlock !== null && (patchFlag > 0 || shapeFlag & 4 /* STATEFUL_COMPONENT */ || shapeFlag & 2 /* FUNCTIONAL_COMPONENT */)) { currentBlock.push(vnode); } return vnode; } function cloneVNode(vnode, extraProps) { // This is intentionally NOT using spread or extend to avoid the runtime // key enumeration cost. return { _isVNode: true, type: vnode.type, props: extraProps ? vnode.props ? mergeProps(vnode.props, extraProps) : extraProps : vnode.props, key: vnode.key, ref: vnode.ref, scopeId: vnode.scopeId, children: vnode.children, target: vnode.target, shapeFlag: vnode.shapeFlag, patchFlag: vnode.patchFlag, dynamicProps: vnode.dynamicProps, dynamicChildren: vnode.dynamicChildren, appContext: vnode.appContext, dirs: vnode.dirs, transition: vnode.transition, // These should technically only be non-null on mounted VNodes. However, // they *should* be copied for kept-alive vnodes. So we just always copy // them since them being non-null during a mount doesn't affect the logic as // they will simply be overwritten. component: vnode.component, suspense: vnode.suspense, el: vnode.el, anchor: vnode.anchor }; } function createTextVNode(text = ' ', flag = 0) { return createVNode(Text, null, text, flag); } function createCommentVNode(text = '', // when used as the v-else branch, the comment node must be created as a // block to ensure correct updates. asBlock = false) { return asBlock ? createBlock(Comment, null, text) : createVNode(Comment, null, text); } function normalizeVNode(child) { if (child == null) { // empty placeholder return createVNode(Comment); } else if (isArray(child)) { // fragment return createVNode(Fragment, null, child); } else if (typeof child === 'object') { // already vnode, this should be the most common since compiled templates // always produce all-vnode children arrays return child.el === null ? child : cloneVNode(child); } else { // primitive types return createVNode(Text, null, String(child)); } } // optimized normalization for template-compiled render fns function cloneIfMounted(child) { return child.el === null ? child : cloneVNode(child); } function normalizeChildren(vnode, children) { let type = 0; if (children == null) { children = null; } else if (isArray(children)) { type = 16 /* ARRAY_CHILDREN */; } else if (typeof children === 'object') { type = 32 /* SLOTS_CHILDREN */; } else if (isFunction(children)) { children = { default: children }; type = 32 /* SLOTS_CHILDREN */; } else { children = String(children); type = 8 /* TEXT_CHILDREN */; } vnode.children = children; vnode.shapeFlag |= type; } function normalizeStyle(value) { if (isArray(value)) { const res = {}; for (let i = 0; i < value.length; i++) { const normalized = normalizeStyle(value[i]); if (normalized) { for (const key in normalized) { res[key] = normalized[key]; } } } return res; } else if (isObject(value)) { return value; } } function normalizeClass(value) { let res = ''; if (isString(value)) { res = value; } else if (isArray(value)) { for (let i = 0; i < value.length; i++) { res += normalizeClass(value[i]) + ' '; } } else if (isObject(value)) { for (const name in value) { if (value[name]) { res += name + ' '; } } } return res.trim(); } const handlersRE = /^on|^vnode/; function mergeProps(...args) { const ret = {}; extend(ret, args[0]); for (let i = 1; i < args.length; i++) { const toMerge = args[i]; for (const key in toMerge) { if (key === 'class') { ret.class = normalizeClass([ret.class, toMerge.class]); } else if (key === 'style') { ret.style = normalizeStyle([ret.style, toMerge.style]); } else if (handlersRE.test(key)) { // on*, vnode* const existing = ret[key]; ret[key] = existing ? [].concat(existing, toMerge[key]) : toMerge[key]; } else { ret[key] = toMerge[key]; } } } return ret; } const queue = []; const postFlushCbs = []; const p = Promise.resolve(); let isFlushing = false; let isFlushPending = false; function nextTick(fn) { return fn ? p.then(fn) : p; } function queueJob(job) { if (!queue.includes(job)) { queue.push(job); queueFlush(); } } function queuePostFlushCb(cb) { if (!isArray(cb)) { postFlushCbs.push(cb); } else { postFlushCbs.push(...cb); } queueFlush(); } function queueFlush() { if (!isFlushing && !isFlushPending) { isFlushPending = true; nextTick(flushJobs); } } const dedupe = (cbs) => [...new Set(cbs)]; function flushPostFlushCbs(seen) { if (postFlushCbs.length) { const cbs = dedupe(postFlushCbs); postFlushCbs.length = 0; for (let i = 0; i < cbs.length; i++) { cbs[i](); } } } function flushJobs(seen) { isFlushPending = false; isFlushing = true; let job; while ((job = queue.shift())) { callWithErrorHandling(job, null, 12 /* SCHEDULER */); } flushPostFlushCbs(); isFlushing = false; // some postFlushCb queued jobs! // keep flushing until it drains. if (queue.length || postFlushCbs.length) { flushJobs(); } } // mark the current rendering instance for asset resolution (e.g. // resolveComponent, resolveDirective) during render let currentRenderingInstance = null; // dev only flag to track whether $attrs was used during render. // If $attrs was used during render then the warning for failed attrs // fallthrough can be suppressed. let accessedAttrs = false; function renderComponentRoot(instance) { const { type: Component, vnode, proxy, withProxy, props, slots, attrs, emit } = instance; let result; currentRenderingInstance = instance; try { if (vnode.shapeFlag & 4 /* STATEFUL_COMPONENT */) { result = normalizeVNode(instance.render.call(withProxy || proxy)); } else { // functional const render = Component; result = normalizeVNode(render.length > 1 ? render(props, { attrs, slots, emit }) : render(props, null /* we know it doesn't need it */)); } // attr merging if (Component.props != null && Component.inheritAttrs !== false && attrs !== EMPTY_OBJ && Object.keys(attrs).length) { if (result.shapeFlag & 1 /* ELEMENT */ || result.shapeFlag & 6 /* COMPONENT */) { result = cloneVNode(result, attrs); } else if (false && !accessedAttrs && result.type !== Comment) { warn(`Extraneous non-props attributes (${Object.keys(attrs).join(',')}) ` + `were passed to component but could not be automatically inherited ` + `because component renders fragment or text root nodes.`); } } // inherit transition data if (vnode.transition != null) { if (false && !(result.shapeFlag & 6 /* COMPONENT */) && !(result.shapeFlag & 1 /* ELEMENT */) && result.type !== Comment) { warn(`Component inside <Transition> renders non-element root node ` + `that cannot be animated.`); } result.transition = vnode.transition; } } catch (err) { handleError(err, instance, 1 /* RENDER_FUNCTION */); result = createVNode(Comment); } currentRenderingInstance = null; return result; } function shouldUpdateComponent(prevVNode, nextVNode, parentComponent, optimized) { const { props: prevProps, children: prevChildren } = prevVNode; const { props: nextProps, children: nextChildren, patchFlag } = nextVNode; if (patchFlag > 0) { if (patchFlag & 512 /* DYNAMIC_SLOTS */) { // slot content that references values that might have changed, // e.g. in a v-for return true; } if (patchFlag & 16 /* FULL_PROPS */) { // presence of this flag indicates props are always non-null return hasPropsChanged(prevProps, nextProps); } else if (patchFlag & 8 /* PROPS */) { const dynamicProps = nextVNode.dynamicProps; for (let i = 0; i < dynamicProps.length; i++) { const key = dynamicProps[i]; if (nextProps[key] !== prevProps[key]) { return true; } } } } else if (!optimized) { // this path is only taken by manually written render functions // so presence of any children leads to a forced update if (prevChildren != null || nextChildren != null) { if (nextChildren == null || !nextChildren.$stable) { return true; } } if (prevProps === nextProps) { return false; } if (prevProps === null) { return nextProps !== null; } if (nextProps === null) { return true; } return hasPropsChanged(prevProps, nextProps); } return false; } function hasPropsChanged(prevProps, nextProps) { const nextKeys = Object.keys(nextProps); if (nextKeys.length !== Object.keys(prevProps).length) { return true; } for (let i = 0; i < nextKeys.length; i++) { const key = nextKeys[i]; if (nextProps[key] !== prevProps[key]) { return true; } } return false; } function updateHOCHostEl({ vnode, parent }, el // HostNode ) { while (parent && parent.subTree === vnode) { (vnode = parent.vnode).el = el; parent = parent.parent; } } // resolve raw VNode data. // - filter out reserved keys (key, ref, slots) // - extract class and style into $attrs (to be merged onto child // component root) // - for the rest: // - if has declared props: put declared ones in `props`, the rest in `attrs` // - else: everything goes in `props`. function resolveProps(instance, rawProps, _options) { const hasDeclaredProps = _options != null; if (!rawProps && !hasDeclaredProps) { return; } const { 0: options, 1: needCastKeys } = normalizePropsOptions(_options); const props = {}; let attrs = void 0; // update the instance propsProxy (passed to setup()) to trigger potential // changes const propsProxy = instance.propsProxy; const setProp = propsProxy ? (key, val) => { props[key] = val; propsProxy[key] = val; } : (key, val) => { props[key] = val; }; // allow mutation of propsProxy (which is readonly by default) reactivity.unlock(); if (rawProps != null) { for (const key in rawProps) { // key, ref are reserved and never passed down if (key === 'key' || key === 'ref') continue; // prop option names are camelized during normalization, so to support // kebab -> camel conversion here we need to camelize the key. const camelKey = camelize(key); if (hasDeclaredProps && !hasOwn(options, camelKey)) { (attrs || (attrs = {}))[key] = rawProps[key]; } else { setProp(camelKey, rawProps[key]); } } } if (hasDeclaredProps) { // set default values & cast booleans for (let i = 0; i < needCastKeys.length; i++) { const key = needCastKeys[i]; let opt = options[key]; if (opt == null) continue; const isAbsent = !hasOwn(props, key); const hasDefault = hasOwn(opt, 'default'); const currentValue = props[key]; // default values if (hasDefault && currentValue === undefined) { const defaultValue = opt.default; setProp(key, isFunction(defaultValue) ? defaultValue() : defaultValue); } // boolean casting if (opt[0 /* shouldCast */]) { if (isAbsent && !hasDefault) { setProp(key, false); } else if (opt[1 /* shouldCastTrue */] && (currentValue === '' || currentValue === hyphenate(key))) { setProp(key, true); } } } } else { // if component has no declared props, $attrs === $props attrs = props; } // in case of dynamic props, check if we need to delete keys from // the props proxy const { patchFlag } = instance.vnode; if (propsProxy !== null && (patchFlag === 0 || patchFlag & 16 /* FULL_PROPS */)) { const rawInitialProps = reactivity.toRaw(propsProxy); for (const key in rawInitialProps) { if (!hasOwn(props, key)) { delete propsProxy[key]; } } } // lock readonly reactivity.lock(); instance.props = props; instance.attrs = options ? attrs || EMPTY_OBJ : props; } const normalizationMap = new WeakMap(); function normalizePropsOptions(raw) { if (!raw) { return []; } if (normalizationMap.has(raw)) { return normalizationMap.get(raw); } const options = {}; const needCastKeys = []; if (isArray(raw)) { for (let i = 0; i < raw.length; i++) { const normalizedKey = camelize(raw[i]); if (normalizedKey[0] !== '$') { options[normalizedKey] = EMPTY_OBJ; } } } else { for (const key in raw) { const normalizedKey = camelize(key); if (normalizedKey[0] !== '$') { const opt = raw[key]; const prop = (options[normalizedKey] = isArray(opt) || isFunction(opt) ? { type: opt } : opt); if (prop != null) { const booleanIndex = getTypeIndex(Boolean, prop.type); const stringIndex = getTypeIndex(String, prop.type); prop[0 /* shouldCast */] = booleanIndex > -1; prop[1 /* shouldCastTrue */] = booleanIndex < stringIndex; // if the prop needs boolean casting or default value if (booleanIndex > -1 || hasOwn(prop, 'default')) { needCastKeys.push(normalizedKey); } } } } } const normalized = [options, needCastKeys]; normalizationMap.set(raw, normalized); return normalized; } // use function string name to check type constructors // so that it works across vms / iframes. function getType(ctor) { const match = ctor && ctor.toString().match(/^\s*function (\w+)/); return match ? match[1] : ''; } function isSameType(a, b) { return getType(a) === getType(b); } function getTypeIndex(type, expectedTypes) { if (isArray(expectedTypes)) { for (let i = 0, len = expectedTypes.length; i < len; i++) { if (isSameType(expectedTypes[i], type)) { return i; } } } else if (isObject(expectedTypes)) { return isSameType(expectedTypes, type) ? 0 : -1; } return -1; } const normalizeSlotValue = (value) => isArray(value) ? value.map(normalizeVNode) : [normalizeVNode(value)]; const normalizeSlot = (key, rawSlot) => (props) => { return normalizeSlotValue(rawSlot(props)); }; function resolveSlots(instance, children) { let slots; if (instance.vnode.shapeFlag & 32 /* SLOTS_CHILDREN */) { const rawSlots = children; if (rawSlots._compiled) { // pre-normalized slots object generated by compiler slots = children; } else { slots = {}; for (const key in rawSlots) { if (key === '$stable') continue; const value = rawSlots[key]; if (isFunction(value)) { slots[key] = normalizeSlot(key, value); } else if (value != null) { const normalized = normalizeSlotValue(value); slots[key] = () => normalized; } } } } else if (children !== null) { const normalized = normalizeSlotValue(children); slots = { default: () => normalized }; } instance.slots = slots || EMPTY_OBJ; } /** Runtime helper for applying directives to a vnode. Example usage: const comp = resolveComponent('comp') const foo = resolveDirective('foo') const bar = resolveDirective('bar') return withDirectives(h(comp), [ [foo, this.x], [bar, this.y] ]) */ const directiveToVnodeHooksMap = /*#__PURE__*/ [ 'beforeMount', 'mounted', 'beforeUpdate', 'updated', 'beforeUnmount', 'unmounted' ].reduce((map, key) => { const vnodeKey = `onVnode` + key[0].toUpperCase() + key.slice(1); const vnodeHook = (vnode, prevVnode) => { const bindings = vnode.dirs; const prevBindings = prevVnode ? prevVnode.dirs : EMPTY_ARR; for (let i = 0; i < bindings.length; i++) { const binding = bindings[i]; const hook = binding.dir[key]; if (hook != null) { if (prevVnode != null) { binding.oldValue = prevBindings[i].value; } hook(vnode.el, binding, vnode, prevVnode); } } }; map[key] = [vnodeKey, vnodeHook]; return map; }, {}); function withDirectives(vnode, directives) { const internalInstance = currentRenderingInstance; if (internalInstance === null) { return vnode; } const instance = internalInstance.proxy; const props = vnode.props || (vnode.props = {}); const bindings = vnode.dirs || (vnode.dirs = new Array(directives.length)); const injected = {}; for (let i = 0; i < directives.length; i++) { let [dir, value, arg, modifiers = EMPTY_OBJ] = directives[i]; if (isFunction(dir)) { dir = { mounted: dir, updated: dir }; } bindings[i] = { dir, instance, value, oldValue: void 0, arg, modifiers }; // inject onVnodeXXX hooks for (const key in dir) { if (!injected[key]) { const { 0: hookName, 1: hook } = directiveToVnodeHooksMap[key]; const existing = props[hookName]; props[hookName] = existing ? [].concat(existing, hook) : hook; injected[key] = true; } } } return vnode; } function invokeDirectiveHook(hook, instance, vnode, prevVNode = null) { callWithAsyncErrorHandling(hook, instance, 7 /* DIRECTIVE_HOOK */, [ vnode, prevVNode ]); } function createAppContext() { return { config: { devtools: true, performance: false, isNativeTag: NO, isCustomElement: NO, errorHandler: undefined, warnHandler: undefined }, mixins: [], components: {}, directives: {}, provides: {} }; } function createAppAPI(render) { return function createApp() { const context = createAppContext(); const installedPlugins = new Set(); let isMounted = false; const app = { get config() { return context.config; }, set config(v) { }, use(plugin, ...options) { if (installedPlugins.has(plugin)) ; else if (isFunction(plugin)) { installedPlugins.add(plugin); plugin(app, ...options); } else if (plugin && isFunction(plugin.install)) { installedPlugins.add(plugin); plugin.install(app, ...options); } return app; }, mixin(mixin) { if (!context.mixins.includes(mixin)) { context.mixins.push(mixin); } return app; }, component(name, component) { if (!component) { return context.components[name]; } context.components[name] = component; return app; }, directive(name, directive) { if (!directive) { return context.directives[name]; } context.directives[name] = directive; return app; }, mount(rootComponent, rootContainer, rootProps) { if (!isMounted) { if (rootProps != null && !isObject(rootProps)) { rootProps = null; } const vnode = createVNode(rootComponent, rootProps); // store app context on the root VNode. // this will be set on the root instance on initial mount. vnode.appContext = context; render(vnode, rootContainer); isMounted = true; return vnode.component.proxy; } }, provide(key, value) { // TypeScript doesn't allow symbols as index type // https://github.com/Microsoft/TypeScript/issues/24587 context.provides[key] = value; return app; } }; return app; }; } // Suspense exposes a component-like API, and is treated like a component // in the compiler, but internally it's a special built-in type that hooks // directly into the renderer. const SuspenseImpl = { // In order to make Suspense tree-shakable, we need to avoid importing it // directly in the renderer. The renderer checks for the __isSuspense flag // on a vnode's type and calls the `process` method, passing in renderer // internals. __isSuspense: true, process(n1, n2, container, anchor, parentComponent, parentSuspense, isSVG, optimized, // platform-specific impl passed from renderer rendererInternals) { if (n1 == null) { mountSuspense(n2, container, anchor, parentComponent, parentSuspense, isSVG, optimized, rendererInternals); } else { patchSuspense(n1, n2, container, anchor, parentComponent, isSVG, optimized, rendererInternals); } } }; // Force-casted public typing for h and TSX props inference const Suspense = ( SuspenseImpl ); function mountSuspense(n2, container, anchor, parentComponent, parentSuspense, isSVG, optimized, rendererInternals) { const { patch, options: { createElement } } = rendererInternals; const hiddenContainer = createElement('div'); const suspense = (n2.suspense = createSuspenseBoundary(n2, parentSuspense, parentComponent, container, hiddenContainer, anchor, isSVG, optimized, rendererInternals)); const { content, fallback } = normalizeSuspenseChildren(n2); suspense.subTree = content; suspense.fallbackTree = fallback; // start mounting the content subtree in an off-dom container patch(null, content, hiddenContainer, null, parentComponent, suspense, isSVG, optimized); // now check if we have encountered any async deps if (suspense.deps > 0) { // mount the fallback tree patch(null, fallback, container, anchor, parentComponent, null, // fallback tree will not have suspense context isSVG, optimized); n2.el = fallback.el; } else { // Suspense has no async deps. Just resolve. suspense.resolve(); } } function patchSuspense(n1, n2, container, anchor, parentComponent, isSVG, optimized, { patch }) { const suspense = (n2.suspense = n1.suspense); suspense.vnode = n2; const { content, fallback } = normalizeSuspenseChildren(n2); const oldSubTree = suspense.subTree; const oldFallbackTree = suspense.fallbackTree; if (!suspense.isResolved) { patch(oldSubTree, content, suspense.hiddenContainer, null, parentComponent, suspense, isSVG, optimized); if (suspense.deps > 0) { // still pending. patch the fallback tree. patch(oldFallbackTree, fallback, container, anchor, parentComponent, null, // fallback tree will not have suspense context isSVG, optimized); n2.el = fallback.el; } // If deps somehow becomes 0 after the patch it means the patch caused an // async dep component to unmount and removed its dep. It will cause the // suspense to resolve and we don't need to do anything here. } else { // just normal patch inner content as a fragment patch(oldSubTree, content, container, anchor, parentComponent, suspense, isSVG, optimized); n2.el = content.el; } suspense.subTree = content; suspense.fallbackTree = fallback; } function createSuspenseBoundary(vnode, parent, parentComponent, container, hiddenContainer, anchor, isSVG, optimized, rendererInternals) { const { patch, move, unmount, next, options: { parentNode } } = rendererInternals; const suspense = { vnode, parent, parentComponent, isSVG, optimized, container, hiddenContainer, anchor, deps: 0, subTree: null, fallbackTree: null, isResolved: false, isUnmounted: false, effects: [], resolve() { const { vnode, subTree, fallbackTree, effects, parentComponent, container } = suspense; // this is initial anchor on mount let { anchor } = suspense; // unmount fallback tree if (fallbackTree.el) { // if the fallback tree was mounted, it may have been moved // as part of a parent suspense. get the latest anchor for insertion anchor = next(fallbackTree); unmount(fallbackTree, parentComponent, suspense, true); } // move content from off-dom container to actual container move(subTree, container, anchor, 0 /* ENTER */); const el = (vnode.el = subTree.el); // suspense as the root node of a component... if (parentComponent && parentComponent.subTree === vnode) { parentComponent.vnode.el = el; updateHOCHostEl(parentComponent, el); } // check if there is a pending parent suspense let parent = suspense.parent; let hasUnresolvedAncestor = false; while (parent) { if (!parent.isResolved) { // found a pending parent suspense, merge buffered post jobs // into that parent parent.effects.push(...effects); hasUnresolvedAncestor = true; break; } parent = parent.parent; } // no pending parent suspense, flush all jobs if (!hasUnresolvedAncestor) { queuePostFlushCb(effects); } suspense.isResolved = true; // invoke @resolve event const onResolve = vnode.props && vnode.props.onResolve; if (isFunction(onResolve)) { onResolve(); } }, recede() { suspense.isResolved = false; const { vnode, subTree, fallbackTree, parentComponent, container, hiddenContainer, isSVG, optimized } = suspense; // move content tree back to the off-dom container const anchor = next(subTree); move(subTree, hiddenContainer, null, 1 /* LEAVE */); // remount the fallback tree patch(null, fallbackTree, container, anchor, parentComponent, null, // fallback tree will not have suspense context isSVG, optimized); const el = (vnode.el = fallbackTree.el); // suspense as the root node of a component... if (parentComponent && parentComponent.subTree === vnode) { parentComponent.vnode.el = el; updateHOCHostEl(parentComponent, el); } // invoke @recede event const onRecede = vnode.props && vnode.props.onRecede; if (isFunction(onRecede)) { onRecede(); } }, move(container, anchor, type) { move(suspense.isResolved ? suspense.subTree : suspense.fallbackTree, container, anchor, type); suspense.container = container; }, next() { return next(suspense.isResolved ? suspense.subTree : suspense.fallbackTree); }, registerDep(instance, setupRenderEffect) { // suspense is already resolved, need to recede. // use queueJob so it's handled synchronously after patching the current // suspense tree if (suspense.isResolved) { queueJob(() => { suspense.recede(); }); } suspense.deps++; instance .asyncDep.catch(err => { handleError(err, instance, 0 /* SETUP_FUNCTION */); }) .then(asyncSetupResult => { // retry when the setup() promise resolves. // component may have been unmounted before resolve. if (instance.isUnmounted || suspense.isUnmounted) { return; } suspense.deps--; // retry from this component instance.asyncResolved = true; const { vnode } = instance; handleSetupResult(instance, asyncSetupResult, suspense); setupRenderEffect(instance, suspense, vnode, // component may have been moved before resolve parentNode(instance.subTree.el), next(instance.subTree), isSVG); updateHOCHostEl(instance, vnode.el); if (suspense.deps === 0) { suspense.resolve(); } }); }, unmount(parentSuspense, doRemove) { suspense.isUnmounted = true; unmount(suspense.subTree, parentComponent, parentSuspense, doRemove); if (!suspense.isResolved) { unmount(suspense.fallbackTree, parentComponent, parentSuspense, doRemove); } } }; return suspense; } function normalizeSuspenseChildren(vnode) { const { shapeFlag, children } = vnode; if (shapeFlag & 32 /* SLOTS_CHILDREN */) { const { default: d, fallback } = children; return { content: normalizeVNode(isFunction(d) ? d() : d), fallback: normalizeVNode(isFunction(fallback) ? fallback() : fallback) }; } else { return { content: normalizeVNode(children), fallback: normalizeVNode(null) }; } } function queueEffectWithSuspense(fn, suspense) { if (suspense !== null && !suspense.isResolved) { if (isArray(fn)) { suspense.effects.push(...fn); } else { suspense.effects.push(fn); } } else { queuePostFlushCb(fn); } } const prodEffectOptions = { scheduler: queueJob }; function invokeHooks(hooks, arg) { for (let i = 0; i < hooks.length; i++) { hooks[i](arg); } } const queuePostRenderEffect = queueEffectWithSuspense ; /** * 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 * }) * ``` */ function createRenderer(options) { const { insert: hostInsert, remove: hostRemove, patchProp: hostPatchProp, createElement: hostCreateElement, createText: hostCreateText, createComment: hostCreateComment, setText: hostSetText, setElementText: hostSetElementText, parentNode: hostParentNode, nextSibling: hostNextSibling, querySelector: hostQuerySelector, setScopeId: hostSetScopeId } = options; const internals = { patch, unmount, move, next: getNextHostNode, options }; function patch(n1, // null means this is a mount n2, container, anchor = null, parentComponent = null, parentSuspense = null, isSVG = false, optimized = false) { // patching & not same type, unmount old tree if (n1 != null && !isSameVNodeType(n1, n2)) { anchor = getNextHostNode(n1); unmount(n1, parentComponent, parentSuspense, true); n1 = null; }