Spelly
Pure JavaScript spellchecker that learns as you use it 1
Installation
npm install spelly
Usage
Get suggestions
const Spelly = require("spelly");
let options = {
cache: {
type: "configstore",
store: new Configstore("foo")
// optional, defaults to internal Configstore instance under "spelly"
}
};
const spelly = new Spelly("/usr/share/dict/words", options);
let suggestions = spelly.check("wierd");
/**
* {
* original: "wierd",
* suggestions: [{
* word: "wired",
* score: 5
* }, {
* word: "weird",
* score: 5
* }, {
* word: "wield",
* score: 4
* }]
* }
*/
Results will be cached in the chosen store, making Spelly smarter and faster each time it is used.
Managing your own cache
You can manage your own cache of words by adding/removing them to/from the store.
When adding a word, all suggestions beneath its score will be shifted down 1.
(e.g. a score of 4
goes to 3
). If the suggestion already exists, it will be
moved appropriately according to the score given.
// add 'wired' with score '1' or move it to the bottom position
spelly.cache("weird", { word: "wired", score: 1 });
// remove a suggestion for a misspelling
spelly.clearCache("somthing", "something");
// remove all suggestions for a misspelling
spelly.clearCache("somthing");
// clear all cache
spelly.clearCache();
// retrieve cached suggestions for a misspelling
spelly.getCache("somthing");
// retrieve all cached suggestions
spelly.getCache();
Feeling lucky?
Grab the first suggestion out of the list
let suggestion = spelly.first("wierd");
/**
*{
* original: "wierd",
* suggestion: {
* word: "weird",
* score: 5
* }
*}
*/
Learning
Spelly uses configstore by default for the suggestion cache, helping make it both fast and smart. Each time a misspelled word is given to Spelly, it finds it in the store, or generates a suggestion, then adds it to the store.
API
Spelly(dictionary, options)
Spelly constructor.
-
dictionary Type:
Array|String
An array of words or path to a file containing a newline separated list of words. -
options.cache Type:
Object
Spelly cache options.- cache.type Type:
String
Cache type (configstore
). - cache.store Type:
Object
configstore instance (optional) forconfigstore
.
- cache.type Type:
check(word)
Spellcheck a word. returns a promise with the suggestions Object.
- word: Type:
String
The word to spellcheck.
cache(misspelledWord, suggestion)
Add a suggestion to a mispelled word.
- misspelledWord Type:
String
The misspelled word to cache. - suggestion Type:
Object
- suggestion.word Type:
String
The suggestion to add for the misspelled word. - suggestion.score Type:
Number
Score the suggestion. If the suggestion exists for the word, it will be re-scored based on the given score and all others below will be shifted down (or up depending on how you look at it) by 1.
- suggestion.word Type:
clearCache([misspelledWord][,suggestion])
Clear the cache of a single suggestion, multiple suggestions or all suggestions.
- missppelledWord Type:
String
(optional) The misspelled word to clear. - suggestion Type:
String
(optional) the suggestion to remove from the misspelled word.
getCache([misspelledWord])
Retrieve the cache for a mispelled word or all words.
- misspelledWord Type:
String
(optional) The misspelled word to retrieve cache for.
first(misspelledWord)
Retrieve the first suggestion for a mispelled word
License
See LICENSE