fix(parser): add attachComment to ParserOptions type (#13657)

This commit is contained in:
Sosuke Suzuki 2021-08-09 17:05:19 +09:00 committed by GitHub
parent 39ba1ff300
commit 8a09993e39
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -48,6 +48,17 @@ export interface ParserOptions {
*/ */
allowUndeclaredExports?: boolean; allowUndeclaredExports?: boolean;
/**
* By default, Babel attaches comments to adjacent AST nodes.
* When this option is set to false, comments are not attached.
* It can provide up to 30% performance improvement when the input code has many comments.
* @babel/eslint-parser will set it for you.
* It is not recommended to use attachComment: false with Babel transform,
* as doing so removes all the comments in output code, and renders annotations such as
* /* istanbul ignore next *\/ nonfunctional.
*/
attachComment?: boolean;
/** /**
* By default, Babel always throws an error when it finds some invalid code. * By default, Babel always throws an error when it finds some invalid code.
* When this option is set to true, it will store the parsing error and * When this option is set to true, it will store the parsing error and