Files
ale/doc/ale-javascript.txt
w0rp 400857d758 Implement Lua ALE setup & overhaul documentation
1. Add ale.setup and ale.setup.buffer for pure Lua configuration.
2. Update many global settings to use Booleans instead of numbers to
   make types easiert to work with in Lua.
3. Radically reformat documentation and fix errors to make
   documentation more usable for Neovim users.
2025-03-27 12:40:11 +00:00

434 lines
17 KiB
Plaintext

===============================================================================
ALE JavaScript Integration *ale-javascript-options*
*ale-eslint-nested-configuration-files*
For fixing files with ESLint, nested configuration files with `root: false`
are not supported. This is because ALE fixes files by writing the contents of
buffers to temporary files, and then explicitly sets the configuration file.
Configuration files which are set explicitly must be root configuration files.
If you are using nested configuration files, you should restructure your
project so your configuration files use `extends` instead.
See the ESLint documentation here:
http://eslint.org/docs/user-guide/configuring#extending-configuration-files
You should change the structure of your project from this: >
/path/foo/.eslintrc.js # root: true
/path/foo/bar/.eslintrc.js # root: false
<
To this: >
/path/foo/.base-eslintrc.js # Base configuration here
/path/foo/.eslintrc.js # extends: ["/path/foo/.base-eslintrc.js"]
/path/foo/bar/.eslintrc.js # extends: ["/path/foo/.base-eslintrc.js"]
<
===============================================================================
biome *ale-javascript-biome*
Check the docs over at |ale-typescript-biome|.
===============================================================================
clang-format *ale-javascript-clangformat*
See |ale-c-clangformat| for information about the available options.
Note that the C options are also used for JavaScript.
===============================================================================
cspell *ale-javascript-cspell*
See |ale-cspell-options|
===============================================================================
deno *ale-javascript-deno*
Check the docs over at |ale-typescript-deno|.
===============================================================================
dprint *ale-javascript-dprint*
See |ale-dprint-options| and https://dprint.dev/plugins/typescript
===============================================================================
eslint *ale-javascript-eslint*
*ale-options.javascript_eslint_executable*
*g:ale_javascript_eslint_executable*
*b:ale_javascript_eslint_executable*
javascript_eslint_executable
g:ale_javascript_eslint_executable
Type: |String|
Default: `'eslint'`
See |ale-integrations-local-executables|
*ale-options.javascript_eslint_options*
*g:ale_javascript_eslint_options*
*b:ale_javascript_eslint_options*
javascript_eslint_options
g:ale_javascript_eslint_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to eslint.
*ale-options.javascript_eslint_use_global*
*g:ale_javascript_eslint_use_global*
*b:ale_javascript_eslint_use_global*
javascript_eslint_use_global
g:ale_javascript_eslint_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
*ale-options.javascript_eslint_suppress_eslintignore*
*g:ale_javascript_eslint_suppress_eslintignore*
*b:ale_javascript_eslint_suppress_eslintignore*
javascript_eslint_suppress_eslintignore
g:ale_javascript_eslint_suppress_eslintignore
Type: |Number|
Default: `0`
This variable can be set to `1` to disable warnings for files being ignored
by eslint.
*ale-options.javascript_eslint_suppress_missing_config*
*g:ale_javascript_eslint_suppress_missing_config*
*b:ale_javascript_eslint_suppress_missing_config*
javascript_eslint_suppress_missing_config
g:ale_javascript_eslint_suppress_missing_config
Type: |Number|
Default: `0`
This variable can be set to `1` to disable errors for missing eslint
configuration files.
When turning this option on, eslint will not report any problems when no
configuration files are found.
===============================================================================
fecs *ale-javascript-fecs*
`fecs` is a lint tool for HTML/CSS/JavaScript, can be installed via:
`$ npm install --save-dev fecs`
And the configuration file is located at `./fecsrc`, see http://fecs.baidu.com
for more options.
*ale-options.javascript_fecs_executable*
*g:ale_javascript_fecs_executable*
*b:ale_javascript_fecs_executable*
javascript_fecs_executable
g:ale_javascript_fecs_executable
Type: |String|
Default: `'fecs'`
See |ale-integrations-local-executables|
*ale-options.javascript_fecs_use_global*
*g:ale_javascript_fecs_use_global*
*b:ale_javascript_fecs_use_global*
javascript_fecs_use_global
g:ale_javascript_fecs_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
flow *ale-javascript-flow*
*ale-options.javascript_flow_executable*
*g:ale_javascript_flow_executable*
*b:ale_javascript_flow_executable*
javascript_flow_executable
g:ale_javascript_flow_executable
Type: |String|
Default: `'flow'`
See |ale-integrations-local-executables|
*ale-options.javascript_flow_use_home_config*
*g:ale_javascript_flow_use_home_config*
*b:ale_javascript_flow_use_home_config*
javascript_flow_use_home_config
g:ale_javascript_flow_use_home_config
Type: |Number|
Default: `0`
When set to `1`, ALE will allow Flow to be executed with configuration files
from your home directory. ALE will not run Flow with home directory
configuration files by default, as doing so can lead to Vim consuming all of
your RAM and CPU power.
*ale-options.javascript_flow_use_global*
*g:ale_javascript_flow_use_global*
*b:ale_javascript_flow_use_global*
javascript_flow_use_global
g:ale_javascript_flow_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
*ale-options.javascript_flow_use_respect_pragma*
*g:ale_javascript_flow_use_respect_pragma*
*b:ale_javascript_flow_use_respect_pragma*
javascript_flow_use_respect_pragma
g:ale_javascript_flow_use_respect_pragma
Type: |Number|
Default: `1`
By default, ALE will use the `--respect-pragma` option for `flow`, so only
files with the `@flow` pragma are checked by ALE. This option can be set to
`0` to disable that behavior, so all files can be checked by `flow`.
===============================================================================
importjs *ale-javascript-importjs*
*ale-options.javascript_importjs_executable*
*g:ale_javascript_importjs_executable*
*b:ale_javascript_importjs_executable*
javascript_importjs_executable
g:ale_javascript_importjs_executable
Type: |String|
Default: `'importjs'`
===============================================================================
jscs *ale-javascript-jscs*
*ale-options.javascript_jscs_executable*
*g:ale_javascript_jscs_executable*
*b:ale_javascript_jscs_executable*
javascript_jscs_executable
g:ale_javascript_jscs_executable
Type: |String|
Default: `'jscs'`
See |ale-integrations-local-executables|
*ale-options.javascript_jscs_use_global*
*g:ale_javascript_jscs_use_global*
*b:ale_javascript_jscs_use_global*
javascript_jscs_use_global
g:ale_javascript_jscs_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
jshint *ale-javascript-jshint*
*ale-options.javascript_jshint_executable*
*g:ale_javascript_jshint_executable*
*b:ale_javascript_jshint_executable*
javascript_jshint_executable
g:ale_javascript_jshint_executable
Type: |String|
Default: `'jshint'`
See |ale-integrations-local-executables|
*ale-options.javascript_jshint_use_global*
*g:ale_javascript_jshint_use_global*
*b:ale_javascript_jshint_use_global*
javascript_jshint_use_global
g:ale_javascript_jshint_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
prettier *ale-javascript-prettier*
*ale-options.javascript_prettier_executable*
*g:ale_javascript_prettier_executable*
*b:ale_javascript_prettier_executable*
javascript_prettier_executable
g:ale_javascript_prettier_executable
Type: |String|
Default: `'prettier'`
See |ale-integrations-local-executables|
*ale-options.javascript_prettier_options*
*g:ale_javascript_prettier_options*
*b:ale_javascript_prettier_options*
javascript_prettier_options
g:ale_javascript_prettier_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to prettier.
*ale-options.javascript_prettier_use_global*
*g:ale_javascript_prettier_use_global*
*b:ale_javascript_prettier_use_global*
javascript_prettier_use_global
g:ale_javascript_prettier_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
prettier-eslint *ale-javascript-prettier-eslint*
*ale-options.javascript_prettier_eslint_executable*
*g:ale_javascript_prettier_eslint_executable*
*b:ale_javascript_prettier_eslint_executable*
javascript_prettier_eslint_executable
g:ale_javascript_prettier_eslint_executable
Type: |String|
Default: `'prettier-eslint'`
See |ale-integrations-local-executables|
*ale-options.javascript_prettier_eslint_options*
*g:ale_javascript_prettier_eslint_options*
*b:ale_javascript_prettier_eslint_options*
javascript_prettier_eslint_options
g:ale_javascript_prettier_eslint_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to prettier-eslint.
*ale-options.javascript_prettier_eslint_use_global*
*g:ale_javascript_prettier_eslint_use_global*
*b:ale_javascript_prettier_eslint_use_global*
javascript_prettier_eslint_use_global
g:ale_javascript_prettier_eslint_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
prettier-standard *ale-javascript-prettier-standard*
*ale-options.javascript_prettier_standard_executable*
*g:ale_javascript_prettier_standard_executable*
*b:ale_javascript_prettier_standard_executable*
javascript_prettier_standard_executable
g:ale_javascript_prettier_standard_executable
Type: |String|
Default: `'prettier-standard'`
See |ale-integrations-local-executables|
*ale-options.javascript_prettier_standard_options*
*g:ale_javascript_prettier_standard_options*
*b:ale_javascript_prettier_standard_options*
javascript_prettier_standard_options
g:ale_javascript_prettier_standard_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to prettier-standard.
*ale-options.javascript_prettier_standard_use_global*
*g:ale_javascript_prettier_standard_use_global*
*b:ale_javascript_prettier_standard_use_global*
javascript_prettier_standard_use_global
g:ale_javascript_prettier_standard_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
standard *ale-javascript-standard*
*ale-options.javascript_standard_executable*
*g:ale_javascript_standard_executable*
*b:ale_javascript_standard_executable*
javascript_standard_executable
g:ale_javascript_standard_executable
Type: |String|
Default: `'standard'`
See |ale-integrations-local-executables|
*ale-options.javascript_standard_options*
*g:ale_javascript_standard_options*
*b:ale_javascript_standard_options*
javascript_standard_options
g:ale_javascript_standard_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to standard.
*ale-options.javascript_standard_use_global*
*g:ale_javascript_standard_use_global*
*b:ale_javascript_standard_use_global*
javascript_standard_use_global
g:ale_javascript_standard_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
xo *ale-javascript-xo*
*ale-options.javascript_xo_executable*
*g:ale_javascript_xo_executable*
*b:ale_javascript_xo_executable*
javascript_xo_executable
g:ale_javascript_xo_executable
Type: |String|
Default: `'xo'`
See |ale-integrations-local-executables|
*ale-options.javascript_xo_options*
*g:ale_javascript_xo_options*
*b:ale_javascript_xo_options*
javascript_xo_options
g:ale_javascript_xo_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to xo.
*ale-options.javascript_xo_use_global*
*g:ale_javascript_xo_use_global*
*b:ale_javascript_xo_use_global*
javascript_xo_use_global
g:ale_javascript_xo_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: