/** * @fileoverview Rule to enforce spacing around embedded expressions of template strings * @author Toru Nagashima * @deprecated in ESLint v8.53.0 */ 'use strict'; //------------------------------------------------------------------------------ // Requirements //------------------------------------------------------------------------------ const astUtils = require('./utils/ast-utils'); //------------------------------------------------------------------------------ // Rule Definition //------------------------------------------------------------------------------ /** @type {import('../types').Rule.RuleModule} */ module.exports = { meta: { deprecated: { message: 'Formatting rules are being moved out of ESLint core.', url: 'https://eslint.org/blog/2023/10/deprecating-formatting-rules/', deprecatedSince: '8.53.0', availableUntil: '10.0.0', replacedBy: [ { message: 'ESLint Stylistic now maintains deprecated stylistic core rules.', url: 'https://eslint.style/guide/migration', plugin: { name: '@stylistic/eslint-plugin-js', url: 'https://eslint.style/packages/js', }, rule: { name: 'template-curly-spacing', url: 'https://eslint.style/rules/js/template-curly-spacing', }, }, ], }, type: 'layout', docs: { description: 'Require or disallow spacing around embedded expressions of template strings', recommended: false, url: 'https://eslint.org/docs/latest/rules/template-curly-spacing', }, fixable: 'whitespace', schema: [{ enum: ['always', 'never'] }], messages: { expectedBefore: "Expected space(s) before '}'.", expectedAfter: "Expected space(s) after '${'.", unexpectedBefore: "Unexpected space(s) before '}'.", unexpectedAfter: "Unexpected space(s) after '${'.", }, }, create(context) { const sourceCode = context.sourceCode; const always = context.options[0] === 'always'; /** * Checks spacing before `}` of a given token. * @param {Token} token A token to check. This is a Template token. * @returns {void} */ function checkSpacingBefore(token) { if (!token.value.startsWith('}')) { return; // starts with a backtick, this is the first template element in the template literal } const prevToken = sourceCode.getTokenBefore(token, { includeComments: true, }), hasSpace = sourceCode.isSpaceBetween(prevToken, token); if (!astUtils.isTokenOnSameLine(prevToken, token)) { return; } if (always && !hasSpace) { context.report({ loc: { start: token.loc.start, end: { line: token.loc.start.line, column: token.loc.start.column + 1, }, }, messageId: 'expectedBefore', fix: (fixer) => fixer.insertTextBefore(token, ' '), }); } if (!always && hasSpace) { context.report({ loc: { start: prevToken.loc.end, end: token.loc.start, }, messageId: 'unexpectedBefore', fix: (fixer) => fixer.removeRange([prevToken.range[1], token.range[0]]), }); } } /** * Checks spacing after `${` of a given token. * @param {Token} token A token to check. This is a Template token. * @returns {void} */ function checkSpacingAfter(token) { if (!token.value.endsWith('${')) { return; // ends with a backtick, this is the last template element in the template literal } const nextToken = sourceCode.getTokenAfter(token, { includeComments: true, }), hasSpace = sourceCode.isSpaceBetween(token, nextToken); if (!astUtils.isTokenOnSameLine(token, nextToken)) { return; } if (always && !hasSpace) { context.report({ loc: { start: { line: token.loc.end.line, column: token.loc.end.column - 2, }, end: token.loc.end, }, messageId: 'expectedAfter', fix: (fixer) => fixer.insertTextAfter(token, ' '), }); } if (!always && hasSpace) { context.report({ loc: { start: token.loc.end, end: nextToken.loc.start, }, messageId: 'unexpectedAfter', fix: (fixer) => fixer.removeRange([token.range[1], nextToken.range[0]]), }); } } return { TemplateElement(node) { const token = sourceCode.getFirstToken(node); checkSpacingBefore(token); checkSpacingAfter(token); }, }; }, };