@babel/plugin-syntax-decorators

What is @babel/plugin-syntax-decorators?

The @babel/plugin-syntax-decorators package is a plugin for Babel, a JavaScript compiler, that allows Babel to parse and understand decorator syntax. Decorators are a stage 2 proposal for JavaScript and provide a way to add annotations and a meta-programming syntax for class declarations and members. Decorators can be used to annotate and modify classes and properties at design time.

What are @babel/plugin-syntax-decorators's main functionalities?

Parsing decorator syntax

This feature enables Babel to parse decorators, which are annotations placed directly above class declarations, methods, or properties. The code sample shows a simple decorator applied to a class.

@decorator
class MyClass {}
function decorator(target) {
  // modify target
}

Other packages similar to @babel/plugin-syntax-decorators

@babel/plugin-proposal-decorators

This package is similar to @babel/plugin-syntax-decorators but includes both parsing and transforming capabilities for decorators. While @babel/plugin-syntax-decorators only allows Babel to parse decorator syntax, @babel/plugin-proposal-decorators also transforms decorators according to the proposal.

core-decorators

core-decorators is a library of decorators for JavaScript classes. Unlike @babel/plugin-syntax-decorators, which only enables syntax parsing, core-decorators provides actual implementations of common decorators such as @autobind, @readonly, and @override.

README

@babel/plugin-syntax-decorators

Allow parsing of decorators

See our website @babel/plugin-syntax-decorators for more information.

Install

Using npm:

npm install --save-dev @babel/plugin-syntax-decorators

or using yarn:

yarn add @babel/plugin-syntax-decorators --dev

Changelog

v7.25.9 (2024-10-22)

:bug: Bug Fix

• babel-parser, babel-template, babel-types
  • #16905 fix: Keep type annotations in syntacticPlaceholders mode (@liuxingbaoyu)
• babel-helper-compilation-targets, babel-preset-env
  • #16907 fix: support BROWSERSLIST{,_CONFIG} env (@JLHwung)
• Other
  • #16884 Analyze ClassAccessorProperty to prevent the no-undef rule (@victorenator)

:house: Internal

• babel-helper-transform-fixture-test-runner
  • #16914 remove test options flaky (@JLHwung)

:running_woman: Performance

• babel-parser, babel-types
  • #16918 perf: Make VISITOR_KEYS etc. faster to access (@liuxingbaoyu)