@codaco/eslint-plugin-spellcheck

ESLint rules to spell check js files

Usage no npm install needed!

<script type="module">
  import codacoEslintPluginSpellcheck from 'https://cdn.skypack.dev/@codaco/eslint-plugin-spellcheck';
</script>

README

eslint-plugin-spellcheck

eslint plugin to spell check words on identifiers, Strings and comments of javascript files. dependencies Status Build Status

Configuration

This ESLint plugin, like others, can be reconfigured to produce errors (2), warnings (1), or disabled (0) with the first numeric argument. For more information on ESLint configuration, see: http://eslint.org/docs/user-guide/configuring

"comments": <<Boolean>> default: true
Check Spelling inside comments

"strings": <<Boolean>>, default: true
Check Spelling inside strings

"identifiers": <<Boolean>>, default: true
Check Spelling inside identifiers

"ignoreRequire": <<Boolean>>, default: false
Exclude `require()` imports from spell-checking. Useful for excluding NPM package name false-positives.

"templates": <<Boolean>>, default: true
Check Spelling inside ES6 templates you should enable parser options for ES6 features for this to work
Refer to: [specifying-parser-options](http://eslint.org/docs/user-guide/configuring#specifying-parser-options)

"lang": <<String>>, default: "en_US"
Choose the language you want to use. Options are: "en_US", "en_CA", and "en_GB"

"skipWords": <<Array Of Strings>> default: []
Array of words that will not be checked.

"skipIfMatch": <<Array Of Strings>> default: []
Array of Regular Expressions the plugin will try to match the js node element value (identifier, comment, string, string template, etc) and will not check the entire node content if matched, be careful in comments because if a part of the comment is matched the entire comment will not be checked, same for strings.
i.e: "^[-\\w]+\/[-\\w\\.]+quot; will ignore MIME types.

"skipWordIfMatch": <<Array Of Strings>> default: []
Array of Regular Expressions the plugin will try to match every single word that is found in the nodes (identifier, comment, string, string template, etc) and will not check the single word if matched.
i.e: "^[-\\w]+\/[-\\w\\.]+quot; will ignore MIME types.

"minLength": <<Number>> default: 1
Words with a character-amount of less than the minLength will not be spell-checked.

Check example below

Usage in a project

  1. Install eslint-plugin-spellcheck as a dev-dependency:

    npm install --save-dev eslint-plugin-spellcheck
    
  2. Enable the plugin by adding it to your .eslintrc:

    plugins:
      - spellcheck
    
  3. You can also configure these rules in your .eslintrc. All rules defined in this plugin have to be prefixed by 'spellcheck/'

    "plugins": [
       "spellcheck"
    ],
    "rules": {
       "spellcheck/spell-checker": [1,
           {
               "comments": true,
               "strings": true,
               "identifiers": true,
               "lang": "en_US",
               "skipWords": [
                   "dict",
                   "aff",
                   "hunspellchecker",
                   "hunspell",
                   "utils"
               ],
               "skipIfMatch": [
                   "http://[^s]*",
                   "^[-\\w]+\/[-\\w\\.]+quot; //For MIME Types
               ],
               "skipWordIfMatch": [
                   "^foobar.*quot; // words that begin with foobar will not be checked
               ],
               "minLength": 3
            }
        ]
    }
    

Usage globally

  1. Install eslint-plugin-spellcheck as a global package:

    npm install -g eslint-plugin-spellcheck
    
  2. Enable the plugin by adding it to your eslint.json:

    "plugins": [
       "spellcheck"
    ],
    "rules": {
       "spellcheck/spell-checker": [1,
           {
               "comments": true,
               "strings": true,
               "identifiers": true,
               "lang": "en_US",
               "skipWords": [
                   "dict",
                   "aff",
                   "hunspellchecker",
                   "hunspell",
                   "utils"
                ],
                "skipIfMatch": [
                    "http://[^s]*"
                ],
                "skipWordIfMatch": [
                    "^foobar.*quot;
                ],
                "minLength": 3
            }
        ]
    }
    

Skipping words ending with a number

To skip words like md5, sha1 and sha256, add to skipWords the root of the word, that is, without the number:

"rules": {
    "spellcheck/spell-checker": [1,
        {
            "skipWords": [
                "md",
                "sha"
            ],
        }
    ]
}