158 lines
4.5 KiB
JavaScript
158 lines
4.5 KiB
JavaScript
/**
|
|
* @author Yosuke Ota
|
|
* See LICENSE file in root directory for full license.
|
|
*/
|
|
'use strict'
|
|
|
|
const semver = require('semver')
|
|
const utils = require('../utils')
|
|
|
|
/**
|
|
* @typedef {object} SyntaxRule
|
|
* @property {string} supported
|
|
* @property { (context: RuleContext) => TemplateListener } [createTemplateBodyVisitor]
|
|
* @property { (context: RuleContext) => RuleListener } [createScriptVisitor]
|
|
*/
|
|
|
|
const FEATURES = {
|
|
// Vue.js 2.5.0+
|
|
'slot-scope-attribute': require('./syntaxes/slot-scope-attribute'),
|
|
// Vue.js 2.6.0+
|
|
'dynamic-directive-arguments': require('./syntaxes/dynamic-directive-arguments'),
|
|
'v-slot': require('./syntaxes/v-slot'),
|
|
// >=2.6.0-beta.1 <=2.6.0-beta.3
|
|
'v-bind-prop-modifier-shorthand': require('./syntaxes/v-bind-prop-modifier-shorthand'),
|
|
// Vue.js 3.0.0+
|
|
'v-model-argument': require('./syntaxes/v-model-argument'),
|
|
'v-model-custom-modifiers': require('./syntaxes/v-model-custom-modifiers'),
|
|
'v-is': require('./syntaxes/v-is')
|
|
}
|
|
|
|
const SYNTAX_NAMES = /** @type {(keyof FEATURES)[]} */ (Object.keys(FEATURES))
|
|
|
|
const cache = new Map()
|
|
/**
|
|
* Get the `semver.Range` object of a given range text.
|
|
* @param {string} x The text expression for a semver range.
|
|
* @returns {semver.Range} The range object of a given range text.
|
|
* It's null if the `x` is not a valid range text.
|
|
*/
|
|
function getSemverRange(x) {
|
|
const s = String(x)
|
|
let ret = cache.get(s) || null
|
|
|
|
if (!ret) {
|
|
try {
|
|
ret = new semver.Range(s)
|
|
} catch (_error) {
|
|
// Ignore parsing error.
|
|
}
|
|
cache.set(s, ret)
|
|
}
|
|
|
|
return ret
|
|
}
|
|
|
|
module.exports = {
|
|
meta: {
|
|
type: 'suggestion',
|
|
docs: {
|
|
description:
|
|
'disallow unsupported Vue.js syntax on the specified version',
|
|
categories: undefined,
|
|
url: 'https://eslint.vuejs.org/rules/no-unsupported-features.html'
|
|
},
|
|
fixable: 'code',
|
|
schema: [
|
|
{
|
|
type: 'object',
|
|
properties: {
|
|
version: {
|
|
type: 'string'
|
|
},
|
|
ignores: {
|
|
type: 'array',
|
|
items: {
|
|
enum: SYNTAX_NAMES
|
|
},
|
|
uniqueItems: true
|
|
}
|
|
},
|
|
additionalProperties: false
|
|
}
|
|
],
|
|
messages: {
|
|
// Vue.js 2.5.0+
|
|
forbiddenSlotScopeAttribute:
|
|
'`slot-scope` are not supported except Vue.js ">=2.5.0 <3.0.0".',
|
|
// Vue.js 2.6.0+
|
|
forbiddenDynamicDirectiveArguments:
|
|
'Dynamic arguments are not supported until Vue.js "2.6.0".',
|
|
forbiddenVSlot: '`v-slot` are not supported until Vue.js "2.6.0".',
|
|
// >=2.6.0-beta.1 <=2.6.0-beta.3
|
|
forbiddenVBindPropModifierShorthand:
|
|
'`.prop` shorthand are not supported except Vue.js ">=2.6.0-beta.1 <=2.6.0-beta.3".',
|
|
// Vue.js 3.0.0+
|
|
forbiddenVModelArgument:
|
|
'Argument on `v-model` is not supported until Vue.js "3.0.0".',
|
|
forbiddenVModelCustomModifiers:
|
|
'Custom modifiers on `v-model` are not supported until Vue.js "3.0.0".',
|
|
forbiddenVIs: '`v-is` are not supported until Vue.js "3.0.0".'
|
|
}
|
|
},
|
|
/** @param {RuleContext} context */
|
|
create(context) {
|
|
const { version, ignores } = Object.assign(
|
|
{
|
|
version: null,
|
|
ignores: []
|
|
},
|
|
context.options[0] || {}
|
|
)
|
|
if (!version) {
|
|
// version is not set.
|
|
return {}
|
|
}
|
|
const versionRange = getSemverRange(version)
|
|
|
|
/**
|
|
* Check whether a given case object is full-supported on the configured node version.
|
|
* @param {SyntaxRule} aCase The case object to check.
|
|
* @returns {boolean} `true` if it's supporting.
|
|
*/
|
|
function isNotSupportingVersion(aCase) {
|
|
return !semver.subset(versionRange, getSemverRange(aCase.supported))
|
|
}
|
|
|
|
/** @type {TemplateListener} */
|
|
let templateBodyVisitor = {}
|
|
/** @type {RuleListener} */
|
|
let scriptVisitor = {}
|
|
|
|
for (const syntaxName of SYNTAX_NAMES) {
|
|
/** @type {SyntaxRule} */
|
|
const syntax = FEATURES[syntaxName]
|
|
if (ignores.includes(syntaxName) || !isNotSupportingVersion(syntax)) {
|
|
continue
|
|
}
|
|
if (syntax.createTemplateBodyVisitor) {
|
|
const visitor = syntax.createTemplateBodyVisitor(context)
|
|
templateBodyVisitor = utils.compositingVisitors(
|
|
templateBodyVisitor,
|
|
visitor
|
|
)
|
|
}
|
|
if (syntax.createScriptVisitor) {
|
|
const visitor = syntax.createScriptVisitor(context)
|
|
scriptVisitor = utils.compositingVisitors(scriptVisitor, visitor)
|
|
}
|
|
}
|
|
|
|
return utils.defineTemplateBodyVisitor(
|
|
context,
|
|
templateBodyVisitor,
|
|
scriptVisitor
|
|
)
|
|
}
|
|
}
|