This repository has been archived on 2020-11-02. You can view files and clone it, but cannot push or open issues or pull requests.
2020-11-01 22:46:04 +00:00

150 lines
4.0 KiB
JavaScript

/**
* @author Yosuke Ota
* See LICENSE file in root directory for full license.
*/
'use strict'
const { findVariable } = require('eslint-utils')
const utils = require('../utils')
module.exports = {
meta: {
type: 'suggestion',
docs: {
description: 'disallow destructuring of `props` passed to `setup`',
categories: ['vue3-essential'],
url: 'https://eslint.vuejs.org/rules/no-setup-props-destructure.html'
},
fixable: null,
schema: [],
messages: {
destructuring:
'Destructuring the `props` will cause the value to lose reactivity.',
getProperty:
'Getting a value from the `props` in root scope of `setup()` will cause the value to lose reactivity.'
}
},
/** @param {RuleContext} context */
create(context) {
/** @type {Map<FunctionDeclaration | FunctionExpression | ArrowFunctionExpression, Set<Identifier>>} */
const setupScopePropsReferenceIds = new Map()
/**
* @param {ESNode} node
* @param {string} messageId
*/
function report(node, messageId) {
context.report({
node,
messageId
})
}
/**
* @param {Pattern} left
* @param {Expression | null} right
* @param {Set<Identifier>} propsReferenceIds
*/
function verify(left, right, propsReferenceIds) {
if (!right) {
return
}
const rightNode = utils.skipChainExpression(right)
if (
left.type !== 'ArrayPattern' &&
left.type !== 'ObjectPattern' &&
rightNode.type !== 'MemberExpression'
) {
return
}
/** @type {Expression | Super} */
let rightId = rightNode
while (rightId.type === 'MemberExpression') {
rightId = utils.skipChainExpression(rightId.object)
}
if (rightId.type === 'Identifier' && propsReferenceIds.has(rightId)) {
report(left, 'getProperty')
}
}
/**
* @typedef {object} ScopeStack
* @property {ScopeStack | null} upper
* @property {FunctionDeclaration | FunctionExpression | ArrowFunctionExpression} functionNode
*/
/**
* @type {ScopeStack | null}
*/
let scopeStack = null
return utils.defineVueVisitor(context, {
':function'(node) {
scopeStack = {
upper: scopeStack,
functionNode: node
}
},
onSetupFunctionEnter(node) {
const propsParam = utils.skipDefaultParamValue(node.params[0])
if (!propsParam) {
// no arguments
return
}
if (propsParam.type === 'RestElement') {
// cannot check
return
}
if (
propsParam.type === 'ArrayPattern' ||
propsParam.type === 'ObjectPattern'
) {
report(propsParam, 'destructuring')
return
}
const variable = findVariable(context.getScope(), propsParam)
if (!variable) {
return
}
const propsReferenceIds = new Set()
for (const reference of variable.references) {
if (!reference.isRead()) {
continue
}
propsReferenceIds.add(reference.identifier)
}
setupScopePropsReferenceIds.set(node, propsReferenceIds)
},
VariableDeclarator(node) {
if (!scopeStack) {
return
}
const propsReferenceIds = setupScopePropsReferenceIds.get(
scopeStack.functionNode
)
if (!propsReferenceIds) {
return
}
verify(node.id, node.init, propsReferenceIds)
},
AssignmentExpression(node) {
if (!scopeStack) {
return
}
const propsReferenceIds = setupScopePropsReferenceIds.get(
scopeStack.functionNode
)
if (!propsReferenceIds) {
return
}
verify(node.left, node.right, propsReferenceIds)
},
':function:exit'(node) {
scopeStack = scopeStack && scopeStack.upper
setupScopePropsReferenceIds.delete(node)
}
})
}
}