Skip to main content

Interface: CSpellReporterConfiguration

Defined in: cspell/src/app/models.ts:8

Extends​

Properties​

cache?​

readonly optional cache: boolean

Defined in: cspell/src/app/util/cache/CacheOptions.ts:12

Store the info about processed files in order to only operate on the changed ones.

Inherited from​

Readonly.cache

cacheFormat?​

readonly optional cacheFormat: CacheFormat

Defined in: cspell/src/app/util/cache/CacheOptions.ts:38

Format of the cache file.

  • legacy - use absolute paths in the cache file
  • universal - use a sharable format.

Default​

'legacy'

Inherited from​

Readonly.cacheFormat

cacheLocation?​

readonly optional cacheLocation: string

Defined in: cspell/src/app/util/cache/CacheOptions.ts:20

Path to the cache location. Can be a file or a directory. If none specified .cspellcache will be used. The file will be created in the directory where the cspell command is executed.

Inherited from​

Readonly.cacheLocation

cacheReset?​

readonly optional cacheReset: boolean

Defined in: cspell/src/app/util/cache/CacheOptions.ts:30

Resets the cache

Inherited from​

Readonly.cacheReset

cacheStrategy?​

readonly optional cacheStrategy: CacheStrategy

Defined in: cspell/src/app/util/cache/CacheOptions.ts:25

Strategy to use for detecting changed files, default: metadata

Inherited from​

Readonly.cacheStrategy

color?​

readonly optional color: boolean

Defined in: cspell/src/app/options.ts:210

Use color in the output. true to force color, false to turn off color. undefined to use color if the output is a TTY.

Inherited from​

Readonly.color

config?​

readonly optional config: string | CSpellConfigFile

Defined in: cspell/src/app/options.ts:107

Path to configuration file.

Inherited from​

Readonly.config

console?​

readonly optional console: IConsole

Defined in: cspell/src/app/models.ts:13

The console to use for reporting.

Since​

8.11.1

debug?​

readonly optional debug: boolean

Defined in: cspell-types/dist/index.d.mts:169

Show extensive output.

Inherited from​

Readonly.debug

defaultConfiguration?​

readonly optional defaultConfiguration: boolean

Defined in: cspell/src/app/options.ts:185

Load the default configuration

Default​

true

Inherited from​

Readonly.defaultConfiguration

dot?​

readonly optional dot: boolean

Defined in: cspell/src/app/options.ts:35

Determine if files / directories starting with . should be part of the glob search.

Default​

false

Inherited from​

Readonly.dot

exclude?​

readonly optional exclude: string | string[]

Defined in: cspell/src/app/options.ts:17

a globs to exclude files from being checked.

Inherited from​

Readonly.exclude

exitCode?​

readonly optional exitCode: boolean

Defined in: cspell/src/app/options.ts:196

Return an exit code if there are issues found.

Default​

true

Inherited from​

Readonly.exitCode

failFast?​

readonly optional failFast: boolean

Defined in: cspell/src/app/options.ts:91

Stop processing and exit if an issue or error is found.

Inherited from​

Readonly.failFast

file?​

readonly optional file: string[]

Defined in: cspell/src/app/options.ts:76

Alias of LinterOptions.files.

Inherited from​

Readonly.file

fileList?​

readonly optional fileList: string[]

Defined in: cspell/src/app/options.ts:63

List of files that contains the paths to files to be spell checked. The files in the lists will be filtered against the glob patterns.

  • an entry of stdin means to read the file list from stdin The resulting files are filtered against the files globs found in the configuration.

Inherited from​

Readonly.fileList

files?​

readonly optional files: string[]

Defined in: cspell/src/app/options.ts:71

List of file paths to spell check. These can be relative or absolute paths, but not Globs. Relative paths are relative to LinterOptions.root. The files are combined with the file paths read from LinterOptions.fileList. These files are filtered against the files globs found in the configuration.

Inherited from​

Readonly.files

filterFiles?​

readonly optional filterFiles: boolean

Defined in: cspell/src/app/options.ts:81

Use the files configuration to filter the files found.

Inherited from​

Readonly.filterFiles

flag?​

readonly optional flag: string[]

Defined in: cspell/src/app/options.ts:203

Execution flags. Used primarily for releasing experimental features. Flags are of the form key:value

Inherited from​

Readonly.flag

gitignore?​

readonly optional gitignore: boolean

Defined in: cspell/src/app/options.ts:50

Enable filtering out files matching globs found in .gitignore files.

Inherited from​

Readonly.gitignore

gitignoreRoot?​

readonly optional gitignoreRoot: string | string[]

Defined in: cspell/src/app/options.ts:55

Stop searching for a .gitignores when a root is reached.

Inherited from​

Readonly.gitignoreRoot

ignoreRandomStrings?​

readonly optional ignoreRandomStrings: boolean

Defined in: cspell-types/dist/index.d.mts:153

Ignore sequences of characters that look like random strings.

Default​

true

Inherited from​

Readonly.ignoreRandomStrings

issues?​

readonly optional issues: boolean

Defined in: cspell/src/app/options.ts:225

Show issues

Inherited from​

Readonly.issues

issuesSummaryReport?​

readonly optional issuesSummaryReport: boolean

Defined in: cspell/src/app/options.ts:247

Generate a summary report of issues.

Inherited from​

Readonly.issuesSummaryReport

issueTemplate?​

