Class: DocumentValidator

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

Constructors

Constructor

new DocumentValidator(doc, options, settings): DocumentValidator

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

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:86

---

options

readonly options: DocumentValidatorOptions

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

---

perfTiming

readonly perfTiming: PerfTimings = {}

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

---

settings

readonly settings: CSpellSettings

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

---

skipValidation

skipValidation: boolean

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

Accessors

document

Get Signature

get document(): TextDocument

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

Returns

TextDocument

---

prepTime

Get Signature

get prepTime(): number

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

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:127

Returns

boolean

---

validateDirectives

Get Signature

get validateDirectives(): boolean

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

Returns

boolean

Methods

_getPreparations()

_getPreparations(): Preparations | undefined

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

Internal cspell-lib use.

Returns

Preparations | undefined

---

check()

check(parsedText): ValidationIssue[]

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

Parameters

parsedText

ParsedText

Returns

ValidationIssue[]

---

checkDocument()

checkDocument(forceCheck?): ValidationIssue[]

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

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:341

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:373

Parameters

forceCheck?

boolean = false

Returns

ValidationIssue[]

---

checkText()

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

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

Check a range of text for validation issues.

Parameters

range

readonly [number, number]

the range of text to check.

_text

the text to check. If not given, the text will be taken from the document.

string | undefined

scope?

the scope to use for validation. If not given, the default scope will be used.

string | string[]

Returns

ValidationIssue[]

the validation issues.

---

getCheckedTextRanges()

getCheckedTextRanges(): MatchRange[]

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

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

Returns

MatchRange[]

MatchRanges of text to include.

---

getConfigErrors()

getConfigErrors(): ImportFileRefWithError[] | undefined

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

Returns

ImportFileRefWithError[] | undefined

---

getDictionaryErrors()

getDictionaryErrors(): Map<string, Error[]> | undefined

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

Returns

Map<string, Error[]> | undefined

---

getFinalizedDocSettings()

getFinalizedDocSettings(): CSpellSettingsInternal

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

Returns

CSpellSettingsInternal

---

prepare()

prepare(): Promise<void>

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

Returns

Promise<void>

---

shouldCheckDocument()

shouldCheckDocument(): boolean

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

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:413

Parameters

word

string

Returns

TraceResult

---

updateDocumentText()

updateDocumentText(text): Promise<void>

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

Parameters

text

string

Returns

Promise<void>

---

create()

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

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

Parameters

doc

TextDocument

options

DocumentValidatorOptions

settingsOrConfigFile

CSpellSettings | ICSpellConfigFile

Returns

Promise<DocumentValidator>