From 8a09993e390bc3ea9d1c75eb54b15944f6589ae5 Mon Sep 17 00:00:00 2001 From: Sosuke Suzuki Date: Mon, 9 Aug 2021 17:05:19 +0900 Subject: [PATCH] fix(parser): add `attachComment` to `ParserOptions` type (#13657) --- packages/babel-parser/typings/babel-parser.d.ts | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/packages/babel-parser/typings/babel-parser.d.ts b/packages/babel-parser/typings/babel-parser.d.ts index 3f65949ceec6..8f16aae158aa 100644 --- a/packages/babel-parser/typings/babel-parser.d.ts +++ b/packages/babel-parser/typings/babel-parser.d.ts @@ -48,6 +48,17 @@ export interface ParserOptions { */ 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. * When this option is set to true, it will store the parsing error and