readonly optional issueTemplate: string

Defined in: cspell/src/app/options.ts:282

Set the template to use when reporting issues.

The template is a string that can contain the following placeholders:

  • $filename - the file name
  • $col - the column number
  • $row - the row number
  • $text - the word that is misspelled
  • $message - the issues message: "unknown word", "word is misspelled", etc.
  • $messageColored - the issues message with color based upon the message type.
  • $uri - the URI of the file
  • $suggestions - suggestions for the misspelled word (if requested)
  • $quickFix - possible quick fixes for the misspelled word.
  • $contextFull - the full context of the misspelled word.
  • $contextLeft - the context to the left of the misspelled word.
  • $contextRight - the context to the right of the misspelled word.

Color is supported using the following template pattern:

  • {<style[.style]> <text>} - where <style> is a style name and <text> is the text to style.

Styles

  • bold, italic, underline, strikethrough, dim, inverse
  • black, red, green, yellow, blue, magenta, cyan, white

Example:

Example​

"{green $filename}:{yellow $row}:{yellow $col} $message {red $text} $quickFix {dim $suggestions}"

Since​

8.12.0

Inherited from​

Readonly.issueTemplate

languageId?​

readonly optional languageId: string

Defined in: cspell/src/app/options.ts:175

Programming Language ID.

Inherited from​

Readonly.languageId

legacy?​

readonly optional legacy: boolean

Defined in: cspell/src/app/options.ts:217

Show legacy output

Inherited from​

Readonly.legacy

locale?​

readonly optional locale: string

Defined in: cspell/src/app/options.ts:179

Locale to use.

Inherited from​

Readonly.locale

maxDuplicateProblems?​

readonly optional maxDuplicateProblems: number

Defined in: cspell-types/dist/index.d.mts:141

The maximum number of times the same word can be flagged as an error in a file.

Default​

5

Inherited from​

Readonly.maxDuplicateProblems

maxNumberOfProblems?​

readonly optional maxNumberOfProblems: number

Defined in: cspell-types/dist/index.d.mts:135

The maximum number of problems to report in a file.

Default​

10000

Inherited from​

Readonly.maxNumberOfProblems

minRandomLength?​

readonly optional minRandomLength: number

Defined in: cspell-types/dist/index.d.mts:159

The minimum length of a random string to be ignored.

Default​

40

Inherited from​

Readonly.minRandomLength

minWordLength?​

readonly optional minWordLength: number

Defined in: cspell-types/dist/index.d.mts:147

The minimum length of a word before checking it against a dictionary.

Default​

4

Inherited from​

Readonly.minWordLength

mustFindFiles?​

readonly optional mustFindFiles: boolean

Defined in: cspell/src/app/options.ts:242

Files must be found or cli will exit with an error.

Inherited from​

Readonly.mustFindFiles

progress?​

readonly optional progress: boolean

Defined in: cspell/src/app/options.ts:234

Show progress

Inherited from​

Readonly.progress

relative?​

readonly optional relative: boolean

Defined in: cspell/src/app/options.ts:238

issues are shown with a relative path to the root or cwd

Inherited from​

Readonly.relative

reporter?​

readonly optional reporter: string[]

Defined in: cspell/src/app/options.ts:97

Optional list of reporters to use, overriding any specified in the configuration.

Inherited from​

Readonly.reporter

root?​

readonly optional root: string

Defined in: cspell-types/dist/index.d.mts:181

root directory, defaults to cwd

Inherited from​

Readonly.root

showContext?​

readonly optional showContext: number | boolean

Defined in: cspell/src/app/options.ts:41

Show part of a line where an issue is found. if true, it will show the default number of characters on either side. if a number, it will shat number of characters on either side.

Inherited from​

Readonly.showContext

showPerfSummary?​

readonly optional showPerfSummary: boolean

Defined in: cspell/src/app/options.ts:252

Generate a summary report of performance.

Inherited from​

Readonly.showPerfSummary

showSuggestions?​

readonly optional showSuggestions: boolean

Defined in: cspell/src/app/options.ts:45

Show suggestions for spelling errors.

Inherited from​

Readonly.showSuggestions

silent?​

readonly optional silent: boolean

Defined in: cspell/src/app/options.ts:230

Run in silent mode.

Default​

false

Inherited from​

Readonly.silent

skipValidation?​

readonly optional skipValidation: boolean

Defined in: cspell/src/app/options.ts:102

Load and parse documents, but do not spell check.

Inherited from​

Readonly.skipValidation

summary?​

readonly optional summary: boolean

Defined in: cspell/src/app/options.ts:221

Show summary at the end

Inherited from​

Readonly.summary

unique?​

readonly optional unique: boolean

Defined in: cspell-types/dist/index.d.mts:177

unique errors per file only.

Inherited from​

Readonly.unique

validateDirectives?​

readonly optional validateDirectives: boolean

Defined in: cspell/src/app/options.ts:190

Check In-Document CSpell directives for correctness.

Inherited from​

Readonly.validateDirectives

verbose?​

readonly optional verbose: boolean

Defined in: cspell-types/dist/index.d.mts:165

Display verbose information

Inherited from​

Readonly.verbose

wordsOnly?​

readonly optional wordsOnly: boolean

Defined in: cspell-types/dist/index.d.mts:173

Only report the words, no line numbers or file names.

Inherited from​

Readonly.wordsOnly