如何定义类允许存在的属性以规避Unresolved variable代码检查警告

• 方案1：使用JSDoc标注属性类型（无运行时代码侵入） #

这是最轻量化的方案，仅通过注释就能让IDE识别类的允许属性，不会改变实际运行逻辑，也不需要添加冗余的初始化代码。
示例代码：

/**
 * 先统一声明可选配置的类型
 * @typedef {Object} UserConfig
 * @property {string} [username] 可选用户名
 * @property {number} [level] 可选等级
 * @property {boolean} [isVip] 可选会员状态
 */
class User {
  /** @type {UserConfig['username']} */
  username
  /** @type {UserConfig['level']} */
  level
  /** @type {UserConfig['isVip']} */
  isVip

  /** @param {UserConfig} config */
  constructor(config) {
    Object.assign(this, config)
  }
}

如果你的类属性非常多，不想逐个标注，可以直接给类添加索引签名，允许任意字符串属性：

/** @class {{[key: string]: any}} */
class DynamicPropsClass {
  constructor(config) {
    Object.assign(this, config)
  }
}

注意索引签名会弱化类型检查的严谨性，非必要不推荐使用。

• 方案2：显式声明类公共字段（ES2022+支持） #

直接在类体中声明所有允许的属性，可选属性可以直接赋值为undefined，IDE会自动识别这些属性的存在，不会抛出未解析警告：

class User {
  // 声明所有可选属性，初始值设为undefined即可
  username = undefined
  level = undefined
  isVip = undefined

  constructor(config) {
    Object.assign(this, config)
  }
}

该方案符合原生JS语法规范，兼容性覆盖所有现代浏览器和Node.js 16+版本。

• 方案3：单行局部忽略警告 #

如果只是个别属性偶尔需要临时消除警告，可以针对单行添加IDE识别的忽略注释，不会影响全局检查规则：

• VSCode/基于TypeScript检查的编辑器：添加// @ts-ignore
• WebStorm/IDEA系列编辑器：添加// noinspection JSUnresolvedVariable

所有方案均不需要切换到TypeScript，也不需要关闭全局代码检查功能即可生效。

内容的提问来源于stack exchange，提问作者Martyn Ball