avoid-unknown-pragma

v1.15.0

warning

effort: 2m

recommended

configurable

pro+

Warns when the @pragma annotation has an unknown value.

Annotation values are checked against these lists:

• https://github.com/dart-lang/sdk/blob/main/runtime/docs/pragmas.md
• https://github.com/dart-lang/sdk/blob/main/pkg/compiler/doc/pragmas.md

⚙️ Config

Set additional-pragmas (default is empty) to set the list of additional known pragma values.

analysis_options.yaml

dcm:
  rules:
    - avoid-unknown-pragma:
        additional-pragmas:
          - additional:value

Example

❌ Bad:

// LINT: Avoid unknown pragma annotations. Try checking this annotation for a potential typo.
@pragma('vm:prefer-inlined')
Future<String> fn() {
  ...
}

✅ Good:

@pragma('vm:prefer-inline') // Correct, 'inline' instead of 'inlined'
Future<String> fn() {
  ...
}

Related Rules

• avoid-redundant-pragma-inline
• prefer-both-inlining-annotations