chrome-devtools-frontend/scripts/eslint_rules/lib/l10n-no-uistrings-export.js

Chrome DevTools UI

// Copyright 2021 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

'use strict';

const l10nHelper = require('./l10n-helper.js');

const MODULE_UI_STRINGS_FILENAME_REGEX = /ModuleUIStrings\.(js|ts)$/;
const TRACE_INSIGHTS_UI_STRINGS_FILENAME_REGEX = /models\/trace\/insights\/.*\.(js|ts)$/;

/**
 * @type {import('eslint').Rule.RuleModule}
 */
module.exports = {
  meta: {
    type: 'problem',
    docs: {
      description: 'UIStrings object literals are only allowed to be exported from ModuleUIStrings.(js|ts) or trace/model/insights',
      category: 'Possible Errors',
    },
    fixable: 'code',
    schema: []  // no options
  },
  create: function(context) {
    const filename = (context.filename ?? context.getFilename()).replaceAll('\\', '/');
    const sourceCode = context.sourceCode ?? context.getSourceCode();
    function removeExportKeywordFromUIStrings(fixer, exportNamedDeclaration) {
      const exportToken = sourceCode.getFirstToken(exportNamedDeclaration);
      if (exportToken.type === 'Keyword' && exportToken.value === 'export') {
        return fixer.remove(exportToken);
      }
      return [];
    }

    return {
      ExportNamedDeclaration(exportNamedDeclaration) {
        if (MODULE_UI_STRINGS_FILENAME_REGEX.test(filename)) {
          return;
        }

        if (TRACE_INSIGHTS_UI_STRINGS_FILENAME_REGEX.test(filename)) {
          return;
        }

        const declaration = exportNamedDeclaration.declaration;
        if (declaration?.type !== 'VariableDeclaration') {
          return;
        }

        if (declaration.declarations.length === 0 || declaration.declarations[0].type !== 'VariableDeclarator') {
          return;
        }

        if (l10nHelper.isUIStringsIdentifier(declaration.declarations[0].id)) {
          context.report({
            node: declaration.declarations[0],
            message: 'Exporting the UIStrings object is only allowed in ModuleUIStrings.(js|ts) or trace/model/insights',
            fix: fixer => removeExportKeywordFromUIStrings(fixer, exportNamedDeclaration),
          });
        }
      },
      ExportSpecifier(specifier) {
        if (specifier.local?.type === 'Identifier' && specifier.local.name === 'UIStrings') {
          context.report({
            node: specifier,
            message: 'Exporting the UIStrings object is only allowed in ModuleUIStrings.(js|ts) or trace/model/insights',
          });
        }
      }
    };
  }
};