ember-template-lint/lib/rules/require-each-key.js

Linter for Ember or Handlebars templates.

'use strict';

const AstNodeInfo = require('../helpers/ast-node-info');
const Rule = require('./base');

const ERROR_MESSAGE = '{{#each}} helper requires a valid key value to avoid performance issues';

const SPECIAL_KEY_VALUES = new Set(['@index', '@identity']);

module.exports = class RequireEachKey extends Rule {
  visitor() {
    return {
      BlockStatement(node) {
        const isEach = AstNodeInfo.isEach(node);
        const keyPair = node.hash.pairs.find((p) => p.key === 'key');
        const keyValue = keyPair && keyPair.value && keyPair.value.value;
        const isSpecialKey = keyValue && keyValue.startsWith('@');
        const isValidKey = isSpecialKey ? SPECIAL_KEY_VALUES.has(keyValue) : keyValue;
        const noKey = isEach && !keyPair;
        const invalidKey = isEach && !isValidKey;
        if (noKey || invalidKey) {
          this.log({
            message: ERROR_MESSAGE,
            line: node.loc && node.loc.start.line,
            column: node.loc && node.loc.start.column,
            source: this.sourceForNode(node),
          });
        }
      },
    };
  }
};

module.exports.ERROR_MESSAGE = ERROR_MESSAGE;