cspell-lib

CSpell Library

cspell-lib is the workhorse behind cspell. It does all the heavy lifting necessary to spell check files.

Support Future Development

If our spell checkers save you time, please consider supporting their development.

Please show your support through one of the following sites:

Installation

npm i -S cspell-lib

Usage

Example - Check some text

Here is an example of using spellCheckDocument to spell check some text with a spelling issue.

import assert from 'node:assert';

import { spellCheckDocument } from 'cspell-lib';

// cspell:ignore wordz coztom clockz cuztom
const customWords = ['wordz', 'cuztom', 'clockz'];

async function checkSpelling(phrase: string) {
  const result = await spellCheckDocument(
    { uri: 'text.txt', text: phrase, languageId: 'plaintext', locale: 'en' },
    { generateSuggestions: true, noConfigSearch: true },
    { words: customWords, suggestionsTimeout: 2000 }
  );
  return result.issues;
}

export async function run() {
  console.log(`Start: ${new Date().toISOString()}`);
  const r = await checkSpelling('These are my coztom wordz.');
  console.log(`End: ${new Date().toISOString()}`);
  // console.log(r);
  assert(r.length === 1, 'Make sure we got 1 spelling issue back.');
  assert(r[0].text === 'coztom');
  assert(r[0].suggestions?.includes('cuztom'));
  // console.log('%o', r);
}

Example - Check a file

import { resolve } from 'node:path';
import { pathToFileURL } from 'node:url';
import { spellCheckDocument } from 'cspell-lib';

export async function checkFile(filename: string) {
  const uri = pathToFileURL(resolve(filename)).toString();
  const result = await spellCheckDocument(
    { uri },
    { generateSuggestions: true, noConfigSearch: true },
    { words: customWords, suggestionsTimeout: 2000 }
  );
  return result.issues;
}

CSpell for Enterprise

Available as part of the Tidelift Subscription.

The maintainers of cspell and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use. Learn more.

Brought to you by Street Side Software

Similar packages

Other packages similar to cspell-lib

spellchecker

The spellchecker package provides a simple interface for spell checking text. It is less feature-rich compared to cspell-lib, focusing primarily on basic spell checking without the extensive customization options available in cspell-lib.

nodehun

nodehun is a spell checker based on Hunspell dictionaries. It offers powerful spell checking capabilities similar to cspell-lib but requires Hunspell dictionaries to function. It is suitable for applications that need to support multiple languages with extensive dictionary support.

nspell

nspell is a spell checker that supports multiple languages and is based on Hunspell dictionaries. It is similar to cspell-lib in terms of functionality but focuses more on providing a lightweight and fast spell checking solution with support for various languages.