Skip to main content

Class: DocumentValidator

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:79

Constructors​

Constructor​

new DocumentValidator(doc, options, settings): DocumentValidator

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:108

Parameters​

doc​

TextDocument

Document to validate

options​

DocumentValidatorOptions

settings​

CSpellSettings

Returns​

DocumentValidator

Properties​

errors​

readonly errors: Error[] = []

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:82

options​

readonly options: DocumentValidatorOptions

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:87

perfTiming​

readonly perfTiming: PerfTimings = {}

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:88

settings​

readonly settings: CSpellSettings

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:111

skipValidation​

skipValidation: boolean

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:89

Accessors​

document​

Get Signature​

get document(): TextDocument

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:353

Returns​

TextDocument

prepTime​

Get Signature​

get prepTime(): number

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:242

The amount of time in ms to prepare for validation.

Returns​

number

ready​

Get Signature​

get ready(): boolean

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:123

Returns​

boolean

validateDirectives​

Get Signature​

get validateDirectives(): boolean

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:246

Returns​

boolean

Methods​

_getPreparations()​

_getPreparations(): undefined | Preparations

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:481

Internal cspell-lib use.

Returns​

undefined | Preparations

check()​

check(parsedText): ValidationIssue[]

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:255

Parameters​

parsedText​

ParsedText

Returns​

ValidationIssue[]

checkDocument()​

checkDocument(forceCheck): ValidationIssue[]

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:313

Check a Document for Validation Issues.

Note: The validator must be prepared before calling this method.

Parameters​

forceCheck​

boolean = false

force a check even if the document would normally be excluded.

Returns​

ValidationIssue[]

the validation issues.

checkDocumentAsync()​

checkDocumentAsync(forceCheck?): Promise<ValidationIssue[]>

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:301

Check a Document for Validation Issues.

Parameters​

forceCheck?​

boolean

force a check even if the document would normally be excluded.

Returns​

Promise<ValidationIssue[]>

the validation issues.

checkDocumentDirectives()​

checkDocumentDirectives(forceCheck): ValidationIssue[]

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:331

Parameters​

forceCheck​

boolean = false

Returns​

ValidationIssue[]

checkText()​

checkText(range, _text, scope): ValidationIssue[]

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:250

Parameters​

range​

SimpleRange

_text​

string

scope​

string[]

Returns​

ValidationIssue[]

getCheckedTextRanges()​

getCheckedTextRanges(): MatchRange[]

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:366

Get the calculated ranges of text that should be included in the spell checking.

Returns​

MatchRange[]

MatchRanges of text to include.

getFinalizedDocSettings()​

getFinalizedDocSettings(): CSpellSettingsInternal

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:460

Returns​

CSpellSettingsInternal

prepare()​

prepare(): Promise<void>

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:127

Returns​

Promise<void>

shouldCheckDocument()​

shouldCheckDocument(): boolean

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:473

Returns true if the final result of the configuration calculation results in the document being enabled. Note: in some cases, checking the document might still make sense, for example, the @cspell/eslint-plugin relies on eslint configuration to make that determination.

Returns​

boolean

true if the document settings have resolved to be enabled

traceWord()​

traceWord(word): TraceResult

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:371

Parameters​

word​

string

Returns​

TraceResult

updateDocumentText()​

updateDocumentText(text): Promise<void>

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:357

Parameters​

text​

string

Returns​

Promise<void>

create()​

static create(doc, options, settingsOrConfigFile): Promise<DocumentValidator>

Defined in: packages/cspell-lib/src/lib/textValidation/docValidator.ts:91

Parameters​

doc​

TextDocument

options​

DocumentValidatorOptions

settingsOrConfigFile​

CSpellSettings | ICSpellConfigFile

Returns​

Promise<DocumentValidator>