noDynamicNamespaceImportAccess

JavaScript (and super languages)

摘要

¥Summary

规则生效日期：v1.9.0

¥Rule available since: v1.9.0
诊断类别：lint/performance/noDynamicNamespaceImportAccess

¥Diagnostic Category: lint/performance/noDynamicNamespaceImportAccess
此规则为推荐规则，默认启用。

¥This rule is recommended, which means is enabled by default.
此规则没有修复方案。

¥This rule doesn’t have a fix.
此规则的默认严重级别为 warning。

¥The default severity of this rule is warning.

如何配置

¥How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "performance": {
5
        "noDynamicNamespaceImportAccess": "error"
6
      }
7
    }
8
  }
9
}

描述

¥Description

禁止动态访问命名空间导入。

¥Disallow accessing namespace imports dynamically.

动态访问命名空间导入可以防止有效的树摇动并增加包大小。发生这种情况的原因是，打包器无法确定在编译时使用了命名空间的哪些部分，因此它必须在打包包中包含整个命名空间。

¥Accessing namespace imports dynamically can prevent efficient tree shaking and increase bundle size. This happens because the bundler cannot determine which parts of the namespace are used at compile time, so it must include the entire namespace in the bundle.

相反，请考虑使用命名导入，如果无法做到这一点，请静态访问命名空间导入属性。

¥Instead, consider using named imports or if that is not possible access the namespaced import properties statically.

如果你想完全禁止命名空间导入，请考虑使用 noNamespaceImport 规则。

¥If you want to completely disallow namespace imports, consider using the noNamespaceImport rule.

示例

¥Examples

无效

¥Invalid

1
import * as foo from "foo"
2
foo["bar"]

code-block.js:2:1 lint/performance/noDynamicNamespaceImportAccess ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ⚠ Avoid accessing namespace imports dynamically, it can prevent efficient tree shaking and increase bundle size.
  
    1 │ import * as foo from “foo”
  > 2 │ foo[“bar”]
      │ ^^^^^^^^^^
    3 │ 
  
  ℹ Prefer static property access or use named imports instead.

1
import * as foo from "foo"
2
const key = "bar"
3
foo[key]

code-block.js:3:1 lint/performance/noDynamicNamespaceImportAccess ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ⚠ Avoid accessing namespace imports dynamically, it can prevent efficient tree shaking and increase bundle size.
  
    1 │ import * as foo from “foo”
    2 │ const key = “bar”
  > 3 │ foo[key]
      │ ^^^^^^^^
    4 │ 
  
  ℹ Prefer static property access or use named imports instead.

有效

¥Valid

1
import * as foo from "foo"
2
foo.bar

1
import { bar } from "foo"
2
bar

1
import messages from "i18n"
2
const knownMessagesMap = {
3
 hello: messages.hello,
4
 goodbye: messages.goodbye
5
}
6

7
const dynamicKey = "hello"
8
knownMessagesMap[dynamicKey]

noDynamicNamespaceImportAccess

摘要

如何配置

描述

示例

无效

有效

相关链接