Check Unnecessary Nullable Parameters

Checks unnecessary nullable parameters in functions, methods, constructors. Removing unnecessary nullables can help reduce amount of checks in the code.

To execute the command, run:

$ dart run dart_code_linter:metrics check-unnecessary-nullable lib

Full command description:

Usage: metrics check-unnecessary-nullable [arguments] <directories>
-h, --help                                       Print this usage information.


-r, --reporter=<console>                         The format of the output of the analysis.
                                                 [console (default), codeclimate, json, gitlab]


-c, --print-config                               Print resolved config.


    --root-folder=<./>                           Root folder.
                                                 (defaults to current directory)
    --sdk-path=<directory-path>                  Dart SDK directory path.
                                                 If the project has a `.fvm/flutter_sdk` symlink, it will be used if the SDK is not found.
    --exclude=<{**/*.g.dart,**/*.freezed.dart}>  File paths in Glob syntax to be exclude.
                                                 (defaults to "{**/*.g.dart,**/*.freezed.dart}")


    --no-congratulate                            Don't show output even when there are no issues.


    --[no-]verbose                               Show verbose logs.


    --no-analytics                               Disable sending anonymous usage statistics.


    --[no-]monorepo                              Treat all exported code with parameters as non-nullable by default.


    --[no-]fatal-found                           Treat found unnecessary nullable parameters as fatal.
                                                 (defaults to on)

Suppressing the command

In order to suppress the command add the ignore: unnecessary-nullable comment. To suppress for an entire file add ignore_for_file: unnecessary-nullable to the beginning of a file.

Monorepo support

caution

By default this command treats all code that is exported from the package as used. It uses check-exports-completeness results and won't report even transitive public entities that are not exported directly.

This command also follows this convention of locating implementation files in the lib/src/ folder. If you don't follow this convention, you will need to pass the --monorepo flag for this command to work.

To disable this behavior use --monorepo flag. This might be useful when all the packages in your repository are only used within the repository and are not published to the pub.

Output example

Console

Use --reporter=console to enable this format.

JSON

The reporter prints a single JSON object containing meta information and the unnecessary nullable parameters. Use --reporter=json to enable this format. The root object fields are

formatVersion - an integer representing the format version (will be incremented each time the serialization format changes) timestamp - a creation time of the report in YYYY-MM-DD HH:MM:SS format unnecessaryNullable - an array of unnecessary nullable issues

{
  "formatVersion": 2,
  "timestamp": "2021-04-11 14:44:42",
  "unnecessaryNullable": [
    {
      ...
    },
    {
      ...
    },
    {
      ...
    }
  ]
}

The unnecessaryNullable object fields are

• path - a relative path of the file with unnecessary nullable parameters declaration
• issues - an array of issues detected in the target class

{
  "path": "lib/src/some/class.dart",
  "issues": [
    ...
  ],
}

The issue object fields are

• declarationName - the name of a declaration with unnecessary nullable parameters
• declarationType - the type of a declaration with unnecessary nullable parameters (function, method or constructor)
• parameters - an array of strings representing parameters that are marked as nullable
• offset - a zero-based offset of the class member location in the source
• line - a zero-based line of the class member location in the source
• column - a zero-based column of class member the location in the source

{
  "declarationName": "someFunction",
  "declarationType": "function",
  "parameters": "[String? value]",
  "offset": 156,
  "line": 7,
  "column": 1
}

GitLab

Reports unnecessary nullable issues in merge requests based on Code Quality custom tool. Use --reporter=gitlab to enable this format.